View a markdown version of this page

Membuat peristiwa - Batuan Dasar Amazon AgentCore
Jenis payload acaraPercabangan acara

Membuat peristiwa

Peristiwa adalah unit dasar jangka pendek dari mana informasi terstruktur diekstraksi ke dalam memori jangka panjang dalam Memori. AgentCore CreateEventOperasi ini memungkinkan Anda menyimpan berbagai jenis data dalam AgentCore Memori, yang diatur oleh aktor dan sesi. Peristiwa dicakup dalam memori di bawah:

ActorId

Mengidentifikasi entitas yang terkait dengan peristiwa, seperti pengguna akhir atau kombinasi agent/user

SessionId

Kelompokkan acara terkait bersama, seperti sesi percakapan

CreateEventOperasi menyimpan peristiwa baru yang tidak dapat diubah dalam sesi memori tertentu. Acara mewakili potongan informasi individual yang ingin diingat agen Anda, seperti pesan percakapan, tindakan pengguna, atau peristiwa sistem.

Operasi ini berguna untuk:

  • Merekam riwayat percakapan antara pengguna, agen, dan alat

  • Menyimpan interaksi dan perilaku pengguna

  • Menangkap peristiwa sistem dan perubahan status

  • Membangun catatan kronologis kegiatan dalam suatu sesi

Misalnya kode, lihat Skenario: Agen AI dukungan pelanggan menggunakan AgentCore Memori.

Jenis payload acara

payloadParameter menerima daftar item payload, memungkinkan Anda menyimpan berbagai jenis data dalam satu peristiwa. Jenis muatan umum meliputi:

Percakapan

Untuk menyimpan pesan percakapan dengan peran (misalnya, “pengguna” atau “asisten”) dan konten.

Gumpalan

Untuk menyimpan data format biner, seperti gambar dan dokumen, atau data yang unik untuk agen Anda, seperti data yang disimpan dalam format JSON.

catatan

Saat ini, hanya data percakapan yang mengalir ke memori jangka panjang.

Percabangan acara

branchParameter ini memungkinkan Anda mengatur acara melalui percabangan lanjutan. Ini berguna untuk skenario seperti pengeditan pesan atau jalur percakapan alternatif. Misalnya, Anda memiliki percakapan yang berjalan lama, dan Anda menyadari bahwa Anda tertarik untuk menjelajahi percakapan alternatif mulai dari 5 pesan yang lalu. Anda dapat menggunakan branch parameter untuk memulai percakapan baru dari pesan itu, yang disimpan di cabang baru — yang memungkinkan Anda juga kembali ke percakapan asli. Dan yang lebih biasa, ini berguna jika Anda ingin membiarkan pengguna Anda mengedit pesan terbaru mereka (jika pengguna menekan enter lebih awal atau salah ketik) dan melanjutkan percakapan.

Saat membuat cabang, Anda menentukan:

name

Nama deskriptif untuk cabang, seperti “percakapan yang diedit”.

akar EventId

ID acara dari mana cabang berasal.

Berikut adalah contoh membuat acara bercabang untuk mewakili pesan yang diedit:

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