View a markdown version of this page

Créez un événement - Amazon Bedrock AgentCore
Types de charge utile des événementsBranchement d'événements

Créez un événement

Les événements sont les unités fondamentales du court terme à partir desquelles les informations structurées sont extraites dans la mémoire à long terme dans AgentCore Memory. L'CreateEventopération vous permet de stocker différents types de données dans AgentCore Memory, organisés par acteur et par session. Les événements sont définis dans la mémoire sous :

ActorId

Identifie l'entité associée à l'événement, telle que les utilisateurs finaux ou les combinaisons agent/user

SessionId

Regroupe des événements connexes, tels qu'une session de conversation

L'CreateEventopération enregistre un nouvel événement immuable dans une session mémoire spécifiée. Les événements représentent des informations individuelles que votre agent souhaite mémoriser, telles que les messages de conversation, les actions des utilisateurs ou les événements du système.

Cette opération est utile pour :

  • Enregistrement de l'historique des conversations entre les utilisateurs, les agents et les outils

  • Stockage des interactions et des comportements des utilisateurs

  • Capture des événements et des changements d'état du système

  • Création d'un enregistrement chronologique des activités au cours d'une session

Pour un exemple de code, voir Scénario : un agent AI du support client utilisant AgentCore Memory.

Types de charge utile des événements

Le payload paramètre accepte une liste d'éléments de charge utile, ce qui vous permet de stocker différents types de données lors d'un seul événement. Les types de charge utile courants incluent :

Conversationnel

Pour stocker des messages de conversation avec des rôles (par exemple, « utilisateur » ou « assistant ») et du contenu.

Blob

Pour stocker des données au format binaire, telles que des images et des documents, ou des données propres à votre agent, telles que les données stockées au format JSON.

Note

Actuellement, seules les données conversationnelles circulent dans la mémoire à long terme.

Branchement d'événements

Le branch paramètre vous permet d'organiser des événements par le biais de branchements avancés. Cela est utile pour les scénarios tels que l'édition de messages ou les chemins de conversation alternatifs. Supposons, par exemple, que vous ayez une longue conversation et que vous vous rendiez compte que vous souhaitez explorer une autre conversation entamée il y a 5 messages. Vous pouvez utiliser le branch paramètre pour démarrer une nouvelle conversation à partir de ce message, stocké dans la nouvelle branche, ce qui vous permet également de revenir à la conversation d'origine. Et plus banalement, cela est utile si vous souhaitez permettre à votre utilisateur de modifier son message le plus récent (au cas où l'utilisateur appuierait sur Entrée trop tôt ou s'il a une faute de frappe) et de poursuivre la conversation.

Lorsque vous créez une branche, vous spécifiez :

nom

Nom descriptif de la branche, tel que « conversation modifiée ».

racineEventId

L'ID de l'événement à l'origine de la branche.

Voici un exemple de création d'un événement ramifié pour représenter un message modifié :

{
  "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"
  }
}