View a markdown version of this page

Conecte-se à sua base de conhecimento por meio do AgentCore Gateway - Amazon Bedrock
Invoque com agentes Strands

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

Conecte-se à sua base de conhecimento por meio do AgentCore Gateway

AgentCore O Gateway permite que você exponha sua base de conhecimento gerenciada do Amazon Bedrock como uma ferramenta usando o Model Context Protocol (MCP). Depois de adicionar um alvo da base de conhecimento a um gateway, qualquer MCP-compatible cliente pode consultar a base de conhecimento como uma ferramenta MCP padrão. O conector expõe duas ferramentas:

  • AgenticRetrieveStream— uma recuperação agente de streaming em várias etapas que planeja, recupera iterativamente e transmite resultados, além de uma resposta opcional sintetizada e baseada em citações.

  • Retrieve— uma única pesquisa que retorna as passagens mais relevantes com referências de origem.

O gateway atua como um intermediário que lida com autenticação, injeção de parâmetros e subconjuntos de esquemas. Como administrador, você vincula a base de conhecimento e controla quais parâmetros são expostos ao agente chamador e quais estão ocultos com padrões pré-configurados.

nota

Os destinos do gateway da base de conhecimento são compatíveis somente com bases de conhecimento gerenciadas e somente com autenticação IAM-based externa (o tipo de provedor de GATEWAY_IAM_ROLE credenciais).

Pré-requisitos

  • Uma base de conhecimento gerenciada e seu ID de base de conhecimento.

  • Um AgentCore gateway e uma função de serviço de gateway com permissão para recuperação da base de conhecimento (bedrock:Retrieveno ARN da base de conhecimento).

Para obter instruções completas — incluindo criar o destino do gateway com o AWS SDK ou a AWS CLI, configurar a função de serviço e a política de confiança do gateway, controlar quais parâmetros de recuperação o agente pode definir, invocar as ferramentas e os esquemas completos de entrada e resposta — consulte Bases de conhecimento gerenciadas da Amazon Bedrock como destino do conector no Guia do desenvolvedor do Amazon Bedrock. AgentCore

Invoque com agentes Strands

Se você tiver um agente existente criado com o SDK do Strands Agents e o kit de ferramentas AgentCore inicial, poderá conectá-lo ao destino do gateway da sua base de conhecimento trocando o cliente MCP para usar a autenticação SigV4 no endpoint do gateway.

Instale o pacote mcp-proxy-for-aws:

pip install mcp-proxy-for-aws

Em seguida, atualize seu cliente MCP para apontar para a URL do gateway com autenticação IAM:

from mcp_proxy_for_aws.client import aws_iam_streamablehttp_client
from strands.tools.mcp.mcp_client import MCPClient

GATEWAY_URL = "https://your-gateway-url/mcp"

def get_streamable_http_mcp_client() -> MCPClient:
    """Returns an MCP Client with SigV4 auth for AgentCore Gateway."""
    return MCPClient(lambda: aws_iam_streamablehttp_client(
        endpoint=GATEWAY_URL,
        aws_region="us-west-2",
        aws_service="bedrock-agentcore",
    ))

As principais mudanças em relação à configuração padrão do cliente MCP são:

  • Substitua streamablehttp_client da mcp embalagem por aws_iam_streamablehttp_client demcp-proxy-for-aws.

  • Defina o endpoint para o URL do seu AgentCore gateway.

  • Especifique aws_service="bedrock-agentcore" para assinatura SigV4.

Uma vez conectadas, as ferramentas da base de conhecimento são descobertas automaticamente tools/list e disponibilizadas ao agente sem configuração adicional.