View a markdown version of this page

Usa un AgentCore gateway - Fondamento Amazon AgentCore

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à.

Usa un AgentCore gateway

Dopo aver configurato il gateway con gli obiettivi, è possibile configurare l'applicazione o l'agente per utilizzare il gateway tramite il Model Context Protocol (MCP). L'MCP fornisce agli agenti un modo standardizzato per scoprire e richiamare gli strumenti.

Nota

AgentCore Gateway supporta le seguenti versioni MCP: 2026-07-28, 2025-11-25, 2025-06-18 e 2025-03-26.

2026-07-28La versione è una revisione del protocollo senza stato. I client non eseguono una initialize stretta di mano. Ogni richiesta riporta la versione del protocollo nell'MCP-Protocol-Versionintestazione e nel _meta campo ()io.modelcontextprotocol/protocolVersion. Il gateway scopre le funzionalità tramite. server/discover Le versioni precedenti 2025-11-25 e precedenti continuano a utilizzare l'initializehandshake.

È possibile utilizzare le seguenti operazioni MCP con un AgentCore gateway:

Operation Description

tools/call

Richiama uno strumento specifico con gli argomenti forniti

tools/list

Elenca tutti gli strumenti disponibili forniti dal gateway

prompts/list

Elenca tutti i prompt disponibili forniti dal gateway

prompts/get

Recupera un modello di prompt specifico, renderizzato con gli argomenti forniti

resources/list

Elenca tutte le risorse disponibili fornite dal gateway

resources/read

Legge il contenuto di una risorsa specifica tramite URI

resources/templates/list

Elenca tutti i modelli di risorse disponibili forniti dal gateway

elicitation/create

Richiede input aggiuntivi dal client durante una chiamata allo strumento (avviata dal server)

sampling/createMessage

Richiede il completamento di un LLM dal client durante una chiamata allo strumento (avviata dal server)

notifications/progress

Segnala l'avanzamento delle chiamate allo strumento di lunga durata (avviate dal server)

notifications/message

Invia messaggi di registro dal server durante l'esecuzione dello strumento (avviato dal server)

Nella versione2026-07-28, le interazioni avviate dal server (elicitation/createesampling/createMessage) utilizzano il modello MRTR (Multi Round-Trip Requests):

  1. Il server restituisce un risultato provvisorio con set to. resultType input_required

  2. Il client fornisce l'input richiesto in caso di nuovo tentativo della richiesta originale.

Il gateway invia notifiche (notifications/progressenotifications/message) solo per le richieste che le accettano. Nella versione precedente 2025-11-25 e nelle versioni precedenti, il gateway fornisce queste interazioni come messaggi avviati dal server sullo stream aperto.

I seguenti argomenti descrivono come richiamare il gateway: AgentCore