View a markdown version of this page

Connectez-vous à votre base de connaissances via AgentCore Gateway - Amazon Bedrock
Invoquer avec des agents Strands

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connectez-vous à votre base de connaissances via AgentCore Gateway

AgentCore Gateway vous permet de présenter votre base de connaissances gérée par Amazon Bedrock sous la forme d'un outil utilisant le Model Context Protocol (MCP). Une fois que vous avez ajouté une cible de base de connaissances à une passerelle, n'importe quel MCP-compatible client peut interroger la base de connaissances en tant qu'outil MCP standard. Le connecteur expose deux outils :

  • AgenticRetrieveStream— une extraction agentique en continu en plusieurs étapes qui planifie, récupère de manière itérative et diffuse les résultats et une réponse facultative synthétisée et appuyée par des citations.

  • Retrieve— une recherche unique qui renvoie les passages les plus pertinents avec des références à la source.

La passerelle agit comme un intermédiaire qui gère l'authentification, l'injection de paramètres et le sous-réglage du schéma. En tant qu'administrateur, vous liez la base de connaissances et vous contrôlez les paramètres qui sont exposés à l'agent appelant et ceux qui sont masqués par des valeurs par défaut préconfigurées.

Note

Les cibles de passerelle de base de connaissances ne sont prises en charge que pour les bases de connaissances gérées, et uniquement avec l'authentification IAM-based sortante (type de fournisseur GATEWAY_IAM_ROLE d'informations d'identification).

Conditions préalables

  • Une base de connaissances gérée et son identifiant de base de connaissances.

  • Une AgentCore passerelle et un rôle de service de passerelle autorisés à effectuer des recherches depuis la base de connaissances (bedrock:Retrievesur l'ARN de la base de connaissances).

Pour obtenir des instructions complètes, notamment la création de la cible de passerelle à l'aide du AWS SDK ou de la AWS CLI, la configuration du rôle du service de passerelle et de la politique de confiance, le contrôle des paramètres de récupération que l'agent peut définir, l'appel des outils et les schémas complets d'entrée et de réponse, consultez Amazon Bedrock Managed Knowledge Bases as as Connector Target dans le Amazon Bedrock Developer Guide. AgentCore

Invoquer avec des agents Strands

Si vous possédez déjà un agent créé avec le SDK Strands Agents et la boîte à outils de AgentCore démarrage, vous pouvez le connecter à la cible de passerelle de votre base de connaissances en faisant basculer le client MCP pour qu'il utilise l'authentification Sigv4 sur le point de terminaison de la passerelle.

Installez le package mcp-proxy-for-aws :

pip install mcp-proxy-for-aws

Mettez ensuite à jour votre client MCP pour qu'il pointe vers l'URL de la passerelle avec authentification 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",
    ))

Les principaux changements par rapport à la configuration standard d'un client MCP sont les suivants :

  • Remplacez « streamablehttp_client depuis l'mcpemballage » par « aws_iam_streamablehttp_client from mcp-proxy-for-aws ».

  • Définissez l'URL endpoint de votre AgentCore passerelle.

  • Spécifiez aws_service="bedrock-agentcore" pour la signature Sigv4.

Une fois connecté, les outils de la base de connaissances sont découverts automatiquement par l'agent tools/list et mis à sa disposition sans configuration supplémentaire.