View a markdown version of this page

Utiliser une AgentCore passerelle - Amazon Bedrock AgentCore

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utiliser une AgentCore passerelle

Après avoir configuré votre passerelle avec des cibles, vous pouvez configurer votre application ou votre agent pour utiliser la passerelle via le protocole MCP (Model Context Protocol). Le MCP fournit aux agents un moyen standardisé de découvrir et d'invoquer des outils.

Note

AgentCore Gateway prend en charge les versions MCP suivantes : 2026-07-28, 2025-11-25, 2025-06-18 et 2025-03-26.

La version 2026-07-28 est une révision de protocole sans état. Les clients ne se serrent pas la initialize main. Chaque demande contient sa version de protocole dans l'MCP-Protocol-Versionen-tête et dans le _meta champ (io.modelcontextprotocol/protocolVersion). La passerelle découvre les fonctionnalités viaserver/discover. La version 2025-11-25 et les versions antérieures continuent d'utiliser la initialize poignée de main.

Vous pouvez utiliser les opérations MCP suivantes avec une AgentCore passerelle :

Opération Description

tools/call

Invoque un outil spécifique avec les arguments fournis

tools/list

Répertorie tous les outils disponibles fournis par la passerelle

prompts/list

Répertorie toutes les invites disponibles fournies par la passerelle

prompts/get

Récupère un modèle d'invite spécifique, rendu avec les arguments fournis

resources/list

Répertorie toutes les ressources disponibles fournies par la passerelle

resources/read

Lit le contenu d'une ressource spécifique par URI

resources/templates/liste

Répertorie tous les modèles de ressources disponibles fournis par la passerelle

elicitation/create

Demande des informations supplémentaires au client lors d'un appel à l'outil (initié par le serveur)

sampling/createMessage

Demande une complétion LLM au client lors d'un appel à l'outil (initié par le serveur)

notifications/progress

Signale la progression des appels d'outils de longue durée (initiés par le serveur)

notifications/message

Envoie des messages de journal depuis le serveur pendant l'exécution de l'outil (initiée par le serveur)

Sur la version2026-07-28, les interactions initiées par le serveur (elicitation/createetsampling/createMessage) utilisent le modèle MRTR (multi-aller-retour requests) :

  1. Le serveur renvoie un résultat provisoire avec resultType défini surinput_required.

  2. Le client fournit l'entrée demandée lors d'une nouvelle tentative de la demande d'origine.

La passerelle envoie des notifications (notifications/progressetnotifications/message) uniquement pour les demandes qui les acceptent. Sur les versions 2025-11-25 et antérieures, la passerelle transmet ces interactions sous forme de messages initiés par le serveur sur le flux ouvert.

Les rubriques suivantes décrivent comment appeler votre AgentCore passerelle :

Rubriques