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.
Passerelle Amazon Bedrock AgentCore
Ce document fournit des informations aux AWS Marketplace vendeurs qui souhaitent répertorier des produits ou des outils d'IA basés sur des API qui peuvent être intégrés à Amazon AgentCore Bedrock Gateway.
Présentation de
Amazon Bedrock AgentCore Gateway aide les développeurs à créer, déployer, découvrir et se connecter à des outils à grande échelle. Le service vous permet de :
-
Conversion APIs, fonctions Lambda et services existants en outils compatibles avec le Model Context Protocol (MCP)
-
Mettre les outils à la disposition des agents via les points de terminaison Gateway
-
Utilisez une authentification complète des entrées et des sorties dans un service entièrement géré
Les agents d'IA utilisent ces outils pour effectuer des tâches telles que :
-
Interrogation de bases de données
-
Envoi de messages
-
Analyse de documents
Pour plus d'informations, consultez le guide du AgentCore développeur Amazon Bedrock.
Intégration avec Bedrock Gateway AgentCore
Vous pouvez activer l'intégration d'Amazon Bedrock AgentCore Gateway pour vos produits d'agent d'intelligence artificielle basés sur une API SaaS de l'une des manières suivantes, en fonction de votre produit :
-
Si vous proposez un serveur MCP qui prend en charge l' OAuth authentification à deux pattes, vous pouvez choisir de proposer l'intégration à vos acheteurs sans exigences supplémentaires. Le point de terminaison du serveur MCP que vous fournissez dans le cadre de votre processus de mise en vente sera utilisé pour l'intégration. Cependant, vous devez vous assurer que votre serveur MCP répond aux exigences répertoriées ci-dessous. Pour plus d'informations, consultez la section Cibles des serveurs MCP.
Pour tous les autres agents ou outils, vous pouvez fournir une spécification OpenAPI pour permettre l'intégration.
Configuration requise pour le serveur MCP
Votre serveur MCP doit répondre aux exigences suivantes :
-
OAuth Authentification en deux étapes avec l'une des configurations suivantes :
-
ID client, secret client et URL de découverte
-
identifiant du client, secret client, émetteur, point de terminaison d'autorisation et point de terminaison du jeton.
-
-
Le serveur MCP doit disposer de fonctionnalités d'outil.
-
Versions du protocole MCP prises en charge : 2025-06-18 et 2025-03-26.
-
Pour l'URL ou le point de terminaison du serveur fourni, l'URL doit être codée. La passerelle utilise la même URL pour appeler le serveur.
Exigences relatives à la spécification OpenAPI
Votre spécification OpenAPI doit :
-
Inclure
operationIddes champs pour toutes les opérations -
Libérez-vous des erreurs sémantiques
-
Incluez une URL de point de terminaison sécurisée (https) valide dans l'attribut du serveur
Le tableau suivant indique les fonctionnalités OpenAPI prises en charge et non prises en charge :
| Catégorie | Pris en charge | Non pris en charge |
|---|---|---|
| Version | 3.0 et 3.1 | 2 |
| Définitions de schéma | Types de données de base (chaîne, nombre, booléen, etc.) | Spécifications OneOf |
| Validation des champs obligatoires | Toutes les spécifications | |
| Objets imbriqués | ||
| Tableaux avec spécifications des articles | ||
| Méthodes HTTP standard | ||
| Types de médias | application/json | Types de médias personnalisés |
| application/xml | Types de supports binaires | |
| données multipart/formulaire | ||
| x-www-form-urlencoded | ||
| Parameters | Paramètres de chemin simples et paramètres de requête de base tels que les string/number/boolean types | Sérialisation complexe des paramètres de chemin |
| Tableaux de paramètres de requête complexes | ||
| Sérialisation des paramètres d'en-tête | ||
| Sérialisation des paramètres des cookies | ||
| Demande et réponse | corps JSON | |
| Corps XML | ||
| Codes d'état HTTP standard | ||
| Validation | Validation de base des champs | Validation du modèle Regex |
| Validation des valeurs min/max | ||
| Sécurité | N/A | Schémas de sécurité au niveau des spécifications |
| Schémas de sécurité multiples | ||
| OAuth 2.0 au niveau des spécifications | ||
| Clé d'API au niveau des spécifications | ||
| Authentification HTTP Basic au niveau des spécifications | ||
| Configuration du serveur DNS | URL de base | |
| URL avec espaces réservés |
Activer Bedrock Gateway AgentCore
Avant d'activer l'intégration de Gateway, testez votre spécification OpenAPI ou votre serveur MCP avec Amazon Bedrock AgentCore Gateway en effectuant les tâches suivantes :
Pour activer l'intégration de Gateway
-
Connectez-vous au portail de AWS Marketplace gestion
. -
Ouvrez la page des agents et outils d'IA
. -
Dans l'onglet Produits des agents et outils AI, sélectionnez le produit à modifier.
-
Dans la liste déroulante Demander des modifications, sélectionnez Mettre à jour les options de traitement.
-
Choisissez l'outil Activer pour l' AgentCore intégration d'Amazon Bedrock.
-
Téléchargez votre spécification OpenAPI. Pour les produits de serveur MCP à deux pattes OAuth , cela n'est pas obligatoire et seul le point de terminaison MCP est requis.
-
Sélectionnez Soumettre.
Une fois que vous l'avez soumise, le statut de la demande apparaît comme En cours de révision dans l'onglet Demandes. Lorsque le traitement est terminé, le statut passe à Successed.
