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
<a name="kb-gateway-target"></a>

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:Retrieve`no 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](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-connector-managed-kb.html) Developer Guide. AgentCore *

## Invoque com agentes Strands
<a name="kb-gateway-target-invoke-strands"></a>

Se você tiver um agente existente criado com o [SDK do Strands Agents](https://strandsagents.com/latest/) e o [kit de ferramentas AgentCore inicial](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-get-started-toolkit.html), 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` de`mcp-proxy-for-aws`.
+ `endpoint`Defina 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.