

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Conéctese a su base de conocimientos a través de AgentCore Gateway
<a name="kb-gateway-target"></a>

AgentCore Gateway le permite exponer su base de conocimientos gestionada por Amazon Bedrock como una herramienta mediante el Model Context Protocol (MCP). Tras añadir un objetivo de base de conocimientos a una pasarela, cualquier MCP-compatible cliente puede consultar la base de conocimientos como una herramienta MCP estándar. El conector expone dos herramientas:
+ `AgenticRetrieveStream`: una recuperación de varios pasos por parte de una agencia de streaming que planifica, recupera de forma iterativa y transmite los resultados y una respuesta opcional sintetizada y respaldada por citas.
+ `Retrieve`— una búsqueda única que devuelve los pasajes más relevantes con referencias a las fuentes.

La puerta de enlace actúa como un intermediario que gestiona la autenticación, la inyección de parámetros y la creación de subconjuntos de esquemas. Como administrador, usted vincula la base de conocimientos y controla qué parámetros están expuestos al agente que realiza la llamada y cuáles están ocultos con valores predeterminados preconfigurados.

**nota**  
Los destinos de las pasarelas de base de conocimientos solo son compatibles con las bases de conocimiento gestionadas y únicamente con la autenticación IAM-based saliente (del tipo del proveedor de `GATEWAY_IAM_ROLE` credenciales).

**Requisitos previos**
+ Una base de conocimientos gestionada y su ID de base de conocimientos.
+ Una AgentCore puerta de enlace y una función de servicio de puerta de enlace con permiso para recuperarlos de la base de conocimientos (`bedrock:Retrieve`en el ARN de la base de conocimientos).

Para obtener instrucciones completas, como la creación del destino de la puerta de enlace con el AWS SDK o la AWS CLI, la configuración del rol del servicio de puerta de enlace y la política de confianza, el control de los parámetros de recuperación que el agente puede establecer, la invocación de las herramientas y los esquemas completos de entrada y respuesta, consulte [las bases de conocimiento gestionadas de Amazon Bedrock como destino del conector en](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-connector-managed-kb.html) la guía para desarrolladores de *Amazon* Bedrock. AgentCore 

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

Si ya tiene un agente creado con el [SDK de Strands Agents](https://strandsagents.com/latest/) y el [AgentCorekit de herramientas inicial](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-get-started-toolkit.html), puede conectarlo a la puerta de enlace de su base de conocimientos cambiando el cliente MCP para que utilice la autenticación SigV4 en el punto final de la puerta de enlace.

Instale el paquete `mcp-proxy-for-aws`:

```
pip install mcp-proxy-for-aws
```

A continuación, actualice su cliente MCP para que apunte a la URL de la puerta de enlace con la autenticación de 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",
    ))
```

Los cambios clave con respecto a la configuración de un cliente MCP estándar son:
+ Sustituya `streamablehttp_client` del `mcp` paquete por «`aws_iam_streamablehttp_client`de`mcp-proxy-for-aws`».
+ Configura la URL `endpoint` de tu AgentCore puerta de enlace.
+ Especifique `aws_service="bedrock-agentcore"` la firma SigV4.

Una vez conectadas, las herramientas de la base de conocimientos se detectan automáticamente `tools/list` y están disponibles para el agente sin necesidad de configuración adicional.