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à.
Aggiungi un'API API Gateway REST come destinazione per Amazon Bedrock AgentCore Gateway
Un Amazon Bedrock AgentCore Gateway offre agli sviluppatori di agenti AI un modo sicuro per esporre il tuo API Gateway REST APIs come strumenti compatibili con il Model Context Protocol (MCP). AgentCore Gateway utilizza obiettivi per definire gli strumenti. Quando aggiungi la tua fase come destinazione, il tuo Gateway diventa un singolo URL MCP che consente l'accesso agli strumenti per un agente. Per ulteriori informazioni, consulta le fasi dell'API REST di API Gateway come obiettivi nella Amazon Bedrock AgentCore Gateway Developer Guide.
Gli obiettivi API Gateway collegano il AgentCore gateway alle fasi del REST APIs. Puoi includere l'intera fase come obiettivo o selezionare risorse. Dopo aver creato l'oggetto API Gateway, AgentCore Gateway traduce le richieste MCP in entrata in richieste HTTP e gestisce la formattazione della risposta. I client MCP possono recuperare la documentazione dell'API utilizzando il metodo e richiamarla utilizzando il tools/list metodo. APIs tools/call
Considerazioni
Le seguenti considerazioni potrebbero influire sull'utilizzo dell'aggiunta di una fase come destinazione a un Gateway: AgentCore
-
È necessario disporre già di un AgentCore Gateway.
-
Sono supportati solo APIs i REST pubblici.
-
L'endpoint predefinito dell'API non può essere disabilitato.
-
Per ogni metodo dell'API deve essere definito un nome di operazione oppure è necessario creare un nome sostitutivo quando si aggiunge lo stage come destinazione. Questo nome viene utilizzato come nome dello strumento utilizzato dagli agenti per interagire con il metodo.
-
È possibile utilizzare
API_KEYtipi di provider diGATEWAY_IAM_ROLEcredenziali per Outbound Auth per consentire al gateway di accedere all'API.NO_AUTHIl provider diAPI_KEYcredenziali è definito da Gateway. AgentCore Puoi utilizzare la tua chiave API Gateway esistente. Per ulteriori informazioni, consulta Configurazione dell'autenticazione in uscita. -
Se utilizzi un pool di utenti Amazon Cognito o un autorizzatore Lambda per controllare l'accesso alla tua API, i client MCP non possono accedervi.
-
L'API deve trovarsi nello stesso account e nella stessa regione del gateway. AgentCore
Aggiungi una fase di un'API come destinazione per un AgentCore gateway
La procedura seguente mostra come aggiungere una fase di un'API come destinazione per un AgentCore Gateway.
Per aggiungere una fase di un'API come destinazione per un AgentCore Gateway
Accedi alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.
Scegli un'API REST distribuita in una fase.
Nel riquadro di navigazione principale scegli Fasi.
-
Scegli Stage actions, quindi scegli Create MCP target.
Per AgentCore Gateway, selezionate un AgentCore Gateway.
Per Nome destinazione, inserisci un nome di destinazione.
Per Descrizione dell'oggetto, inserisci una descrizione.
Conserva l'API e lo stage forniti.
-
Per le risorse Select API, seleziona le risorse della tua API a cui possono accedere gli agenti che utilizzano il tuo AgentCore Gateway.
Se non selezioni una risorsa, un agente non può visualizzare la documentazione o richiamare l'endpoint.
-
La combinazione della risorsa e del metodo sono le operazioni dello strumento. Se l'operazione non ha un nome, crea un nome override.
È inoltre possibile definire un nome di operazione per un metodo al momento della creazione.
Per la configurazione di autenticazione in uscita, scegli IAM Role, Nessuna autorizzazione o API key.
Seleziona Crea destinazione.
Per visualizzare tutti i AgentCore gateway che hanno accesso al tuo APIs, scegli la sezione MCP targets nel pannello di navigazione principale. In questa sezione, puoi creare un target MCP per qualsiasi API nella tua regione distribuita in una fase. Scegli Crea obiettivo MCP e segui i passaggi precedenti.
Puoi anche visualizzare gli strumenti disponibili per il tuo target e modificarlo nella console AgentCore Gateway. Per ulteriori informazioni, consulta Aggiungere obiettivi a un AgentCore gateway esistente.
