View a markdown version of this page

Conéctese a su base de conocimientos a través de AgentCore Gateway - Amazon Bedrock
Invoca con los agentes de Strands

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

AgentCore Gateway le permite exponer su base de conocimientos gestionada de Amazon Bedrock como una herramienta mediante el protocolo de contexto modelo (MCP). Después de agregar un objetivo de base de conocimientos a una puerta de enlace, cualquier MCP-compatible cliente puede consultar la base de conocimientos como una herramienta MCP estándar. El conector presenta dos herramientas:

  • AgenticRetrieveStream— una recuperación mediante una agencia de streaming de varios pasos que planifica, recupera de forma iterativa y devuelve 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 los 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 los valores predeterminados preconfigurados.

nota

Los destinos de Knowledge Base Gateway solo son compatibles con las bases de conocimiento administradas y solo con la autenticación IAM-based saliente (el tipo de proveedor de GATEWAY_IAM_ROLE credenciales).

Requisitos previos

  • Una base de conocimientos gestionada y su identificador de base de conocimientos.

  • Una AgentCore puerta de enlace y una función de servicio de puerta de enlace con permiso para recuperar datos de la base de conocimientos (bedrock:Retrieveen el ARN de la base de conocimientos).

Para obtener instrucciones completas, como crear el destino de la puerta de enlace con el AWS SDK o la AWS CLI, configurar la función del servicio de puerta de enlace y la política de confianza, controlar los parámetros de recuperación que puede establecer el agente, invocar las herramientas y los esquemas completos de entrada y respuesta, consulte Amazon Bedrock Managed Knowledge Bases as Connector Target en la guía para desarrolladores de Amazon Bedrock. AgentCore

Invoca con los agentes de Strands

Si ya tienes un agente creado con el SDK de Strands Agents y el kit de herramientas de AgentCore inicio, puedes conectarlo al destino de la puerta de enlace de tu 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:

  • Sustituir streamablehttp_client del mcp paquete por aws_iam_streamablehttp_client demcp-proxy-for-aws.

  • Configure el en endpoint la URL de su AgentCore puerta de enlace.

  • aws_service="bedrock-agentcore"Especifíquelo para la firma de 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 realizar ninguna configuración adicional.