View a markdown version of this page

Organisasi memori dalam AgentCore Memori - Batu Dasar Amazon AgentCore
Short-term organisasi memoriLong-term organisasi memori

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Organisasi memori dalam AgentCore Memori

Anda dapat mengatur bagaimana ingatan jangka pendek dan jangka panjang diatur dalam AgentCore Memori. Ini memungkinkan Anda mengisolasi kenangan berdasarkan sesi dan aktor. Untuk memori jangka panjang, Anda juga dapat mengatur namespace untuk mengatur memori yang diekstraksi untuk strategi memori.

  • Aktor — Mengacu pada entitas seperti pengguna akhir atau agent/user kombinasi. Misalnya, dalam chatbot dukungan coding, aktor biasanya pengembang yang mengajukan pertanyaan. Menggunakan ID aktor membantu sistem mengetahui pengguna mana yang dimiliki memori, menjaga data setiap pengguna tetap terpisah dan terorganisir.

  • S esi — Percakapan tunggal atau periode interaksi antara pengguna dan agen AI. Ini mengelompokkan semua pesan dan peristiwa terkait yang terjadi selama percakapan itu.

  • Strategi (hanya Long-term memori) — Menunjukkan strategi memori jangka panjang mana yang digunakan. Pengidentifikasi strategi ini dibuat secara otomatis saat Anda membuat AgentCore Memori.

Short-term organisasi memori

Saat Anda membuat peristiwa memori jangka pendek dengan CreateEvent, Anda menentukan ID sesi (sessionId) dan ID aktor (actorId) yang secara unik mengidentifikasi sesi dan aktor untuk acara tersebut. Kemudian, Anda dapat mengambil peristiwa untuk pengguna atau sesi dengan menggunakan operasi memori jangka pendek.

Misalnya kode, lihat Langkah 3: Menangkap riwayat percakapan.

Long-term organisasi memori

Saat Anda membuat atau memperbarui AgentCore Memori, Anda dapat secara opsional membuat satu atau lebih strategi memori. Dalam strategi, gunakan namespace untuk menentukan Memori mengatur AgentCore memori Long-term memori jangka panjang.

Setiap kali AgentCore Memori mengekstrak memori jangka panjang baru dengan strategi memori, memori jangka panjang disimpan di bawah namespace yang Anda tetapkan. Ini berarti bahwa semua memori jangka panjang dicakup ke ruang nama spesifik mereka, menjaganya tetap teratur dan mencegah konflik dengan pengguna atau sesi lain. Anda harus menggunakan format hierarkis yang dipisahkan oleh garis miring ke depan/, diakhiri dengan garis miring. Garis miring di belakang mencegah tabrakan awalan dalam aplikasi multi-penyewa — misalnya, gunakan alih-alih. /actors/Alice/ /actors/Alice Sesuai kebutuhan, Anda dapat menggunakan variabel pra-definisi berikut dalam kurung kurung di namespace berdasarkan kebutuhan organisasi aplikasi Anda:

  • ActoRid — Mengidentifikasi siapa milik memori jangka panjang.

  • StrategyID — Menunjukkan strategi memori yang digunakan.

  • SessionId — Mengidentifikasi sesi atau percakapan mana memori berasal.

Misalnya, jika Anda mendefinisikan namespace berikut sebagai masukan ke strategi Anda saat membuat AgentCore Memori:

/strategy/{memoryStrategyId}/actor/{actorId}/session/{sessionId}/

Setelah pembuatan memori, namespace ini mungkin terlihat seperti:

/strategy/summarization-93483043/actor/actor-9830m2w3/session/session-9330sds8/

Sebuah namespace dapat memiliki tingkat granularitas yang berbeda:

Tingkat organisasi yang paling terperinci

/strategy/{memoryStrategyId}/actor/{actorId}/session/{sessionId}/

Granular di Tingkat aktor di seluruh sesi

/strategy/{memoryStrategyId}/actor/{actorId}/

Granular di Tingkat strategi lintas aktor

/strategy/{memoryStrategyId}/

Global di semua strategi

/

Misalnya kode, lihat Meng aktifkan memori jangka panjang.

Untuk informasi selengkapnya tentang mengatur memori jangka panjang dengan ruang nama, termasuk variabel namespace khusus dan kontrol akses IAM, lihat Menentukan organisasi memori jangka panjang dengan ruang nama.

Batasi akses dengan IAM

Anda dapat membuat kebijakan IAM untuk membatasi akses memori berdasarkan cakupan yang Anda tentukan, seperti aktor, sesi, dan namespace. Gunakan cakupan sebagai kunci konteks dalam kebijakan IAM Anda.

Kebijakan berikut membatasi akses untuk mengambil memori ke namespace atau rekaman tertentu di bawah hierarki NamespacePath tertentu. Dalam contoh ini, kebijakan mengizinkan akses hanya ke memori dengan ruang nama yang tepat seperti summaries/agent1/ OR dengan ruang nama di bawah hierarki NameSpacePath berikut dengan, seperti atau. summaries/agent1/ summaries/agent1/session1/ summaries/agent1/session2/

{
"Version":"2012-10-17",
  "Statement": [
    {
      "Sid": "SpecificNamespaceAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:RetrieveMemoryRecords"
      ],
      "Resource": "arn:aws:bedrock-agentcore:us-east-1:123456789012:memory/memory_id",
      "Condition": {
        "StringEquals": {
          "bedrock-agentcore:namespace": "summaries/agent1/"
        }
      }
    },
    {
      "Sid": "SpecificNamespacePathAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:RetrieveMemoryRecords"
      ],
      "Resource": "arn:aws:bedrock-agentcore:us-east-1:123456789012:memory/memory_id",
      "Condition": {
        "StringLike": {
          "bedrock-agentcore:namespacePath": "summaries/agent1/*"
        }
      }
    }
  ]
}