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.
Ajouter une API REST API Gateway en tant que cible pour Amazon Bedrock AgentCore Gateway
Une AgentCore passerelle Amazon Bedrock fournit aux développeurs d'agents d'intelligence artificielle un moyen sécurisé d'exposer votre API Gateway REST en APIs tant qu'outils compatibles avec le Model Context Protocol (MCP). AgentCore Gateway utilise des cibles pour définir les outils. Lorsque vous ajoutez votre stage en tant que cible, votre passerelle devient une URL MCP unique qui permet à un agent d'accéder aux outils. Pour plus d'informations, consultez les étapes de l'API REST API Gateway en tant que cibles dans le manuel Amazon Bedrock AgentCore Gateway Developer Guide.
Les cibles d'API Gateway connectent votre AgentCore passerelle aux étapes de votre REST APIs. Vous pouvez inclure l'ensemble de l'étape en tant que cible ou sélectionner des ressources. Après avoir créé la cible API Gateway, AgentCore Gateway traduit les demandes MCP entrantes en requêtes HTTP et gère le formatage des réponses. Les clients MCP peuvent récupérer la documentation de l'API à l'aide de la tools/list méthode et l'invoquer APIs à l'aide de la tools/call méthode.
Considérations
Les considérations suivantes peuvent avoir un impact sur votre utilisation de l'ajout d'une étape en tant que cible à une AgentCore passerelle :
-
Vous devez déjà disposer d'une AgentCore passerelle.
-
Seul le REST public APIs est pris en charge.
-
Le point de terminaison par défaut de votre API ne peut pas être désactivé.
-
Chaque méthode de votre API doit soit avoir un nom d'opération défini, soit vous devez créer un remplacement de nom lorsque vous ajoutez votre étape en tant que cible. Ce nom est utilisé comme nom d'outil que les agents utilisent pour interagir avec votre méthode.
-
Vous pouvez utiliser
API_KEYNO_AUTH, ou des types de fournisseursGATEWAY_IAM_ROLEd'informations d'identification pour l'authentification sortante afin de permettre à votre passerelle d'accéder à votre API. Le fournisseurAPI_KEYd'informations d'identification est défini par AgentCore Gateway. Vous pouvez utiliser votre clé d'API API Gateway existante. Pour plus d'informations, consultez la section Configuration de l'authentification sortante. -
Si vous utilisez un groupe d'utilisateurs Amazon Cognito ou un autorisateur Lambda pour contrôler l'accès à votre API, les clients MCP ne peuvent pas y accéder.
-
Votre API doit se trouver dans le même compte et dans la même région que votre AgentCore passerelle.
Ajouter une étape d'une API en tant que cible pour une AgentCore passerelle
La procédure suivante montre comment ajouter une étape d'une API en tant que cible pour une AgentCore passerelle.
Pour ajouter une étape d'une API en tant que cible pour une AgentCore passerelle
Connectez-vous à la console API Gateway à l'adresse https://console.aws.amazon.com/apigateway.
Choisissez une API REST déployée sur une étape.
Dans le volet de navigation principal, choisissez Étapes.
-
Choisissez Stage actions, puis Create MCP target.
Pour AgentCore Gateway, sélectionnez une AgentCore Gateway.
Pour Nom de la cible, entrez un nom de cible.
Pour Description de la cible, entrez une description.
Conservez l'API et le stage fournis.
-
Pour Select API resources, sélectionnez les ressources de votre API auxquelles les agents utilisant votre AgentCore passerelle peuvent accéder.
Si vous ne sélectionnez aucune ressource, un agent ne peut pas consulter la documentation ni appeler le point de terminaison.
-
La combinaison de la ressource et de la méthode correspond aux opérations de l'outil. Si votre opération n'a pas de nom, créez un remplacement de nom.
Vous pouvez également définir un nom d'opération pour une méthode lorsque vous la créez.
Pour la configuration de l'authentification sortante, choisissez le rôle IAM, Aucune autorisation ou la clé API.
Sélectionnez Créer une cible.
Pour afficher toutes les AgentCore passerelles qui ont accès à votre compte APIs, choisissez la section cibles MCP dans le volet de navigation principal. Dans cette section, vous pouvez créer une cible MCP pour n'importe quelle API de votre région déployée sur une étape. Choisissez Create MCP target et suivez les étapes précédentes.
Vous pouvez également consulter les outils disponibles pour votre cible et modifier votre cible dans la console AgentCore Gateway. Pour plus d'informations, voir Ajouter des cibles à une AgentCore passerelle existante.
