View a markdown version of this page

Connect alla tua knowledge base tramite AgentCore Gateway - Amazon Bedrock
Richiama con Strands Agents

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connect alla tua knowledge base tramite AgentCore Gateway

AgentCore Gateway ti consente di esporre la tua knowledge base gestita da Amazon Bedrock come strumento utilizzando il Model Context Protocol (MCP). Dopo aver aggiunto un target della knowledge base a un gateway, qualsiasi MCP-compatible cliente può interrogare la knowledge base come strumento MCP standard. Il connettore espone due strumenti:

  • AgenticRetrieveStream— un processo di recupero tramite agente in streaming in più fasi che pianifica, recupera in modo iterativo e restituisce i risultati e una risposta opzionale sintetizzata e supportata da citazioni.

  • Retrieve— una singola ricerca che restituisce i passaggi più pertinenti con riferimenti alle fonti.

Il gateway funge da intermediario che gestisce l'autenticazione, l'inserimento di parametri e la sottoimpostazione dello schema. In qualità di amministratore, colleghi la knowledge base e controlli quali parametri sono esposti all'agente chiamante e quali sono nascosti con impostazioni preconfigurate.

Nota

Gli obiettivi del gateway della Knowledge Base sono supportati solo per le knowledge base gestite e solo con l'autenticazione in IAM-based uscita (il GATEWAY_IAM_ROLE tipo di provider di credenziali).

Prerequisiti

  • Una knowledge base gestita e il relativo ID.

  • Un AgentCore gateway e un ruolo di servizio gateway con autorizzazione a recuperare dalla knowledge base (bedrock:Retrievesulla knowledge base ARN).

Per istruzioni complete, tra cui la creazione del target del gateway con l' AWS SDK o la AWS CLI, la configurazione del ruolo del servizio gateway e della policy di fiducia, il controllo dei parametri di recupero che l'agente può impostare, il richiamo degli strumenti e gli schemi completi di input e risposta, consulta Amazon Bedrock Managed Knowledge Bases as Connector Target nella Amazon Bedrock Developer Guide. AgentCore

Richiama con Strands Agents

Se disponi di un agente esistente creato con Strands Agents SDK e lo AgentCorestarter toolkit, puoi collegarlo alla destinazione del gateway della Knowledge Base impostando il client MCP per utilizzare l'autenticazione SigV4 sull'endpoint del gateway.

Installare il pacchetto mcp-proxy-for-aws:

pip install mcp-proxy-for-aws

Quindi aggiorna il tuo client MCP in modo che punti all'URL del gateway con l'autenticazione 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",
    ))

Le principali modifiche rispetto alla configurazione standard di un client MCP sono:

  • Sostituire streamablehttp_client dal mcp pacchetto con aws_iam_streamablehttp_client frommcp-proxy-for-aws.

  • Imposta endpoint l'URL del tuo AgentCore gateway.

  • Specificare aws_service="bedrock-agentcore" per la firma SigV4.

Una volta connessi, gli strumenti della knowledge base vengono rilevati automaticamente tools/list e resi disponibili all'agente senza configurazioni aggiuntive.