View a markdown version of this page

Connettiti alla tua knowledge base tramite AgentCore Gateway - Amazon Bedrock
Invoca 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à.

Connettiti 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 di 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 agente di streaming in più fasi che pianifica, recupera in modo iterativo e restituisce in streaming 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

Le destinazioni del gateway della Knowledge Base sono supportate 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 della knowledge base.

  • Un ruolo di AgentCore gateway e di servizio di gateway con autorizzazione per il recupero dalla knowledge base (bedrock:Retrievesull'ARN della knowledge base).

Per istruzioni complete, tra cui la creazione del gateway target 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 AgentCore Developer Guide.

Invoca con Strands Agents

Se disponi di un agente esistente creato con Strands Agents SDK e il toolkit AgentCore iniziale, puoi collegarlo al target del gateway della tua knowledge base impostando il client MCP in modo che utilizzi 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 a una configurazione standard del client MCP sono:

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

  • Imposta endpoint l'URL del tuo AgentCore Gateway.

  • Specifica aws_service="bedrock-agentcore" per la firma SIGv4.

Una volta connessi, gli strumenti della knowledge base vengono rilevati automaticamente tools/list e disponibili per l'agente senza ulteriori configurazioni.