Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea un evento

Gli eventi sono le unità fondamentali di breve termine da cui le informazioni strutturate vengono estratte nella memoria a lungo termine in AgentCore Memoria. L'CreateEventoperazione consente di archiviare vari tipi di dati all'interno della AgentCore memoria, organizzati per attore e sessione. Gli eventi sono classificati all'interno della memoria in:

L'CreateEventoperazione memorizza un nuovo evento immutabile all'interno di una sessione di memoria specificata. Gli eventi rappresentano singole informazioni che l'agente desidera ricordare, come messaggi di conversazione, azioni dell'utente o eventi di sistema.

Questa operazione è utile per:

Ad esempio di codice, vedi Scenario: un agente AI dell'assistenza clienti che utilizza AgentCore la memoria.

Tipi di payload degli eventi

Il payload parametro accetta un elenco di elementi del payload, consentendo di archiviare diversi tipi di dati in un singolo evento. I tipi di payload più comuni includono:

Poiché payload è un elenco, un singolo evento può contenere più di un elemento di payload e diversi tipi di payload. L'esempio seguente mostra il corpo di una richiesta JSON che memorizza un messaggio conversazionale, un registro delle attività JSON e un blob binario (un'immagine con codifica base64) in un unico evento:

Multi-payload Esempio: richiesta di evento

{
  "memoryId": "mem-12345abcdef",
  "actorId": "agent-support-123/customer-456",
  "sessionId": "session-789",
  "eventTimestamp": 1718806000000,
  "payload": [
    {
      "conversational": {
        "content": {
          "text": "Here's a photo of the camera I'm interested in."
        },
        "role": "USER"
      }
    },
    {
      "json": {
        "content": {
          "eventType": "product_viewed",
          "productId": "cam-9921",
          "category": "action-cameras",
          "priceUsd": 349.99
        }
      }
    },
    {
      "blob": "iVBORw0KGgoAAAANSUhEUg..."
    }
  ]
}

Configurazione dell'estrazione

Utilizzate il extractionConfig parametro per configurare il comportamento dell'estrazione della memoria a lungo termine per questo evento. Utilizzate questo parametro per passare i valori delle variabili namespace personalizzate che il servizio sostituisce durante l'estrazione. namespaceTemplates

L'esempio seguente mostra come passare valori personalizzati delle variabili namespace durante la creazione di un evento:

{
  "memoryId": "mem-12345abcdef",
  "actorId": "user456",
  "sessionId": "session789",
  "eventTimestamp": 1692804206123,
  "payload": [
    {
      "conversational": {
        "content": {"text": "I need help with my deployment."},
        "role": "USER"
      }
    }
  ],
  "extractionConfig": {
    "namespaceVariables": {
      "orgname": "engineering",
      "teamname": "backend"
    }
  }
}

Branching degli eventi

Il branch parametro consente di organizzare gli eventi tramite una ramificazione avanzata. Ciò è utile per scenari come la modifica di messaggi o percorsi di conversazione alternativi. Ad esempio, supponiamo di avere una conversazione di lunga durata e di renderti conto di essere interessato a esplorare una conversazione alternativa a partire da 5 messaggi fa. Potete utilizzare il branch parametro per iniziare una nuova conversazione partendo da quel messaggio, memorizzato nel nuovo ramo, in modo da tornare anche alla conversazione originale. E, più banalmente, questo è utile se si desidera consentire all'utente di modificare il messaggio più recente (nel caso in cui l'utente prema invio in anticipo o abbia un errore di battitura) e continuare la conversazione.

Quando si crea un ramo, si specifica:

Ecco un esempio di creazione di un evento ramificato per rappresentare un messaggio modificato:

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