View a markdown version of this page

Connectez-vous à votre base de connaissances via AgentCore Gateway - Amazon Bedrock
Invoquez avec Strands Agents

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 d'exposer votre base de connaissances gérée par Amazon Bedrock sous forme d'outil utilisant le protocole MCP (Model Context Protocol). Après avoir 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 streaming en plusieurs étapes qui planifie, extrait de manière itérative et diffuse les résultats, ainsi qu'une réponse optionnelle synthétisée basée sur des citations.

  • Retrieve— une recherche unique qui renvoie les passages les plus pertinents avec des références aux sources.

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 déterminez quels paramètres sont exposés à l'agent appelant et lesquels sont masqués par des paramètres par défaut préconfigurés.

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 (le type de fournisseur GATEWAY_IAM_ROLE d'informations d'identification).

Conditions préalables

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

  • Rôle de AgentCore passerelle et de service de passerelle autorisé à effectuer des recherches dans 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 d'entrée et de réponse complets, consultez les bases de connaissances gérées par Amazon Bedrock en tant que cible de connecteur dans le guide du développeur Amazon Bedrock. AgentCore

Invoquez avec Strands Agents

Si vous possédez déjà un agent créé à l'aide du SDK Strands Agents et du kit de AgentCore démarrage, vous pouvez le connecter à la cible de votre passerelle de base de connaissances en basculant 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 le contenu streamablehttp_client de l'mcpemballage par aws_iam_streamablehttp_client dumcp-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és, les outils de la base de connaissances sont découverts automatiquement par l'agent tools/list et mis à disposition de celui-ci sans configuration supplémentaire.