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

Tentukan organisasi memori jangka panjang dengan ruang nama

Saat Anda membuat AgentCore Memori, gunakan namespace untuk menentukan di mana memori jangka panjang untuk strategi memori dikelompokkan secara logis. Setiap kali memori jangka panjang baru diekstraksi menggunakan strategi memori, itu 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 campur tangan dengan pengguna atau sesi lain. Anda harus menggunakan format hierarkis yang dipisahkan oleh garis miring ke depan. / Ini membantu menjaga ingatan terorganisir dengan jelas. Sesuai kebutuhan, Anda dapat memilih untuk menggunakan variabel pra-definisi berikut dalam kurung kurung di namespace berdasarkan kebutuhan organisasi aplikasi Anda:

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. Contoh berikut hanya menggunakan variabel bawaan:

Granular pada tingkat sesi

/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

/

Untuk organisasi yang lebih terperinci, Anda dapat menambahkan variabel namespace khusus untuk mewakili dimensi tambahan seperti penyewa, tim, atau lingkungan.

Misalnya kode, lihat Meng aktifkan memori jangka panjang.

Variabel namespace kustom

Selain variabel bawaan (actorId,,memoryStrategyId)sessionId, Anda dapat menentukan variabel namespace khusus untuk mewakili dimensi organisasi unik aplikasi Anda, seperti perusahaan, organisasi, tim, atau lingkungan. Dengan variabel khusus, Anda dapat menjangkau memori jangka panjang di sepanjang hierarki sewenang-wenang tanpa membuat strategi duplikat atau membebani variabel bawaan secara berlebihan.

Misalnya, aplikasi multi-tenant mungkin memerlukan memori yang dicakup oleh organisasi:

/org/{orgname}/team/{teamname}/actor/{actorId}/session/{sessionId}/

Anda menentukan variabel kustom saat membuat atau memperbarui sumber daya memori yang ada menggunakan namespaceKeys parameter, dan memberikan nilainya saat runtime melalui extractionConfig.namespaceVariables bidang dalam CreateEvent operasi.

Tentukan kunci namespace

Saat Anda membuat atau memperbarui sumber daya memori, gunakan namespaceKeys parameter untuk mendeklarasikan kunci variabel kustom dan aturan validasi opsional. Setiap kunci harus:

Anda dapat menentukan hingga 5 kunci namespace per sumber daya memori, dan hingga 5 variabel khusus per. namespaceTemplate

Ingatlah hal-hal berikut saat mendefinisikan kunci namespace:

Untuk setiap kunci, Anda dapat secara opsional menentukan aturan validasi yang membatasi nilai yang diterima saat runtime:

Ketika Anda menentukan keduanya allowedValues danregexPattern, layanan memberlakukan kedua aturan (logisAND).

Contoh berikut menunjukkan cara membuat sumber daya memori dengan variabel namespace kustom dan validasi:

aws bedrock-agentcore-control create-memory \
    --name "MultiTenantAgentMemory" \
    --description "Memory for a multi-tenant AI agent" \
    --event-expiry-duration 10 \
    --memory-strategies '[
        {
            "semanticMemoryStrategy": {
                "name": "TenantScopedStrategy",
                "namespaceTemplates": ["/org/{orgname}/team/{teamname}/actor/{actorId}/session/{sessionId}/"]
            }
        }
    ]' \
    --namespace-keys '[
        {"key": "orgname", "validation": {"allowedValues": ["acme", "globex", "initech"]}},
        {"key": "teamname", "validation": {"regexPattern": "^[a-z][a-z0-9-]*$"}}
    ]'

Menyediakan nilai namespace saat runtime

Saat Anda membuat acara menggunakan CreateEvent operasi, berikan nilai variabel namespace kustom di extractionConfig.namespaceVariables bidang:

aws bedrock-agentcore create-event \
    --memory-id "MultiTenantAgentMemory-n29sh5ka8r" \
    --actor-id "user123" \
    --session-id "session67" \
    --event-timestamp "$(date -u +"%Y-%m-%dT%H:%M:%S.%3NZ")" \
    --payload '[
        {
            "conversational": {
                "content": {"text": "I need help debugging my application."},
                "role": "USER"
            }
        }
    ]' \
    --extraction-config '{
        "namespaceVariables": {
            "orgname": "acme",
            "teamname": "engineering"
        }
    }'

Layanan mengganti nilai-nilai ini ke dalam templat namespace selama ekstraksi memori jangka panjang.

Perbarui kunci namespace

Saat Anda memperbarui kunci namespace dengan UpdateMemory operasi, namespaceKeys nilai sepenuhnya menggantikan set yang ada. Untuk memperbarui dengan aman, ambil kunci saat ini denganGetMemory, terapkan perubahan Anda, dan kirimkan daftar lengkapnya.

Ingatlah kendala berikut:

# Get the current memory configuration
current = control_client.get_memory(memoryId="MultiTenantAgentMemory-n29sh5ka8r")
existing_keys = current['memory'].get('namespaceKeys', [])

# Add a new key while preserving existing ones
existing_keys.append({
    'key': 'category',
    'validation': {
        'allowedValues': ['backend', 'frontend', 'data']
    }
})

# Update with the full set
control_client.update_memory(
    memoryId="MultiTenantAgentMemory-n29sh5ka8r",
    namespaceKeys=existing_keys
)

Batasi akses jalur tulis dengan kunci kondisi IAM

Anda dapat membuat kebijakan IAM yang menggunakan kunci bedrock-agentcore:namespaceVariable/<variableName> kondisi untuk mengontrol nilai variabel namespace kustom mana yang dapat digunakan pemanggil saat membuat acara. Dengan kunci kondisi ini, Anda dapat menerapkan isolasi penyewa di jalur penulisan.

Kunci kondisi mengikuti pola di bedrock-agentcore:namespaceVariable/<key> <key> mana nama variabel namespace didefinisikan dinamespaceKeys.

Kebijakan berikut mengizinkan pemanggil membuat acara hanya bila disetel orgname keacme, dan secara eksplisit menolak permintaan saat orgname disetel ke: globex

{
"Version":"2012-10-17",
  "Statement": [
    {
      "Sid": "AllowCreateEventForAcme",
      "Effect": "Allow",
      "Action": "bedrock-agentcore:CreateEvent",
      "Resource": "arn:aws:bedrock-agentcore:us-east-1:123456789012:memory/memory_id",
      "Condition": {
        "StringEquals": {
          "bedrock-agentcore:namespaceVariable/orgname": "acme"
        }
      }
    },
    {
      "Sid": "DenyCreateEventForGlobex",
      "Effect": "Deny",
      "Action": "bedrock-agentcore:CreateEvent",
      "Resource": "arn:aws:bedrock-agentcore:us-east-1:123456789012:memory/memory_id",
      "Condition": {
        "StringEquals": {
          "bedrock-agentcore:namespaceVariable/orgname": "globex"
        }
      }
    }
  ]
}

Tabel berikut menunjukkan bagaimana IAM mengevaluasi permintaan berdasarkan apakah kunci kondisi ada dalam kebijakan dan apakah permintaan tersebut menyediakan variabel namespace:

Batasi akses jalur baca dengan IAM

Anda dapat membuat kebijakan IAM untuk membatasi akses baca 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/*"
        }
      }
    }
  ]
}