View a markdown version of this page

Conéctese a su base de conocimientos a través de AgentCore Gateway - Amazon Bedrock
Invoque 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 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:Retrieveen 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 la guía para desarrolladores de Amazon Bedrock. AgentCore

Invoque con los agentes de Strands

Si ya tiene un agente creado con el SDK de Strands Agents y el AgentCorekit de herramientas inicial, 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_clientdemcp-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.