本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用命名空間指定長期記憶體組織

當您建立 AgentCore 記憶體時，請使用命名空間來指定記憶體策略的長期記憶體在邏輯上分組的位置。每次使用記憶體策略擷取新的長期記憶體時，都會儲存在您設定的命名空間中。這表示所有長期記憶體的範圍都限定在其特定的命名空間，保持它們井然有序，並防止與其他使用者或工作階段進行任何混淆。您應該使用以斜線 / 分隔的階層格式。這有助於清晰地整理記憶。如有需要，您可以根據應用程式的組織需求，選擇在命名空間中的括號內使用下列預先定義的變數：

例如，如果您在建立 AgentCore 記憶體時將下列命名空間定義為策略的輸入：

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

建立記憶體後，此命名空間可能看起來像：

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

命名空間可以有不同層級的精細程度。下列範例僅使用內建變數：

工作階段層級的精細

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

跨工作階段演員層級的精細

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

跨演員策略層級的精細

/strategy/{memoryStrategyId}/

全球所有策略

/

對於更精細的組織，您可以新增自訂命名空間變數來代表其他維度，例如租戶、團隊或環境。

如需範例程式碼，請參閱啟用長期記憶體。

自訂命名空間變數

除了內建變數 (actorId、sessionId、memoryStrategyId) 之外，您還可以定義自訂命名空間變數，以代表應用程式的獨特組織維度，例如公司、組織、團隊或環境。使用自訂變數，您可以沿著任意階層範圍化長期記憶體，而無需建立重複的策略或超載內建變數。

例如，多租戶應用程式可能需要組織範圍的記憶體：

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

您可以在使用 namespaceKeys 參數建立或更新現有記憶體資源時定義自訂變數，並透過 CreateEvent 操作中的 extractionConfig.namespaceVariables 欄位在執行時間提供其值。

定義命名空間索引鍵

當您建立或更新記憶體資源時，請使用 namespaceKeys 參數來宣告您的自訂變數金鑰和選用的驗證規則。每個金鑰必須：

每個記憶體資源最多可以定義 5 個命名空間索引鍵，每個 最多可以定義 5 個自訂變數namespaceTemplate。

定義命名空間索引鍵時，請記住下列事項：

對於每個金鑰，您可以選擇指定驗證規則，以限制執行時間接受的值：

當您同時指定 allowedValues和 時regexPattern，服務會強制執行這兩個規則 （邏輯 AND)。

下列範例示範如何使用自訂命名空間變數和驗證來建立記憶體資源：

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-]*$"}}
    ]'

在執行時間提供命名空間值

當您使用 CreateEvent 操作建立事件時，請在 extractionConfig.namespaceVariables 欄位中傳遞自訂命名空間變數值：

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

服務會在長期記憶體擷取期間將這些值取代為命名空間範本。

更新命名空間金鑰

當您使用 UpdateMemory 操作更新命名空間金鑰時，該namespaceKeys值會完全取代現有的集合。若要安全更新，請使用 擷取目前的金鑰GetMemory、套用您的變更，然後提交完整清單。

請記住下列限制條件：

# 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
)

使用 IAM 條件金鑰限制寫入路徑存取

您可以建立使用 bedrock-agentcore:namespaceVariable/<variableName>條件索引鍵的 IAM 政策，以控制發起人在建立事件時可以使用的自訂命名空間變數值。使用此條件金鑰，您可以在寫入路徑強制執行租用戶隔離。

條件索引鍵遵循模式，bedrock-agentcore:namespaceVariable/<key>其中 <key>是 中定義的命名空間變數名稱namespaceKeys。

下列政策僅允許呼叫者在 orgname 設定為 時建立事件acme，並在 orgname 設定為 時明確拒絕請求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"
        }
      }
    }
  ]
}

下表顯示 IAM 如何根據政策中是否存在條件索引鍵，以及請求是否提供命名空間變數來評估請求：

使用 IAM 限制讀取路徑存取

您可以建立 IAM 政策來限制您定義範圍的記憶體讀取存取權，例如演員、工作階段和命名空間。使用範圍做為 IAM 政策中的內容索引鍵。

下列政策會將擷取記憶體的存取權限制在特定命名空間或特定namespacePath階層下的記錄。在此範例中，政策僅允許存取具有確切命名空間的記憶體，例如具有命名空間的 summaries/agent1/ OR，位於具有 的下列namespacePath階層下，例如 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/*"
        }
      }
    }
  ]
}