Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用命名空间指定长期内存组织

创建 AgentCore 内存时，请使用命名空间来指定内存策略的长期内存的逻辑分组位置。每次使用内存策略提取新的长期内存时，都会将其保存在您设置的命名空间下。这意味着所有长期记忆都限于其特定的命名空间，从而使它们井井有条，并防止与其他用户或会话混淆。应使用由正斜杠分隔的分层格式/，以斜杠开头和结尾（例如，/actors/alice/）。这有助于使记忆井井有条。根据需要，您可以根据应用程序的组织需求选择在命名空间的大括号内使用以下预定义变量：

例如，如果您在创建 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}/

所有策略均覆盖全球

/

对于更精细的组织，您可以添加自定义命名空间变量来表示其他维度，例如租户、团队或环境。

有关示例代码，请参阅启用长期内存。

命名空间格式

AgentCore Memory 以标准化形式存储每个命名空间，前导有一个斜杠/和一个尾部斜杠/（例如，）。/actors/alice/我们建议您在指定命名空间的任何地方都使用这种格式：

自定义命名空间变量

除了内置变量 (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
)