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
<a name="kb-gateway-target"></a>

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:Retrieve`sull'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 ](bedrock-agentcore/latest/devguide/gateway-target-connector-managed-kb.html) nella * Amazon Bedrock AgentCore Developer Guide*.

## Invoca con Strands Agents
<a name="kb-gateway-target-invoke-strands"></a>

Se disponi di un agente esistente creato con [ Strands Agents SDK ](https://strandsagents.com/latest/) e il toolkit [ AgentCore iniziale](bedrock-agentcore/latest/devguide/runtime-get-started-toolkit.html), 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` from`mcp-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.