View a markdown version of this page

Commencez avec AWS Registre des agents - Base rocheuse de l'Amazonie AgentCore
Conditions préalablesÉtape 1 : Création d'un registreÉtape 2 : Ajouter un enregistrement de registreÉtape 3 : Soumettre l'enregistrement pour approbationÉtape 4 : Approuver l'enregistrementÉtape 5 : Découvrez les enregistrements approuvésCe que tu as construitÉtapes suivantes

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.

Commencez avec AWS Registre des agents

La migration est désormais ouverte

AWS Le registre des agents a été lancé sous le nouvel agent-registry espace de noms. La prise en charge de l'bedrock-agentcoreespace de noms de version préliminaire publique sera interrompue le 17 septembre 2026. Pour obtenir des instructions de migration, consultez le guide complet de migration du registre.

Dans ce guide, vous allez créer votre premier registre, ajouter un enregistrement, l'approuver et le rechercher.

Conditions préalables

Suivez les étapes décrites dans Prérequis.

Étape 1 : Création d'un registre

Créez un registre avec autorisation IAM et approbation manuelle.

Console

Création d'un registre avec IAM-based autorisation

Exemple
AWS Agent Registry namespace

  1. Ouvrez la console du registre des AWS agents.

  2. Dans le volet de navigation, choisissez Registry.

  3. Dans la section Registres, choisissez Créer un registre.

  4. Dans la section Détails du registre, dans Nom, entrez un nom pour votre registre. Le nom doit commencer par un caractère alphanumérique. Les caractères valides sont les suivants : a—z, A—Z, 0—9, _ (trait de soulignement), - (tiret), (point) et . (barre oblique). / Le nom peut comporter jusqu'à 64 caractères.

  5. (Facultatif) Choisissez Détails supplémentaires pour développer la section, puis dans Description, entrez une description permettant d'identifier ce registre.

  6. Dans la section Discovery Authorization, pour le type d'authentification, choisissez Utiliser l'autorisation IAM (autorisation entrante).

  7. Dans la section Approbation des enregistrements, activez ou désactivez Auto-approval  :

    • Lorsque Auto-approval cette option est activée, lorsque vous soumettez un enregistrement pour approbation, l'enregistrement passe directement au statut Approuvé et devient visible dans les résultats de recherche peu de temps après.

    • Lorsque Auto-approval cette option est désactivée, lorsque vous soumettez un enregistrement pour approbation, celui-ci passe au statut En attente d'approbation et nécessite qu'un conservateur l'examine et l'approuve avant sa publication.

  8. (Facultatif) Dans la section Balises, choisissez Ajouter une nouvelle étiquette pour associer une ou plusieurs balises au registre. Chaque étiquette possède une clé et une valeur facultative.

  9. Choisissez Créer un registre.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Ouvrez la page Registre des AWS agents dans la Bedrock-AgentCore console.

  2. Dans le volet de navigation, choisissez Registry.

  3. Dans la section Registres, choisissez Créer un registre.

  4. Dans la section Détails du registre, dans Nom, entrez un nom pour votre registre. Le nom doit commencer par un caractère alphanumérique. Les caractères valides sont les suivants : a—z, A—Z, 0—9, _ (trait de soulignement), - (tiret), (point) et . (barre oblique). / Le nom peut comporter jusqu'à 64 caractères.

  5. (Facultatif) Choisissez Détails supplémentaires pour développer la section, puis dans Description, entrez une description permettant d'identifier ce registre.

  6. Dans la section Autorisation de l'API de recherche, pour le type d'authentification, choisissez Utiliser l'autorisation IAM (autorisation entrante).

  7. Dans la section Approbation des enregistrements, activez ou désactivez Auto-approval  :

    • Lorsque Auto-approval cette option est activée, lorsque vous soumettez un enregistrement pour approbation, l'enregistrement passe directement au statut Approuvé et devient visible dans les résultats de recherche peu de temps après.

    • Lorsque Auto-approval cette option est désactivée, lorsque vous soumettez un enregistrement pour approbation, celui-ci passe au statut En attente d'approbation et nécessite qu'un conservateur l'examine et l'approuve avant sa publication.

  8. Choisissez Créer un registre.

Création d'un registre avec JWT-based autorisation

L'autorisation du fournisseur d'identité utilise des jetons Web JSON (JWT) pour contrôler l'accès aux API du plan de données détectables et au point de terminaison MCP du registre. Vous pouvez utiliser Amazon Cognito pour configurer rapidement l'autorisation, ou utiliser votre propre fournisseur d'identité pour activer OAuth 2.0.

Exemple
AWS Agent Registry namespace

  1. Ouvrez la console du registre des AWS agents.

  2. Dans le volet de navigation, choisissez Registry.

  3. Dans la section Registres, choisissez Créer un registre.

  4. Dans la section Détails du registre, dans Nom, entrez un nom pour votre registre. Le nom doit commencer par un caractère alphanumérique. Les caractères valides sont les suivants : a—z, A—Z, 0—9, _ (trait de soulignement), - (tiret), (point) et . (barre oblique). / Le nom peut comporter jusqu'à 64 caractères.

  5. (Facultatif) Choisissez Détails supplémentaires pour développer la section, puis dans Description, entrez une description permettant d'identifier ce registre.

  6. Dans la section Discovery Authorization, pour le type d'authentification, choisissez Utiliser les jetons Web JSON (JWT) (autorisation entrante).

  7. Pour la configuration du schéma JWT, choisissez l'une des options suivantes :

    1. Création rapide de configurations avec Cognito (recommandé) — Le registre des AWS agents crée les configurations d'autorisation en votre nom en utilisant Amazon Cognito comme fournisseur d'identité. Aucune configuration supplémentaire n’est requise.

    2. Utilisez les configurations de fournisseur d'identité existantes  : apportez votre propre fournisseur d'identité pour activer OAuth 2.0. Si vous choisissez cette option, procédez comme suit :

      1. Pour URL de découverte, entrez l'URL de découverte de votre fournisseur d'identité. AWS Le registre des agents utilise cette URL pour récupérer automatiquement les paramètres de connexion, de jeton et de vérification de votre fournisseur. Vous trouverez cette URL dans le tableau de bord ou la documentation de votre fournisseur d'identité (par exemplehttps://cognito-identity.amazonaws.com/.well-known/openid-configuration).

        Note

        L'URL de découverte ne peut pas être modifiée une fois le registre créé.

      2. (Facultatif) Dans Configuration des autorisations JWT, sélectionnez Audiences autorisées pour fournir une liste des audiences autorisées que le registre des AWS agents valide par rapport à la aud réclamation figurant dans le jeton JWT. Une demande d'audience (aud) dans OAuth 2.0 spécifie à quel serveur de ressources (API) le jeton est destiné. Cela garantit que le jeton est le bon destinataire avant de traiter la demande, évitant ainsi qu'un jeton ne soit réutilisé dans une autre API pour laquelle il n'a pas été émis.

      3. (Facultatif) Sélectionnez Clients autorisés pour fournir une liste des identifiants de clients autorisés qu' AWS Agent Registry valide par rapport à la client_id réclamation du jeton JWT. A client_id est un identifiant unique public pour une application qui demande des jetons d'accès pour accéder aux API du plan de données détectables ou au point de terminaison MCP du registre. Si vous activez cette option, entrez un ou plusieurs ID de client dans le champ Clients, puis choisissez Ajouter un client pour ajouter des clients supplémentaires.

      4. (Facultatif) Sélectionnez Étendues autorisées pour fournir une liste des autorisations autorisées, définies comme des étendues. Si elle est configurée, au moins une valeur d'étendue du jeton entrant doit correspondre à l'une des valeurs configurées. Les scopes agissent comme des autorisations pour limiter ce que peut faire une application.

      5. (Facultatif) Sélectionnez Revendations personnalisées pour fournir un ensemble de règles qui font correspondre les revendications spécifiques du jeton entrant à des valeurs prédéfinies. Pour chaque règle, spécifiez le nom de la revendication, le type de valeur (STRING ou STRING_ARRAY) et la valeur de correspondance requise.

  8. Dans la section Approbation des enregistrements, activez ou désactivez Auto-approval  :

    1. Lorsque Auto-approval cette option est activée, lorsque vous soumettez un enregistrement pour approbation, l'enregistrement passe directement au statut Approuvé et devient immédiatement visible dans les résultats de recherche.

    2. Lorsque Auto-approval cette option est désactivée, lorsque vous soumettez un enregistrement pour approbation, celui-ci passe au statut En attente d'approbation et nécessite qu'un administrateur du registre l'examine et l'approuve avant sa publication.

  9. (Facultatif) Dans la section Balises, choisissez Ajouter une nouvelle étiquette pour associer une ou plusieurs balises au registre. Chaque étiquette possède une clé et une valeur facultative.

  10. Choisissez Créer un registre.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Ouvrez la page Registre des AWS agents dans la Bedrock-AgentCore console.

  2. Dans le volet de navigation, choisissez Registry.

  3. Dans la section Registres, choisissez Créer un registre.

  4. Dans la section Détails du registre, dans Nom, entrez un nom pour votre registre. Le nom doit commencer par un caractère alphanumérique. Les caractères valides sont les suivants : a—z, A—Z, 0—9, _ (trait de soulignement), - (tiret), (point) et . (barre oblique). / Le nom peut comporter jusqu'à 64 caractères.

  5. (Facultatif) Choisissez Détails supplémentaires pour développer la section, puis dans Description, entrez une description permettant d'identifier ce registre.

  6. Dans la section Autorisation de l'API de recherche, pour le type d'authentification, choisissez Utiliser les jetons Web JSON (JWT) (autorisation entrante).

  7. Pour la configuration du schéma JWT, choisissez l'une des options suivantes :

    1. Création rapide de configurations avec Cognito (recommandé) — Le registre des AWS agents crée les configurations d'autorisation en votre nom en utilisant Amazon Cognito comme fournisseur d'identité. Aucune configuration supplémentaire n’est requise.

    2. Utilisez les configurations de fournisseur d'identité existantes  : apportez votre propre fournisseur d'identité pour activer OAuth 2.0. Si vous choisissez cette option, procédez comme suit :

      1. Pour URL de découverte, entrez l'URL de découverte de votre fournisseur d'identité. AWS Le registre des agents utilise cette URL pour récupérer automatiquement les paramètres de connexion, de jeton et de vérification de votre fournisseur. Vous trouverez cette URL dans le tableau de bord ou la documentation de votre fournisseur d'identité (par exemplehttps://cognito-identity.amazonaws.com/.well-known/openid-configuration).

        Note

        L'URL de découverte ne peut pas être modifiée une fois le registre créé.

      2. (Facultatif) Dans Configuration des autorisations JWT, sélectionnez Audiences autorisées pour fournir une liste des audiences autorisées que le registre des AWS agents valide par rapport à la aud réclamation figurant dans le jeton JWT. Une demande d'audience (aud) dans OAuth 2.0 spécifie à quel serveur de ressources (API) le jeton est destiné. Cela garantit que le jeton est le bon destinataire avant de traiter la demande, évitant ainsi qu'un jeton ne soit réutilisé dans une autre API pour laquelle il n'a pas été émis.

      3. (Facultatif) Sélectionnez Clients autorisés pour fournir une liste des identifiants de clients autorisés qu' AWS Agent Registry valide par rapport à la client_id réclamation du jeton JWT. A client_id est un identifiant unique public pour une application qui demande des jetons d'accès pour accéder à l'API de recherche du registre. Si vous activez cette option, entrez un ou plusieurs ID de client dans le champ Clients, puis choisissez Ajouter un client pour ajouter des clients supplémentaires.

      4. (Facultatif) Sélectionnez Étendues autorisées pour fournir une liste des autorisations autorisées, définies comme des étendues. Si elle est configurée, au moins une valeur d'étendue du jeton entrant doit correspondre à l'une des valeurs configurées. Les étendues agissent comme des autorisations pour limiter ce que peut faire une application.

      5. (Facultatif) Sélectionnez Revendations personnalisées pour fournir un ensemble de règles qui font correspondre les revendications spécifiques du jeton entrant à des valeurs prédéfinies. Pour chaque règle, spécifiez le nom de la revendication, le type de valeur (STRING ou STRING_ARRAY) et la valeur de correspondance requise.

  8. Dans la section Approbation des enregistrements, activez ou désactivez Auto-approval  :

    1. Lorsque Auto-approval cette option est activée, lorsque vous soumettez un enregistrement pour approbation, l'enregistrement passe directement au statut Approuvé et devient immédiatement visible dans les résultats de recherche.

    2. Lorsque Auto-approval cette option est désactivée, lorsque vous soumettez un enregistrement pour approbation, celui-ci passe au statut En attente d'approbation et nécessite qu'un administrateur du registre l'examine et l'approuve avant sa publication.

  9. Choisissez Créer un registre.

Note

* Au moins un champ de configuration d'autorisation JWT est requis : audiences autorisées, clients autorisés, étendues autorisées ou revendications personnalisées. Si vous en configurez plusieurs, le registre des AWS agents les vérifie tous. * L'URL de découverte ne peut pas être modifiée une fois le registre créé. * Le type d'autorisation (IAM ou JWT) ne peut pas être modifié une fois le registre créé. * Un registre ne prend en charge qu'une seule forme de type d'autorisation entrante à la fois : IAM Sigv4 ou JWT Bearer Token. Vous ne pouvez pas utiliser les deux simultanément. La recherche via IAM est uniquement prise en charge via le IAM-based registre ; et la recherche via Oauth n'est prise en charge que via le registre basé sur Oauth.

Après avoir créé le registre, la console accède à la page des détails du registre. L'état du registre est initialement en cours de création. AWS Le registre des agents attribue un ARN au registre, que vous pouvez trouver dans la section Détails du registre. L'état du registre passe à Prêt une fois le provisionnement terminé. Vous pouvez ajouter des enregistrements au registre lorsque son statut est Prêt.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control create-registry \
  --name "MyFirstRegistry" \
  --description "My first Agent Registry" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry \
  --name "MyFirstRegistry" \
  --description "My first Agent Registry" \
  --region us-east-1

L'état du registre commence comme CREATING et passe à READY lorsque le provisionnement est terminé.

AWS Kit SDK

Exemple
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.create_registry(
    name='my-agent-registry',
    description='My first Agent Registry'
)
print(response['registryArn'])
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.create_registry(
    name='my-agent-registry',
    description='My first Agent Registry'
)
print(response['registryArn'])

Étape 2 : Ajouter un enregistrement de registre

Créez un enregistrement pour un serveur MCP dans votre registre.

Console

Un enregistrement de registre représente un agent, un outil, une compétence ou une ressource personnalisée.

Exemple
AWS Agent Registry namespace

  1. Ouvrez la console du registre des AWS agents.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre dans lequel vous souhaitez ajouter un enregistrement.

  3. Dans la section Enregistrements du registre, choisissez Créer un enregistrement.

  4. Choisissez un type de source :

    1. Synchronisation depuis le point de terminaison — Fournissez une URL de point de terminaison et des informations d'identification facultatives pour récupérer les métadonnées à partir d'un serveur MCP ou d'un point de terminaison agent (A2A). Voir Synchroniser les enregistrements provenant de sources externes pour plus de détails.

    2. Manuel — Configurez manuellement les détails de l'enregistrement et la configuration du protocole. Continuez à suivre les étapes ci-dessous.

  5. Dans la section Détails de l'enregistrement, pour Nom, entrez un nom unique pour l'enregistrement. Le nom doit être unique dans le registre : Record version il doit être à la Name fois unique et unique. Le nom doit commencer par un caractère alphanumérique. Les caractères valides sont les suivants : a—z, A—Z, 0—9, _ (trait de soulignement), - (tiret), (point) et . (barre oblique). / Le nom peut comporter jusqu'à 255 caractères.

  6. (Facultatif) Dans Nom d'affichage, entrez une étiquette lisible par l'homme pour l'enregistrement. Cela apparaît dans le tableau des enregistrements du registre et dans les résultats de recherche à côté du nom technique de l'enregistrement.

  7. (Facultatif) Dans Description, entrez une description pour l'enregistrement. La description peut comprendre de 1 à 4 096 caractères.

  8. Dans Version de l'enregistrement, entrez un identifiant de version pour l'enregistrement (par exemple, 1.0.0 ouv2.1).

  9. Dans la section Type d'enregistrement et descripteur :

    1. Sous Type, sélectionnez le type sémantique de l'enregistrement. Le type détermine quelles clés de descripteur primaires sont valides.

      • MCP — Protocole conçu pour les communications entre les outils d'IA et les agents. Gère la gestion du contexte et les formats de messages structurés.

      • Agent  : protocole conçu pour sécuriser les interactions agent-agent. Permet des flux de travail distribués et l'échange d'informations.

      • Compétences — Enregistrez les compétences des agents à l'aide de la documentation Markdown et d'une définition structurée facultative.

      • Personnalisé — Implémentation de protocoles personnalisés pour des modèles de communication spécialisés. Définissez vos propres spécifications d'interface et exigences d'intégration.

    2. Sous Descripteur, choisissez la forme des données descriptives de l'enregistrement. Les options disponibles dépendent du type que vous avez sélectionné :

      • Serveur MCP → MCP ou personnalisé

      • Agent → Carte d'agent A2A, serveur MCP ou personnalisé

      • Compétences → Définition ou personnalisation des compétences des agents

      • Personnalisé → Personnalisé

  10. Un éditeur spécifique au descripteur apparaît en fonction de votre sélection de descripteur  :

    1. Serveur MCP  : sélectionnez une version de schéma dans la liste déroulante Version de schéma (par exemple2025-12-11), puis saisissez votre serveur de registre Model Context Protocol server.json sur le site Web Model Context Protocol dans l'éditeur de définition de votre serveur MCP. La définition doit être conforme au schéma de serveur MCP officiel de la version sélectionnée. Pour afficher le schéma officiel en tant que référence, activez Afficher le schéma officiel. (Facultatif) Sélectionnez Ajouter une définition d'outil pour ajouter les outils disponibles sur ce serveur avec leurs paramètres d'entrée, leurs sorties et des exemples d'utilisation. Sélectionnez une version du schéma (par exemple2025-11-25) et entrez la définition de votre outil dans l'éditeur de définition de votre outil.

    2. Carte d'agent A2A — La version du schéma est0.3. Entrez la définition de votre carte d'agent dans l'éditeur. Pour afficher le schéma officiel en tant que référence, activez Afficher le schéma officiel.

    3. Définition des compétences de l'agent — Pour la documentation sur les compétences, entrez le code de démarquage qui décrit cette compétence. (Facultatif) Sélectionnez Inclure la définition des compétences pour ajouter une définition structurée. Sélectionnez une version du schéma et entrez la définition sous forme d'objet JSON.

    4. Personnalisé — Entrez votre définition personnalisée en tant qu'objet JSON.

  11. (Facultatif) Dans la section Balises, choisissez Ajouter une nouvelle étiquette pour associer une ou plusieurs balises à l'enregistrement. Chaque étiquette possède une clé et une valeur facultative.

  12. Choisissez Créer un registre.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Ouvrez la page Registre des AWS agents dans la Bedrock-AgentCore console.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre dans lequel vous souhaitez ajouter un enregistrement.

  3. Dans la section Enregistrements du registre, choisissez Créer un enregistrement.

  4. Choisissez un type de source :

    1. Synchronisation depuis le point de terminaison — Fournissez une URL de point de terminaison et des informations d'identification facultatives pour récupérer les métadonnées à partir d'un serveur MCP ou d'un point de terminaison agent (A2A). Voir Synchroniser les enregistrements provenant de sources externes pour plus de détails.

    2. Manuel — Configurez manuellement les détails de l'enregistrement et la configuration du protocole. Continuez à suivre les étapes ci-dessous.

  5. Dans la section Détails de l'enregistrement, pour Nom, entrez un nom pour l'enregistrement. Le nom doit commencer par un caractère alphanumérique. Les caractères valides sont les suivants : a—z, A—Z, 0—9, _ (trait de soulignement), - (tiret), (point) et . (barre oblique). / Le nom peut comporter jusqu'à 255 caractères.

  6. (Facultatif) Dans Description, entrez une description pour l'enregistrement. La description peut comprendre de 1 à 4 096 caractères.

  7. Dans Version de l'enregistrement, entrez un identifiant de version pour l'enregistrement (par exemple, 1.0.0 ouv2.1).

  8. Dans la section Type d'enregistrement, choisissez le type qui correspond à votre ressource :

    1. MCP — Protocole conçu pour les communications entre les outils d'IA et les agents. Gère la gestion du contexte et les formats de messages structurés. Si vous choisissez ce type, procédez comme suit :

      1. Dans la section Définition du serveur MCP, sélectionnez une version du schéma dans la liste déroulante Version du schéma (par exemple2025-12-11), puis saisissez Model Context Protocol registry server.json depuis le site Web Model Context Protocol dans l'éditeur de définition de votre serveur MCP. La définition doit être conforme au schéma de serveur MCP officiel de la version sélectionnée. Pour afficher le schéma officiel en tant que référence, activez Afficher le schéma officiel.

      2. (Facultatif) Sélectionnez Ajouter une définition d'outil pour ajouter des outils spécifiques disponibles sur ce serveur avec leurs paramètres d'entrée, leurs sorties et des exemples d'utilisation afin d'améliorer leur visibilité. Si vous sélectionnez cette option, sélectionnez une version du schéma dans la liste déroulante Version du schéma (par exemple2025-11-25), puis entrez la définition de votre outil dans l'éditeur de définition de votre outil. Pour afficher le schéma officiel de l'outil en tant que référence, activez Afficher le schéma officiel.

    2. Agent  : protocole conçu pour sécuriser les interactions agent-agent. Permet des flux de travail distribués et l'échange d'informations. Si vous choisissez ce type, la version du schéma est0.3. Entrez la définition de votre carte d'agent dans l'éditeur. Pour afficher le schéma officiel en tant que référence, activez Afficher le schéma officiel.

    3. Compétences des agents  : enregistrez les compétences des agents à l'aide de la documentation Markdown et d'une définition structurée facultative. Si vous choisissez ce type, procédez comme suit :

      1. Pour la documentation sur les compétences, entrez la documentation de démarquage qui décrit cette compétence.

      2. (Facultatif) Sélectionnez Inclure la définition des compétences pour ajouter une définition structurée. Si vous sélectionnez cette option, sélectionnez une version du schéma dans la liste déroulante Version du schéma, puis entrez la définition de la compétence sous forme d'objet JSON dans l'éditeur.

    4. Personnalisé — Implémentation de protocoles personnalisés pour des modèles de communication spécialisés. Définissez vos propres spécifications d'interface et exigences d'intégration. Si vous choisissez ce type, entrez votre définition personnalisée sous forme d'objet JSON dans l'éditeur.

  9. Choisissez Créer un registre.

Note

Pour ajouter au registre un serveur ou un agent qui n'est pas conforme aux schémas de protocole standard MCP ou A2A, utilisez le type d'enregistrement personnalisé.

Une fois que vous avez choisi Créer un enregistrement, le registre des AWS agents commence à provisionner l'enregistrement. L'état de l'enregistrement est initialement en cours de création. Une fois le provisionnement terminé, le statut passe à Brouillon. Pour rendre l'enregistrement accessible à d'autres personnes, soumettez-le pour approbation. Pour plus d'informations, voir Étape 3 : Soumettre l'enregistrement pour approbation.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id <registryId> \
  --name "weather-server" \
  --display-name "WeatherServer" \
  --record-type MCP \
  --descriptors '{"mcpServer": {"data": "{\"name\": \"weather/mcp-server\", \"description\": \"Weather data service\", \"version\": \"1.0.0\"}", "dataSchemaVersion": "2025-12-11"}}' \
  --record-version "1.0" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "WeatherServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"weather/mcp-server\", \"description\": \"Weather data service\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

L'enregistrement est créé avec le statut CREATING et passe à DRAFT une fois le traitement terminé. Pour plus d'exemples de AWS CLI permettant de créer des enregistrements d'autres types, consultez la section Créer et gérer des enregistrements.

AWS Kit SDK

Exemple
AWS Agent Registry namespace
import boto3
import json

client = boto3.client('agent-registry-control')

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    displayName='My MCP Server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11',
            'additionalData': {
                'tools': {
                    'data': tools_content,
                    'dataSchemaVersion': '2024-11-05'
                }
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3
import json

client = boto3.client('bedrock-agentcore-control')

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'schemaVersion': '2025-12-11',
                'inlineContent': server_content
            },
            'tools': {
                'protocolVersion': '2024-11-05',
                'inlineContent': tools_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Étape 3 : Soumettre l'enregistrement pour approbation

Console

La soumission d'un enregistrement pour approbation lance le processus de révision qui rend l'enregistrement disponible pour découverte. Vous pouvez soumettre un enregistrement depuis la table des enregistrements du registre ou depuis la page des détails de l'enregistrement.

Pour soumettre un enregistrement pour approbation à partir du tableau des enregistrements du registre

Exemple
AWS Agent Registry namespace

  1. Ouvrez la console du registre des AWS agents.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre.

  3. Dans la section Enregistrements du registre, sélectionnez l'enregistrement que vous souhaitez soumettre.

  4. Choisissez Mettre à jour le statut, puis Soumettre pour approbation.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Ouvrez la page Registre des AWS agents dans la Bedrock-AgentCore console.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre.

  3. Dans la section Enregistrements du registre, sélectionnez l'enregistrement que vous souhaitez soumettre.

  4. Choisissez Mettre à jour le statut, puis Soumettre pour approbation.

Pour soumettre un enregistrement pour approbation à partir de la page des détails de l'enregistrement

Exemple
AWS Agent Registry namespace

  1. Ouvrez la console du registre des AWS agents.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre.

  3. Dans la section Enregistrements du registre, choisissez le nom de l'enregistrement que vous souhaitez soumettre.

  4. Choisissez Mettre à jour le statut, puis Soumettre pour approbation.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Ouvrez la page Registre des AWS agents dans la Bedrock-AgentCore console.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre.

  3. Dans la section Enregistrements du registre, choisissez le nom de l'enregistrement que vous souhaitez soumettre.

  4. Choisissez Mettre à jour le statut, puis Soumettre pour approbation.

Une fois que vous avez soumis un enregistrement pour approbation, son statut change en fonction du paramètre d'approbation du registre :

  • Si le registre est Auto-approval activé, le statut de l'enregistrement passe directement à Approuvé et apparaît dans les résultats de recherche peu de temps après.

  • Si le registre Auto-approval est désactivé, le statut de l'enregistrement passe à En attente d'approbation et nécessite qu'un administrateur du registre l'examine et l'approuve avant sa publication.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control submit-registry-record-for-approval \
  --registry-id <registryId> \
  --record-id <recordId> \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id <registryId> \
  --record-id <recordId> \
  --region us-east-1

L'enregistrement est transféré vers PENDING_APPROVAL (ou directement vers APPROVED si l'approbation automatique est activée).

AWS Kit SDK

Exemple
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Record ID: {response['recordId']}")
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
print(f"Updated At: {response['updatedAt']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Record ID: {response['recordId']}")
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
print(f"Updated At: {response['updatedAt']}")

Étape 4 : Approuver l'enregistrement

Console

Pour approuver un enregistrement à partir de la table des enregistrements du registre

Exemple
AWS Agent Registry namespace

  1. Ouvrez la console du registre des AWS agents.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre.

  3. Dans la section Enregistrements du registre, sélectionnez l'enregistrement que vous souhaitez approuver.

  4. Choisissez Mettre à jour le statut, puis cliquez sur Approuver.

  5. Dans la boîte de dialogue de confirmation, entrez la raison du changement de statut.

  6. Choisissez Confirmer.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Ouvrez la page Registre des AWS agents dans la Bedrock-AgentCore console.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre.

  3. Dans la section Enregistrements du registre, sélectionnez l'enregistrement que vous souhaitez approuver.

  4. Choisissez Mettre à jour le statut, puis cliquez sur Approuver.

  5. Dans la boîte de dialogue de confirmation, entrez la raison du changement de statut.

  6. Choisissez Confirmer.

Pour approuver un enregistrement depuis la page des détails de l'enregistrement

Exemple
AWS Agent Registry namespace

  1. Ouvrez la console du registre des AWS agents.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre.

  3. Dans la section Enregistrements du registre, choisissez le nom de l'enregistrement que vous souhaitez approuver.

  4. Dans la page des détails de l'enregistrement, choisissez Mettre à jour le statut, puis choisissez Approuver.

  5. Dans la boîte de dialogue de confirmation, entrez la raison du changement de statut.

  6. Choisissez Confirmer.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Ouvrez la page Registre des AWS agents dans la Bedrock-AgentCore console.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre.

  3. Dans la section Enregistrements du registre, choisissez le nom de l'enregistrement que vous souhaitez approuver.

  4. Dans la page des détails de l'enregistrement, choisissez Mettre à jour le statut, puis choisissez Approuver.

  5. Dans la boîte de dialogue de confirmation, entrez la raison du changement de statut.

  6. Choisissez Confirmer.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control update-registry-record-status \
  --registry-id <registryId> \
  --record-id <recordId> \
  --status APPROVED \
  --status-reason "Reviewed and approved" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record-status \
  --registry-id <registryId> \
  --record-id <recordId> \
  --status APPROVED \
  --status-reason "Reviewed and approved" \
  --region us-east-1

AWS Kit SDK

Exemple
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.update_registry_record_status(
    registryId='<registryId>',
    recordId='<recordId>',
    status='APPROVED',
    statusReason='Meets all requirements'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # APPROVED
print(f"Reason: {response['statusReason']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry_record_status(
    registryId='<registryId>',
    recordId='<recordId>',
    status='APPROVED',
    statusReason='Meets all requirements'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # APPROVED
print(f"Reason: {response['statusReason']}")

Étape 5 : Découvrez les enregistrements approuvés

Le répertoire des enregistrements est la page de console permettant de parcourir et de rechercher des enregistrements approuvés dans un registre. Lorsque vous sélectionnez un registre sur la page Répertoire des enregistrements, la console répertorie automatiquement ses enregistrements approuvés. À partir de là, vous pouvez parcourir la liste ou utiliser le champ de recherche pour exécuter une requête en langage naturel. Utilisez-le par programmation ListDiscoverableRegistryRecords pour parcourir, SearchDiscoverableRegistryRecords rechercher et récupérer tous les détails BatchGetDiscoverableRegistryRecord de nombreux enregistrements en un seul appel.

Console

Note

Console-based discovery n'est disponible que pour les registres qui utilisent Utiliser IAM comme type d'autorisation. Si votre registre utilise des jetons Web JSON (JWT), appelez les API du plan de données détectables directement à l'aide d'un client HTTP tel que curl ou Postman avec un jeton JWT Bearer valide dans l'en-tête de la demande. La AWS CLI et AWS les kits SDK utilisent la signature IAM Sigv4 et ne peuvent pas être utilisés avec des registres. JWT-authorized Pour plus de détails, voir Rechercher des enregistrements de registre.

Exemple
AWS Agent Registry namespace

Pour parcourir ou rechercher des enregistrements approuvés

  1. Ouvrez la console du registre des AWS agents.

  2. Dans le volet de navigation, choisissez Record directory.

  3. Sous Registre, sélectionnez le registre dont vous souhaitez explorer les enregistrements approuvés. La page répertorie automatiquement tous les enregistrements approuvés dans ce registre.

  4. (Facultatif) Basculez entre l'affichage Carte et Tableau en haut à droite de la page.

  5. (Facultatif) Dans Rechercher des enregistrements approuvés, entrez une requête en langage naturel ou un nom pour affiner les résultats, puis choisissez Rechercher.

  6. Choisissez une carte ou une ligne pour accéder à tous les détails de l'enregistrement.

Le répertoire des enregistrements affiche uniquement les enregistrements dont le statut est Approuvé. Les enregistrements dont le statut est Brouillon, En attente d'approbation, Rejeté ou Obsolète n'apparaissent pas.

Amazon Bedrock AgentCore namespace (to be deprecated)

Pour rechercher des enregistrements de registre

  1. Ouvrez la page Registre des AWS agents dans la Bedrock-AgentCore console.

  2. Dans le volet de navigation, choisissez Registre, puis choisissez le nom du registre.

  3. Choisissez l'onglet Rechercher des enregistrements.

  4. Dans le champ Rechercher des enregistrements approuvés, saisissez votre requête de recherche.

  5. (Facultatif) Pour filtrer les résultats selon une propriété spécifique, choisissez le champ de recherche pour développer le menu Propriétés, puis choisissez un filtre : Nom , Type de descripteur ou Version.

  6. Choisissez Rechercher.

La recherche ne renvoie que les enregistrements dont le statut est Approuvé. Les enregistrements dont l'état est Brouillon, En attente d'approbation, Rejeté ou Obsolète n'apparaissent pas dans les résultats de recherche.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Parcourir les enregistrements approuvés — répertorier les enregistrements approuvés dans un registre :

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registry-id>" \
  --region us-east-1

Recherchez des enregistrements approuvés — exécutez une recherche hybride sémantique et par mot clé :

Exemple
AWS Agent Registry namespace
aws agent-registry search-discoverable-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore search-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1

Récupérez tous les détails de nombreux enregistrements à la fois  :

aws agent-registry batch-get-discoverable-registry-record \
  --entries '[{"registryId": "<registry-id>", "recordIds": ["<recordId-1>", "<recordId-2>"]}]' \
  --region us-east-1
Note

ListDiscoverableRegistryRecordset ne BatchGetDiscoverableRegistryRecord sont disponibles que dans l'espace de agent-registry noms. Ils ne sont pas disponibles dans l'espace de bedrock-agentcore noms.

AWS Kit SDK

Parcourez les enregistrements approuvés  :

import boto3

client = boto3.client('agent-registry')

list_response = client.list_discoverable_registry_records(
    registryId='<registry-id>',
    maxResults=20
)
for record in list_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")

Rechercher des enregistrements approuvés  :

Exemple
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry')

response = client.search_discoverable_registry_records(
    registryIds=['arn:aws:agent-registry:us-east-1:<account>:registry/<registryId>'],
    searchQuery='weather forecast tool',
    maxResults=10
)
for record in response['registryRecords']:
    print(f"Record: {record['displayName']} ({record['recordId']})")
    print(f"  Name: {record['name']}")
    print(f"  Type: {record['recordType']}")
    print(f"  Status: {record['status']}")
    print(f"  Version: {record['recordVersion']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore')

response = client.search_registry_records(
    registryIds=['arn:aws:bedrock-agentcore:us-east-1:<account>:registry/<registryId>'],
    searchQuery='weather forecast tool',
    maxResults=10
)
for record in response['registryRecords']:
    print(f"Record: {record['name']} ({record['recordId']})")
    print(f"  Type: {record['descriptorType']}")
    print(f"  Status: {record['status']}")
    print(f"  Version: {record['version']}")

Récupérez tous les détails de nombreux enregistrements à la fois  :

batch_response = client.batch_get_discoverable_registry_record(
    entries=[{'registryId': '<registry-id>', 'recordIds': ['<recordId-1>', '<recordId-2>']}]
)
for record in batch_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")
for err in batch_response['errors']:
    print(f"Error for {err['recordId']}: {err['errorCode']}")

Ce que tu as construit

  • Un registre avec autorisation IAM et approbation manuelle

  • Un enregistrement de registre décrivant un serveur MCP

  • Un enregistrement approuvé consultable et consultable dans le répertoire des enregistrements

Étapes suivantes

  • Créez des expériences de découverte similaires à celles d'un catalogue en plus de ListDiscoverableRegistryRecords BatchGetDiscoverableRegistryRecord

  • Configurez EventBridge les notifications Amazon pour automatiser votre flux de travail d'approbation

  • Ajoutez des enregistrements supplémentaires pour vos agents, vos serveurs, vos compétences et vos ressources personnalisées