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à.
# Amazon Bedrock AgentCore Gateway
Questo documento fornisce informazioni per Marketplace AWS i venditori che desiderano pubblicare prodotti o strumenti per agenti AI basati su API che possono essere integrati con Amazon Bedrock Gateway. AgentCore
**Topics**
+ [Panoramica di](#agentcore-overview)
+ [Integrazione con AgentCore Bedrock Gateway](#bedrock-agentcore-integration)
## Panoramica di
Amazon Bedrock AgentCore Gateway aiuta gli sviluppatori a creare, implementare, scoprire e connettersi a strumenti su larga scala. Il servizio consente di:
+ Convert APIs, funzioni Lambda e servizi esistenti in strumenti compatibili con Model Context Protocol (MCP)
+ Rendi disponibili gli strumenti agli agenti tramite gli endpoint Gateway
+ Utilizza l'autenticazione completa in ingresso e in uscita in un servizio completamente gestito
Gli agenti di intelligenza artificiale utilizzano questi strumenti per eseguire attività come:
+ Interrogazione dei database
+ Invio di messaggi
+ Analisi dei documenti
Per ulteriori informazioni, consulta la [Amazon Bedrock AgentCore Developer Guide](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html).
## Integrazione con AgentCore Bedrock Gateway
Puoi abilitare l'integrazione di Amazon Bedrock AgentCore Gateway per i tuoi prodotti agente AI basati su API SaaS in uno dei seguenti modi, a seconda del prodotto:
+ Se offri un server MCP che supporta OAuth l'autenticazione a due gambe, puoi scegliere di offrire ai tuoi acquirenti l'integrazione senza requisiti aggiuntivi. Per l'integrazione verrà utilizzato l'endpoint del server MCP fornito come parte del processo di inserzione. Tuttavia, è necessario assicurarsi che il server MCP soddisfi i requisiti elencati di seguito. Per ulteriori informazioni, consulta Destinazioni dei [server MCP](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-target-MCPservers.html).
+ Per tutti gli altri agenti o strumenti, puoi fornire una specifica OpenAPI per abilitare l'integrazione.
### Requisiti del server MCP
Il server MCP deve soddisfare i seguenti requisiti:
+ OAuth Autenticazione a due gambe con una delle seguenti configurazioni:
+ ID client, segreto del cliente e URL di rilevamento
+ ID client, segreto del cliente, emittente, endpoint di autorizzazione ed endpoint del token.
+ Il server MCP deve disporre delle funzionalità dello strumento.
+ **Versioni del protocollo MCP supportate: **2025-06-18 e 2025-03-26**.**
+ Per l'URL o l'endpoint fornito del server, l'URL deve essere codificato. Il Gateway utilizza lo stesso URL per richiamare il server.
### Requisiti delle specifiche OpenAPI
La tua specifica OpenAPI deve:
+ Includi `operationId` campi per tutte le operazioni
+ Sii libero da errori semantici
+ Includi un URL endpoint sicuro (https) valido nell'attributo server
La tabella seguente mostra le funzionalità OpenAPI supportate e non supportate:
| Categoria | Supportata | Non supportato |
| --- | --- | --- |
| Versione | 3.0 e 3.1 | 2 |
| Definizioni dello schema | Tipi di dati di base (stringa, numero, booleano, ecc.) | Una delle specifiche |
| | Convalida del campo richiesta | Specifiche AnyOf |
| | Oggetti annidati | |
| | Matrici con specifiche dell'articolo | |
| | Metodi HTTP standard | |
| Tipi di file multimediali | application/json | Tipi di file multimediali personalizzati |
| | application/xml | Tipi di supporti binari |
| | dati multiparti/di moduli | |
| | x-www-form-urlencoded | |
| Parameters | Parametri di percorso semplici e parametri di query di base come i tipi string/number/boolean | Serializzazione dei parametri di percorso complessi |
| | | Matrici di parametri di interrogazione complessi |
| | | Serializzazione dei parametri di intestazione |
| | | Serializzazione dei parametri dei cookie |
| Richiesta e risposta | Corpi JSON | |
| | corpi XML | |
| | Codici di stato HTTP standard | |
| Convalida | Convalida di base dei campi | Validazione del modello Regex |
| | | Validazione del valore min/max |
| Sicurezza | N/D | Schemi di sicurezza a livello di specifica |
| | | Schemi di sicurezza multipli |
| | | OAuth 2.0 a livello di specifiche |
| | | Chiave API a livello di specifica |
| | | Autenticazione HTTP Basic a livello di specifica |
| Configurazione del server | URL di base | |
| | URL con segnaposti | |
### Abilitazione di Bedrock Gateway AgentCore
Prima di abilitare l'integrazione con Gateway, verifica le specifiche OpenAPI o il server MCP con Amazon Bedrock AgentCore Gateway completando queste attività:
+ [Crea un gateway](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building.html)
+ [Allega un bersaglio](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-adding-targets.html)
+ [Metti alla prova il tuo gateway](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway-building-testing.html)
**Per abilitare l'integrazione con Gateway**
1. Accedere al [portale Marketplace AWS di gestione](https://aws.amazon.com/marketplace/management).
1. Apri la pagina [degli agenti e degli strumenti di intelligenza artificiale](https://aws.amazon.com/marketplace/management/products/aiagents).
1. Nella scheda **Prodotti per agenti e strumenti AI**, seleziona il prodotto da modificare.
1. Dall'elenco a discesa **Richiedi modifiche**, seleziona **Aggiorna le opzioni di evasione ordini**.
1. Scegli **lo strumento Abilita per l' AgentCore integrazione con Amazon Bedrock**.
1. Carica le tue specifiche OpenAPI. Per i prodotti MCP Server OAuth abilitati a due gambe questo non è necessario ed è richiesto solo l'endpoint MCP.
1. Seleziona **Invia**.
**Dopo l'invio, lo stato della richiesta appare come **In fase di revisione** nella scheda Richieste.** Al termine dell'elaborazione, lo stato passa a **Riuscito**.