As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Especifique a organização da memória de longo prazo com namespaces

Ao criar uma AgentCore memória, use um namespace para especificar onde as memórias de longo prazo de uma estratégia de memória são agrupadas logicamente. Toda vez que uma nova memória de longo prazo é extraída usando a estratégia de memória, ela é salva no namespace que você definiu. Isso significa que todas as memórias de longo prazo têm como escopo seu namespace específico, mantendo-as organizadas e evitando qualquer confusão com outros usuários ou sessões. Você deve usar um formato hierárquico separado por barras. / Isso ajuda a manter as memórias organizadas de forma clara. Conforme necessário, você pode optar por usar as seguintes variáveis predefinidas entre chaves no namespace com base nas necessidades organizacionais do seu aplicativo:

Por exemplo, se você definir o namespace a seguir como entrada para sua estratégia ao criar uma AgentCore memória:

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

Após a criação da memória, esse namespace pode ter a seguinte aparência:

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

Um namespace pode ter diferentes níveis de granularidade. Os exemplos a seguir usam somente variáveis integradas:

Granular no nível da sessão

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

Granular no nível do ator em todas as sessões

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

Granular no nível da estratégia entre os atores

/strategy/{memoryStrategyId}/

Global em todas as estratégias

/

Para uma organização ainda mais granular, você pode adicionar variáveis de namespace personalizadas para representar dimensões adicionais, como locatário, equipe ou ambiente.

Por exemplo, código, consulte Habilitar memória de longo prazo.

Variáveis de namespace personalizadas

Além das variáveis integradas (actorId,,memoryStrategyId)sessionId, você pode definir variáveis de namespace personalizadas para representar as dimensões organizacionais exclusivas do seu aplicativo, como empresa, organização, equipe ou ambiente. Com variáveis personalizadas, você pode definir o escopo de memórias de longo prazo em hierarquias arbitrárias sem criar estratégias duplicadas ou sobrecarregar as variáveis incorporadas.

Por exemplo, um aplicativo multilocatário pode precisar de memórias com escopo definido pelas organizações:

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

Você define as variáveis personalizadas ao criar ou atualizar um recurso de memória existente usando o namespaceKeys parâmetro e fornece seus valores em tempo de execução por meio do extractionConfig.namespaceVariables campo na CreateEvent operação.

Definir chaves de namespace

Ao criar ou atualizar um recurso de memória, use o namespaceKeys parâmetro para declarar suas chaves de variáveis personalizadas e regras de validação opcionais. Cada chave deve:

Você pode definir até 5 chaves de namespace por recurso de memória e até 5 variáveis personalizadas por. namespaceTemplate

Lembre-se do seguinte ao definir chaves de namespace:

Para cada chave, você pode, opcionalmente, especificar regras de validação que restringem os valores aceitos em tempo de execução:

Quando você especifica allowedValues eregexPattern, o serviço impõe as duas regras (lógicasAND).

O exemplo a seguir mostra como criar um recurso de memória com variáveis de namespace personalizadas e validação:

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

Forneça valores de namespace em tempo de execução

Ao criar um evento usando a CreateEvent operação, passe os valores da variável de namespace personalizada no extractionConfig.namespaceVariables campo:

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

O serviço substitui esses valores nos modelos de namespace durante a extração de memória de longo prazo.

Atualizar chaves de namespace

Quando você atualiza as chaves de namespace com a UpdateMemory operação, o namespaceKeys valor substitui totalmente o conjunto existente. Para atualizar com segurança, recupere as chaves atuais comGetMemory, aplique suas alterações e envie a lista completa.

Lembre-se das seguintes restrições:

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

Restrinja o acesso ao caminho de gravação com chaves de condição do IAM

Você pode criar políticas do IAM que usam a chave de bedrock-agentcore:namespaceVariable/<variableName> condição para controlar quais valores de variáveis de namespace personalizados um chamador pode usar ao criar eventos. Com essa chave de condição, você pode impor o isolamento do inquilino no caminho de gravação.

A chave de condição segue o padrão bedrock-agentcore:namespaceVariable/<key> em que <key> está o nome da variável do namespace definido em. namespaceKeys

A política a seguir permite que o chamador crie eventos somente quando orgname está definida como e nega explicitamente as solicitações quando orgname está definida como: acme 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"
        }
      }
    }
  ]
}

A tabela a seguir mostra como o IAM avalia as solicitações com base na presença de uma chave de condição na política e se a solicitação fornece a variável de namespace:

Restrinja o acesso ao caminho de leitura com o IAM

Você pode criar políticas do IAM para restringir o acesso à leitura da memória pelos escopos que você define, como ator, sessão e namespace. Use os escopos como chaves de contexto em suas políticas do IAM.

A política a seguir restringe o acesso à recuperação de memórias em um namespace ou registros específicos em uma hierarquia específica do NamespacePath. Neste exemplo, a política permite acesso somente a memórias com namespaces exatos, como summaries/agent1/ OR com namespaces na seguinte hierarquia NamespacePath com, como ou. 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/*"
        }
      }
    }
  ]
}