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
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.
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.
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
operationIdcampi 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à:
Per abilitare l'integrazione con Gateway
-
Accedere al portale Marketplace AWS di gestione
. -
Apri la pagina degli agenti e degli strumenti di intelligenza artificiale
. -
Nella scheda Prodotti per agenti e strumenti AI, seleziona il prodotto da modificare.
-
Dall'elenco a discesa Richiedi modifiche, seleziona Aggiorna le opzioni di evasione ordini.
-
Scegli lo strumento Abilita per l' AgentCore integrazione con Amazon Bedrock.
-
Carica le tue specifiche OpenAPI. Per i prodotti MCP Server OAuth abilitati a due gambe questo non è necessario ed è richiesto solo l'endpoint MCP.
-
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.
