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
<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 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:Retrieve`sulla 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](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-connector-managed-kb.html) Developer Guide. AgentCore *

## Richiama 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 lo [AgentCorestarter toolkit](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-get-started-toolkit.html), 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` from`mcp-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.