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.
# Répertorier les produits d'agent Container-based AI
## Gestion des agents et des outils d'IA basés sur des conteneurs
Container-based Les agents et outils d'IA exécutés sur Amazon Bedrock AgentCore Runtime peuvent être gérés via la page unifiée des produits **des agents et outils d'IA** ou la page des produits **du serveur** dans l'AWS Marketplace Management Console. Seuls les produits dont les versions prennent en charge Amazon Bedrock AgentCore Runtime seront visibles sur la page produit **des agents et outils d'IA**.
## Lancez l'assistant de mise en vente
1. Connectez-vous à [AWS Partner Central](https://aws.amazon.com/marketplace/management/homepage/) avec votre compte vendeur AWS.
1. Sélectionnez **Construire**, puis sélectionnez **AI Agents and Tools** dans la barre de navigation.
1. Sélectionnez le menu du **produit Create AI Agents and Tools**, puis choisissez **Container-based AI Agents & tools**.
1. Sélectionnez **Générer l'identifiant du produit et le code du produit**.
1. (Facultatif) Ajoutez des balises pour prendre en charge l'autorisation basée sur les balises.
1. Sélectionnez **Continuer**.
## Étape 1 : Fournir des informations sur le produit
1. Dans **Informations sur le produit**, entrez :
+ **Titre du produit**
+ **URL S3 du logo du produit**
+ **Brève description**
+ **Description longue**
+ **Surligner (1-3)**
1. Entrez les détails de l'assistance et ajoutez des ressources d'apprentissage facultatives en choisissant Ajouter une ressource.
1. Dans le menu **Catégories de produits**, choisissez 1 à 3 catégories. Nous vous recommandons de choisir au moins une catégorie parmi les catégories commerciales **AI Agents & Tools**.
1. Entrez des mots clés pour améliorer la visibilité des recherches.
1. (Facultatif) Ajoutez des vidéos et des images conformément aux directives.
1. Choisissez **Suivant**.
## Étape 2 : Configuration de la tarification d'AI Agent Container
1. Choisissez le modèle de tarification.
**AgentCore limites de prix**
Si l'image du conteneur est utilisée AgentCore, les modèles de tarification **horaire** et **d'utilisation avec contrat à long terme** ne sont pas pris en charge. Pour en savoir plus sur la tarification des contrats, voir[Tarification contractuelle pour les produits en conteneur avec AWS License Manager](container-license-manager-integration.md). Pour en savoir plus sur le comptage personnalisé pour une tarification basée sur l'utilisation, voir. [Configuration du comptage personnalisé pour les produits conteneurisés avec AWS Marketplace Metering Service](container-metering-meterusage.md)
1. Sélectionnez **Suivant**.
1. Dans **Fixer les prix**.
1. Sélectionnez **Suivant**.
## Étape 3 : Spécifiez la politique de remboursement
1. Entrez une politique de remboursement.
1. Sélectionnez **Suivant**.
**Note**
Si vous avez choisi le modèle de tarification des produits gratuits, vous n'avez pas à saisir de politique de remboursement.
## Étape 4 : Configuration du CLUF
1. Choisissez un **contrat standard AWS Marketplace** ou un **EULA personnalisé**.
**Note**
Si vous choisissez le CLUF personnalisé, entrez l'URL du contrat de licence de l'utilisateur final.
1. Sélectionnez **Suivant**.
## Étape 5 : ajouter des référentiels
1. Ajoutez un référentiel initial pour votre produit en conteneur.
**Note**
Les noms des référentiels doivent être uniques pour tous les produits de votre compte vendeur. Vous pouvez créer jusqu'à 50 référentiels par produit.
1. Sélectionnez **Suivant**.
## Étape 6 : Configuration de la disponibilité de l'offre/liste d'autorisations
1. Dans **Configurer la disponibilité de l'offre**, choisissez vos paramètres de disponibilité géographique.
1. Sélectionnez **Suivant**.
1. Dans **Configurer la liste d'autorisation**, listez tous les comptes AWS qui devraient avoir accès à la liste lorsqu'ils sont dans l'état limité.
1. Sélectionnez **Soumettre** pour créer une nouvelle demande de modification pour des tests de visibilité limitée.
Attendez 10 à 15 minutes jusqu'à ce que le statut de votre demande passe à l'état *Réussite*.
## Étape 7 : télécharger les images et les artefacts du conteneur dans le référentiel
**Note**
Découvrez [Amazon Bedrock AgentCore Runtime pour AWS Marketplace](bedrock-agentcore-runtime.md) comment intégrer AgentCore votre image de conteneur.
1. Localisez l'URL du référentiel ECR :
+ Ouvrez la page des produits de serveur dans AWS Partner Central.
+ Sélectionnez votre produit en conteneur pour afficher les détails.
+ Sélectionnez l'onglet Référentiels pour copier l'URL du référentiel.
1. Sélectionnez **Afficher les commandes push** pour ouvrir une liste d'instructions, y compris les commandes que vous pouvez utiliser pour transférer des images de conteneurs Docker et des graphiques Helm vers ce référentiel. Pour obtenir des informations générales sur la manière de transférer des images de conteneurs et d'autres artefacts vers des référentiels, consultez la section Transmission [d'une image](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html) dans le guide de l'utilisateur d'Amazon Elastic Container Registry.
**Note**
Vous pouvez utiliser les opérations d'API Amazon Elastic Container Registry (Amazon ECR) suivantes lorsque vous appelez docker pull ou docker push :
DescribeImages - Utilisez-le pour examiner les métadonnées relatives aux images d'un référentiel.
GetAuthorizationToken - Utilisez-le pour vous authentifier avant de télécharger des artefacts dans le référentiel, puis utilisez les commandes docker pull ou docker push.
ListImages - À utiliser pour afficher la liste des images que vous avez envoyées.
1. Utilisez les commandes répertoriées pour transférer les artefacts nécessaires de votre référentiel local vers le AWS Marketplace référentiel de votre produit.
**Note**
La balise que vous fournissez dans les commandes push est utilisée pour différencier la version de l'artefact que vous téléchargez dans le référentiel. Utilisez une balise adaptée à la version dont font partie les artefacts.
1. Répétez l'opération pour chaque image de conteneur ou artefact dont vous avez besoin dans votre version.
**Note**
Votre version peut inclure jusqu'à 50 images ou artefacts du conteneur dans chaque option de livraison. Reportez-vous à la procédure suivante pour plus d'informations sur les options de livraison.
1. Après avoir chargé vos artefacts, vous êtes prêt à créer la version de votre produit.
**Note**
Les images de vos conteneurs sont numérisées automatiquement pour voir si elles répondent aux[Exigences relatives aux produits basées sur les conteneurs pour AWS Marketplace](container-product-policies.md). Pour de plus amples informations, veuillez consulter [Analyses des produits en conteneur pour détecter des problèmes de sécurité](container-product-getting-started.md#container-security).
## Étape 8 : Ajouter une nouvelle version du produit avec des actifs
1. Ouvrez la page des produits **AI Agents and Tools** dans AWS Partner Central.
**Note**
Seuls les produits conteneurisés dont les versions prennent en charge Amazon Bedrock AgentCore Runtime sont visibles sur la page des produits **AI Agents and Tools**. Avant d'ajouter la première version, vous ne trouverez votre produit que sur la page des produits **du serveur** dans AWS Partner Central. Une fois que vous avez créé la version pour Amazon Bedrock AgentCore Runtime, vous trouverez votre produit conteneur sur la page des produits **AI Agents and Tools**.
1. Sélectionnez votre produit conteneur et cliquez sur le menu déroulant **Demander des modifications**, sélectionnez **Mettre à jour les versions**, puis **Ajouter une nouvelle version**.
1. Dans **Options de livraison**, saisissez :
+ **Nom de la version**
+ **Notes de mise à jour**
1. Sélectionnez **Ajouter une option de livraison**.
1. Pour **Mode de livraison**, sélectionnez **Image du conteneur** et complétez :
+ **Services pris en charge** : sélectionnez l'environnement dans lequel les acheteurs peuvent lancer le logiciel.
+ **Pour le AgentCore service **Bedrock**, sélectionnez **AI Agent, MCP Server ou A2A Server** dans le champ Type.**
+ **Image du conteneur** : *URL du référentiel* et *balise de version* que vous avez spécifiées précédemment.
+ **Titre de l'option de livraison** et **description de l'option de déploiement** : entrez le titre et la description de cette option de livraison.
+ **Instructions d'utilisation** : entrez des informations détaillées pour aider vos acheteurs à utiliser votre logiciel après son lancement.
+ **Variables d'environnement** : spécifiez les variables d'environnement que les acheteurs doivent fournir pour configurer le comportement d'exécution de l'agent. Ces variables peuvent être utilisées pour transmettre des paramètres, des informations d'identification ou des indicateurs personnalisés au conteneur au démarrage. Pour chaque variable, indiquez le nom attendu par votre conteneur, une description et une valeur par défaut facultative. Pour les variables telles que les informations d'identification ou les clés d'API qui sont uniques, ne fournissez pas de valeur par défaut. Vous pouvez utiliser la description pour spécifier les détails de la variable ainsi que les valeurs possibles. Toutes les variables fournies avec leurs valeurs par défaut seront préremplies lorsque les acheteurs lanceront votre produit.
1. Si vous avez sélectionné un **agent AI** ou un type d'outil de **serveur A2A**, vérifiez que votre agent utilise des LLM raisonnés et possède des capacités autonomes. Ces exigences permettent de garantir que les agents proposés sur AWS Marketplace répondent à des exigences de qualité élevées. Si votre agent ne répond pas aux deux exigences, choisissez un autre type d'outil.
1. Sélectionnez **Ajouter une version**.
Attendez et actualisez la page jusqu'à ce que le statut de la demande indique *Réussi*.
L'ajout d'une nouvelle version analyse automatiquement les images du conteneur pour détecter les vulnérabilités.
## Étape 9 : Révision de la liste des produits et publication auprès du public
1. Ouvrez la page des produits **AI Agent and Tools** dans AWS Partner Central.
1. Sélectionnez votre produit en conteneur dans la liste.
1. Sélectionnez **Afficher sur AWS Marketplace**.
1. Vérifiez l'exactitude de la page détaillée de votre produit. Assurez-vous que les instructions d'utilisation guident suffisamment l'acheteur dans les étapes nécessaires au lancement de votre produit.
1. Soumettre une demande de visibilité de mise à jour au public :
+ Sur la page **Produits du serveur**, sous l'onglet **Produit serveur actuel**, sélectionnez le produit basé sur un conteneur que vous souhaitez modifier. Dans le menu déroulant **Demander des modifications**, sélectionnez **Mettre à jour la visibilité**.
## Détails du déploiement des conteneurs
Le déploiement de conteneurs regroupe votre agent ou outil d'IA sous forme d'application conteneurisée que les clients peuvent exécuter dans leurs propres environnements AWS. Cette approche présente les avantages suivants :
+ Les données restent dans l'environnement du client
+ Configurations de déploiement personnalisables
+ Intégration prise en charge avec Bedrock AgentCore Runtime et l'infrastructure existante du client
Lorsque vous mettez en vente un agent conteneurisé, fournissez des instructions de déploiement claires, les besoins en ressources et les options de configuration pour garantir une mise en œuvre réussie par le client.
### Exigences techniques pour les conteneurs Bedrock AgentCore Runtime
**Note**
Pour plus d’informations, consultez [Amazon Bedrock AgentCore Runtime pour AWS Marketplace](bedrock-agentcore-runtime.md).
Lorsque vous créez des produits d'agent d'IA basés sur des conteneurs pour AWS Marketplace, respectez les exigences suivantes :
Configuration requise pour le serveur MCP
+ **Transport** : Stateless Streamable-http uniquement
+ **Gestion des sessions : la** plateforme ajoute automatiquement un `Mcp-Session-Id` en-tête pour l'isolation des sessions
+ **Animateur** : Container doit écouter `0.0.0.0`
+ **Port** : le conteneur doit exposer le port `8000` pour la communication avec le serveur MCP
+ **Chemin** : `/mcp` - Point de terminaison POST pour recevoir les messages MCP RPC. InvokeAgentRuntime car les serveurs MCP transmettront les requêtes vers ce chemin.
+ **Protocole** : Le serveur MCP doit prendre en charge le protocole MCP, y compris les messages de protocole « » et tools/list « tools/call » (pris en charge par un framework commun tel que FastMCP).
Exigences relatives à l'agent
+ **/ping** Endpoint : point de terminaison GET pour les contrôles de santé
+ **/invocations** Endpoint : point de terminaison POST pour les interactions avec les agents
+ **Docker Container** : package de déploiement conteneurisé ARM64
+ **Port** : le conteneur doit exposer le port `8080` pour la communication de HTTP-based l'agent
+ Aucune information d'identification codée en dur
+ Exempt de vulnérabilités et d'expositions courantes (CVE)
Configuration requise pour le serveur A2A
+ **Port** : les serveurs A2A fonctionnent sur le port 9000 (contre 8080 pour HTTP, 8000 pour MCP)
+ **Animateur** : Container doit écouter `0.0.0.0`
+ **Chemin** : les serveurs A2A sont montés sur `/` (par opposition `/invocations` à HTTP, `/mcp` à MCP)
+ **Cartes d'agent** : L'A2A fournit une fonction intégrée de découverte d'agents via des cartes d'agent sur `/.well-known/agent-card.json`
+ **Protocole** : Utilisations JSON-RPC pour la communication agent-agent
+ **Authentification** : prend en charge les schémas d'authentification Sigv4 et OAuth 2.0
Instructions d'utilisation
Assurez-vous que les instructions guident de manière approfondie les clients tout au long du lancement et de la configuration du produit. Reportez-vous à [Création d'instructions d'utilisation de l'AMI et du produit conteneur pour AWS Marketplace](ami-container-product-usage-instructions.md).
## Tests et validation
Avant de publier votre MCP-compatible agent ou outil auprès du public, testez minutieusement votre implémentation :
+ Vérifiez que les instructions d'utilisation fournissent les informations nécessaires au lancement et à la configuration du produit.
+ Tester les flux d'authentification et la gestion des erreurs
+ Valider les performances dans différentes conditions de charge
+ Garantir la compatibilité avec les clients MCP les plus populaires
+ Documenter toutes les exigences de configuration spécifiques au client
## Meilleures pratiques et recommandations
### Exigences en matière de documentation
Lorsque vous mettez en vente un Protocol-compatible agent ou un outil Model Context sur AWS Marketplace, incluez une documentation complète :
+ Descriptions détaillées des fonctionnalités et exemples
+ Instructions d'authentification et de configuration
+ Exemple de code pour les scénarios d'intégration courants
+ Guides de résolution des problèmes et référence d'erreur
+ Considérations relatives aux performances et meilleures pratiques
### Ressources supplémentaires
Pour plus d'informations sur la mise en œuvre du protocole Model Context dans votre agent ou outil d'IA, consultez les ressources suivantes :
+ [Documentation Amazon Bedrock AgentCore ](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html)
+ [Amazon Bedrock AgentCore Runtime pour AWS Marketplace](bedrock-agentcore-runtime.md)
+ [Exigences techniques relatives aux conteneurs](https://docs.aws.amazon.com/marketplace/latest/userguide/container-product-getting-started.html)