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 retransmite os resultados e 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 manipula a autenticação, a injeção de parâmetros e a subdefinição do esquema. 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 alvos do gateway da base de conhecimento são compatíveis somente com bases de conhecimento gerenciadas e somente com autenticação de IAM-based saída (o tipo de provedor de GATEWAY_IAM_ROLE credenciais).

Pré-requisitos

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

  • Um AgentCore gateway e uma função de serviço de gateway com permissão para recuperar 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 do serviço de gateway e a política de confiança, controlar quais parâmetros de recuperação o agente pode definir, invocar as ferramentas e os esquemas completos de entrada e resposta — consulte Amazon Bedrock Managed Knowledge Bases as Connector Target no Amazon Bedrock Developer Guide. 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 base de conhecimento alternando 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 a autenticação do 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.

  • endpointDefina o como sua URL do 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 para o agente sem configuração adicional.