이벤트 생성

이벤트는 구조화된 정보가 AgentCore 메모리의 장기 메모리로 추출되는 단기 단위입니다. CreateEvent 작업을 사용하면 액터 및 세션별로 구성된 다양한 유형의 데이터를 AgentCore 메모리 내에 저장할 수 있습니다. 이벤트는 메모리 내에서 다음과 같이 범위가 지정됩니다.

CreateEvent 작업은 지정된 메모리 세션 내에 변경 불가능한 새 이벤트를 저장합니다. 이벤트는 대화 메시지, 사용자 작업 또는 시스템 이벤트와 같이 에이전트가 기억하고 싶은 개별 정보를 나타냅니다.

이 작업은 다음에 유용합니다.

예제 코드는 시나리오: AgentCore 메모리를 사용하는 고객 지원 AI 에이전트를 참조하세요.

이벤트 페이로드 유형

payload 파라미터는 페이로드 항목 목록을 수락하므로 단일 이벤트에 다양한 유형의 데이터를 저장할 수 있습니다. 일반적인 페이로드 유형은 다음과 같습니다.

이벤트 분기

branch 파라미터를 사용하면 고급 분기를 통해 이벤트를 구성할 수 있습니다. 이는 메시지 편집 또는 대체 대화 경로와 같은 시나리오에 유용합니다. 예를 들어 장시간 대화를 나누고 5개 메시지부터 시작하는 대체 대화를 탐색하는 데 관심이 있다고 가정해 보겠습니다. branch 파라미터를 사용하여 새 브랜치에 저장된 해당 메시지에서 새 대화를 시작할 수 있습니다. 그러면 원래 대화로 돌아갈 수도 있습니다. 또한이 기능은 사용자가 가장 최근 메시지를 편집하고(사용자가 일찍 입력을 누르거나 오타가 있는 경우) 대화를 계속하도록 하려는 경우에 유용합니다.

브랜치를 생성할 때 다음을 지정합니다.

다음은 편집된 메시지를 나타내는 분기 이벤트를 생성하는 예제입니다.

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