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á.

Usar a recuperação com agente para consultar uma base de conhecimentos

A recuperação agente usa um modelo básico para decompor de forma inteligente consultas complexas em subconsultas, recuperar iterativamente informações relevantes de suas bases de conhecimento e avaliar se os resultados recuperados são suficientes para responder à consulta original. Essa abordagem melhora a precisão da recuperação de questões complexas de várias etapas que um único passe de recuperação pode não resolver totalmente.

Por exemplo, dada a pergunta “Qual revista foi criada primeiro, Arthur's Magazine ou First for Women?” , a recuperação agente divide isso em subconsultas separadas, como “Quando foi fundada a Arthur's Magazine?” e “Quando foi fundada a First for Women?” , recupera os resultados de cada um e avalia se os resultados combinados são suficientes.

Como funciona a recuperação de agentes

Quando você envia uma solicitação para a AgenticRetrieveStream API, ocorre o seguinte processo:

Pré-requisitos

Antes de usar a recuperação agente, você deve ter o seguinte:

Consulte uma base de conhecimento com recuperação de agentes

Para usar a recuperação agente, envie uma solicitação. AgenticRetrieveStream A resposta é um fluxo que inclui resultados de recuperação e eventos de rastreamento.

A tabela a seguir descreve os principais campos de solicitação:

Para ver a sintaxe completa de solicitação e resposta, consulte AgenticRetrieveStream na referência da API.

Resposta de recuperação de agentes

A AgenticRetrieveStream resposta é um fluxo que contém os seguintes tipos de eventos:

Use AgentCore memória com recuperação agente

Você pode conceder acesso de recuperação agente a um recurso da Amazon Bedrock AgentCore Memory. Com o acesso à memória, uma recuperação pode continuar uma sessão anterior e aproveitar o que o agente aprendeu nas sessões anteriores. Forneça ao memoryConfiguration campo o memoryId de um recurso de memória em sua conta que esteja no ACTIVE estado.

A memória é opcional. Um memoryConfiguration que define somente a não memoryId é válido. Ao fornecermemoryConfiguration, você deve usar o recurso de memória em pelo menos uma das duas maneiras a seguir:

Forneça namespaces exatamente como estão configurados na estratégia de memória, com espaços reservados já resolvidos. Por exemplo, se a estratégia definir o namespace/strategy/{memoryStrategyId}/actor/{actorId}, forneça o valor resolvido em vez do modelo. Para obter mais informações sobre namespaces, estratégias e registros de memória, consulte Terminologia de memória no Amazon Bedrock AgentCore Developer Guide.

Quando sessionBinding definido, use persistenceMode para controlar se a troca atual é gravada de volta na sessão:

O exemplo a seguir restaura uma sessão anterior, dá ao agente acesso à memória de longo prazo desse ator e persiste a troca de volta para a sessão:

{
    "messages": [
        {
            "content": {
                "text": "What did we decide about the migration timeline?"
            },
            "role": "user"
        }
    ],
    "retrievers": [
        {
            "configuration": {
                "knowledgeBase": {
                    "knowledgeBaseId": "KB12345678"
                }
            }
        }
    ],
    "agenticRetrieveConfiguration": {
        "foundationModelType": "MANAGED",
        "rerankingModelType": "MANAGED"
    },
    "memoryConfiguration": {
        "memoryId": "projectAssistantMemory-1a2b3c4d5e",
        "sessionBinding": {
            "actorId": "user-123",
            "sessionId": "session-456"
        },
        "retrievalConfigs": [
            {
                "namespace": "/strategy/summarization-1a2b3c4d5e/actor/user-123"
            }
        ],
        "persistenceMode": "DEFAULT"
    }
}

O fluxo de resposta relata a atividade da memória. A restauração aparece como um evento de rastreamento de carregamento do histórico da sessão. Os registros que a memória de longo prazo retorna aparecem no evento de rastreamento de recuperação com um tipo de fonte deBedrockAgentCoreMemory, qualquer que seja a etapa recuperada.

A aparência da recuperação em si depende de quando ela acontece. Quando o modelo básico opta por pesquisar a memória (típico em uma sessão contínua), a recuperação aparece como uma memoryRetrieve ação no evento de rastreamento do Planning. Em uma nova sessão, o agente pode, em vez disso, recuperar a memória de longo prazo durante a recuperação especulativa, antes da primeira etapa de planejamento; nesse caso, ele não emite nenhuma ação. memoryRetrieve Para obter mais informações, consulte Resposta de recuperação de agentes.

Permissões necessárias para recuperação de agentes

Para usar a AgenticRetrieveStream API, a identidade do IAM de chamada deve ter as seguintes permissões:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "bedrock:AgenticRetrieveStream",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock:Retrieve",
                "bedrock:GetDocumentContent"
            ],
            "Resource": "arn:aws:bedrock:region:account-id:knowledge-base/*"
        },
        {
            "Effect": "Allow",
            "Action": "bedrock:InvokeModelWithResponseStream",
            "Resource": "*"
        }
    ]
}

Se você usar grades de proteção com recuperação de agentes, adicione as seguintes permissões:

{
    "Effect": "Allow",
    "Action": [
        "bedrock:GetGuardrail",
        "bedrock:ApplyGuardrail"
    ],
    "Resource": "*"
}

Se você usar um recurso de AgentCore memória com recuperação de agente, adicione as seguintes permissões:

{
    "Effect": "Allow",
    "Action": [
        "bedrock-agentcore:GetMemory",
        "bedrock-agentcore:ListEvents",
        "bedrock-agentcore:RetrieveMemoryRecords",
        "bedrock-agentcore:CreateEvent"
    ],
    "Resource": "arn:aws:bedrock-agentcore:region:account-id:memory/memory-id"
}

bedrock-agentcore:ListEventsé necessário somente quando você definesessionBinding. bedrock-agentcore:RetrieveMemoryRecordsé necessário somente quando você defineretrievalConfigs. bedrock-agentcore:CreateEventé necessário somente quando persistenceMode éDEFAULT.

Se o recurso de memória estiver criptografado com uma chave gerenciada pelo cliente, adicione a seguinte permissão nessa chave:

{
    "Effect": "Allow",
    "Action": "kms:Decrypt",
    "Resource": "arn:aws:kms:region:account-id:key/key-id"
}

Considerações

Lembre-se do seguinte ao usar a recuperação agente: