View a markdown version of this page

Crie uma AgentCore memória - Amazon Bedrock AgentCore

Crie uma AgentCore memória

Você pode criar uma AgentCore memória com a AgentCore CLI, o AWS console ou com a operação do CreateMemory AWS SDK. Ao criar uma memória, você pode definir configurações como nome, descrição, configurações de criptografia, data e hora de expiração para eventos brutos e estratégias de memória se quiser extrair memória de longo prazo.

Ao criar uma AgentCore memória, considere os seguintes fatores para manter que ela atenda às necessidades do seu aplicativo:

Retenção de eventos — escolha por quanto tempo os eventos brutos serão retidos (até 365 dias) para a memória de curto prazo.

nota

eventExpiryDurationé aplicado por evento no momento da gravação. A atualização afeta somente os eventos criados após a alteração. Os eventos armazenados anteriormente mantêm sua expiração original e não podem ser estendidos, e os eventos expirados não podem ser recuperados.

Requisitos de segurança — Se seu aplicativo manipula informações confidenciais, considere usar uma chave AWS KMS gerenciada pelo cliente para criptografia. O serviço ainda criptografa os dados usando uma chave gerenciada pelo serviço, mesmo que você não forneça uma chave KMS gerenciada pelo cliente AWS .

Estratégias de memória — Defina como os eventos são processados em memórias significativas de longo prazo usando estratégias integradas ou integradas com sobreposições. Se você não definir nenhuma estratégia, somente a memória de curto prazo contendo eventos brutos será armazenada. Para obter mais informações, consulte Usar memória de longo prazo.

Convenções de nomenclatura — Use nomes claros e descritivos que ajudem a identificar a finalidade de cada AgentCore memória, especialmente se seu aplicativo usa vários armazenamentos.

exemplo
AgentCore CLI

  1. Os comandos de memória AgentCore CLI devem ser executados dentro de um projeto agentcore existente. Se você ainda não tem um, crie um projeto primeiro:

    agentcore create --name my-agent --no-agent
cd my-agent

    Crie uma memória básica (somente de curto prazo):

    agentcore add memory --name my_agent_memory
agentcore deploy

    Crie memória com estratégias de longo prazo:

    agentcore add memory --name ShoppingSupportAgentMemory \
  --strategies SUMMARIZATION,USER_PREFERENCE
agentcore deploy

    Verifique o status da memória:

    agentcore status
Interactive

  1. Execute agentcore para abrir a TUI, selecione adicionar e escolha Memória:

  2. Digite o nome da memória:

    Assistente de memória: insira o nome

  3. Selecione a duração de expiração do evento:

    Assistente de memória: selecione a duração da expiração do evento

  4. Escolha estratégias de memória para extração de memória de longo prazo:

    Assistente de memória: selecione estratégias de memória

  5. Revise a configuração e pressione Enter para confirmar:

    Assistente de memória: revise a configuração
AWS SDK

  1. Para obter mais informações, consulte SDKs da AWS.

    import boto3
import time

# Initialize the Boto3 clients for control plane and data plane operations
control_client = boto3.client('bedrock-agentcore-control')
data_client = boto3.client('bedrock-agentcore')

print("Creating a new memory resource...")

# Create the memory resource with defined strategies
response = control_client.create_memory(
    name="ShoppingSupportAgentMemory",
    description="Memory for a customer support agent.",
    memoryStrategies=[
        {
            'summaryMemoryStrategy': {
                'name': 'SessionSummarizer',
                'namespaceTemplates': ['/summaries/{actorId}/{sessionId}/']
            }
        },
        {
            'userPreferenceMemoryStrategy': {
                'name': 'UserPreferenceExtractor',
                'namespaceTemplates': ['/users/{actorId}/preferences/']
            }
        }
    ]
)

memory_id = response['memory']['id']
print(f"Memory resource created with ID: {memory_id}")

# Poll the memory status until it becomes ACTIVE
while True:
    mem_status_response = control_client.get_memory(memoryId=memory_id)
    status = mem_status_response.get('memory', {}).get('status')
    if status == 'ACTIVE':
        print("Memory resource is now ACTIVE.")
        break
    elif status == 'FAILED':
        raise Exception("Memory resource creation FAILED.")
    print("Waiting for memory to become active...")
    time.sleep(10)
Console

  1. ====== Para criar uma memória AgentCore

  2. Abra o console do Amazon Bedrock AgentCore.

  3. No painel de navegação esquerdo, escolha Memória.

  4. Escolha Criar memória.

  5. Em Nome da memória, insira um nome para a AgentCore memória.

  6. (Opcional) Para a expiração da Short-term memória (evento bruto), defina a duração (dias) durante a qual a AgentCore memória armazenará eventos.

  7. (Opcional) Em Configurações adicionais, defina o seguinte:

    1. Em Descrição da memória, insira uma descrição para a AgentCore memória.

    2. Se você quiser usar sua própria chave AWS KMS para criptografar seus dados, faça o seguinte:

      1. Em Chave KMS, escolha Personalizar configurações de criptografia (avançado).

      2. Em Escolha uma chave AWS KMS, escolha ou insira o ARN de uma chave KMS AWS existente. Como alternativa, escolha Criar um AWS KMS para criar uma nova chave AWS KMS.

  8. (Opcional) Para estratégias de extração de Long-term memória, escolha uma ou mais estratégias de memória. Para obter mais informações:

  9. Escolha Criar memória para criar a AgentCore memória.

Tópicos