View a markdown version of this page

Criar um evento - Amazon Bedrock AgentCore
Tipos de carga útil do eventoRamificação de eventos

Criar um evento

Os eventos são as unidades fundamentais de curto prazo das quais as informações estruturadas são extraídas para a memória de longo prazo na AgentCore Memória. A CreateEventoperação permite armazenar vários tipos de dados na AgentCore Memória, organizados por um ator e uma sessão. Os eventos são definidos na memória em:

ActorId

Identifica a entidade associada ao evento, como usuários finais ou combinações agent/user

SessionId

Agrupa eventos relacionados, como uma sessão de conversação

A CreateEvent operação armazena um novo evento imutável em uma sessão de memória especificada. Os eventos representam informações individuais que seu agente deseja lembrar, como mensagens de conversa, ações do usuário ou eventos do sistema.

Essa operação é útil para:

  • Gravação do histórico de conversas entre usuários, agentes e ferramentas

  • Armazenando interações e comportamentos do usuário

  • Capturando eventos do sistema e mudanças de estado

  • Construindo um registro cronológico das atividades em uma sessão

Por exemplo de código, consulte Cenário: um agente de IA de suporte ao cliente usando AgentCore memória.

Tipos de carga útil do evento

O payload parâmetro aceita uma lista de itens de carga útil, permitindo que você armazene diferentes tipos de dados em um único evento. Os tipos comuns de carga útil incluem:

Conversacional

Para armazenar mensagens de conversa com funções (por exemplo, “usuário” ou “assistente”) e conteúdo.

Blob

Para armazenar dados em formato binário, como imagens e documentos, ou dados exclusivos do seu agente, como dados armazenados no formato JSON.

nota

Atualmente, somente dados de conversação fluem para a memória de longo prazo.

Ramificação de eventos

O branch parâmetro permite organizar eventos por meio de ramificações avançadas. Isso é útil para cenários como edição de mensagens ou caminhos alternativos de conversação. Por exemplo, suponha que você tenha uma conversa de longa duração e perceba que está interessado em explorar uma conversa alternativa a partir de 5 mensagens atrás. Você pode usar o branch parâmetro para iniciar uma nova conversa a partir dessa mensagem, armazenada na nova ramificação, o que também permite retornar à conversa original. E, mais mundanamente, isso é útil se você quiser permitir que seu usuário edite a mensagem mais recente (caso o usuário pressione enter mais cedo ou tenha um erro de digitação) e continue a conversa.

Ao criar uma ramificação, você especifica:

name

Um nome descritivo para a ramificação, como “conversa editada”.

raizEventId

O ID do evento do qual a filial se origina.

Aqui está um exemplo de criação de um evento ramificado para representar uma mensagem editada:

{
  "memoryId": "mem-12345abcdef",
  "actorId": "/agent-support-123/customer-456",
  "sessionId": "session-789",
  "eventTimestamp": 1718806000000,
  "payload": [
    {
      "Conversational": {
        "content": "I'm looking for a waterproof action camera for extreme sports.",
        "role": "user"
      }
    }
  ],
  "branch": {
    "name": "edited-conversation",
    "rootEventId": "evt-67890"
  }
}