View a markdown version of this page

Création et gestion d'enregistrements - Base rocheuse de l'Amazonie AgentCore
Création d'un enregistrement de registreRépertorier les enregistrements duAfficher les détails de l'enregistrementMettre à jour un enregistrement de registreSoumettre un enregistrement pour approbationSupprimer un enregistrement de registreValidation du schéma

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.

Création et gestion d'enregistrements

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.

Création d'un enregistrement de registre

Console

Exemple
AWS Agent Registry namespace

  1. Ouvrez la page détaillée du registre dans la console AWS Agent Registry.

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

  3. 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 appeler le point de terminaison, et le registre récupérera les métadonnées depuis la source. Disponible uniquement pour les types d'enregistrement MCP et Agent. Pour mettre à jour l'enregistrement après la modification de la source, vous devez déclencher manuellement la synchronisation. 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.

Synchronisation depuis le terminal

  1. Dans Détails de l'enregistrement, sélectionnez le type d'enregistrement : MCP ou Agent.

    Note

    La synchronisation n'est prise en charge que pour les types d'enregistrement MCP et Agent. Les types d'enregistrement Agent Skills et Custom ne prennent pas en charge la synchronisation. Utilisez plutôt le type de source Manuel.

  2. Entrez l'URL du point de terminaison. Il doit s'agir d'une URL HTTPS valide.

  3. Dans Type d'identification, choisissez la manière dont le registre autorise le terminal :

    1. IAM — Fournissez un ARN de rôle pour la signature SIGv4 et un nom de service (par exemple, agent-registryexecute-api,lambda). Spécifiez éventuellement une région pour la signature.

    2. OAuth  : sélectionnez ou saisissez l'ARN d'un fournisseur d'informations d'identification dans Identity. AgentCore Configurez éventuellement les étendues et les paramètres personnalisés sous Configuration supplémentaire.

    3. Aucune — Aucune autorisation (pour les terminaux publics).

  4. Choisissez Créer un registre.

    L'enregistrement est créé avec le statut CREATION. Le registre se connecte au point de terminaison, extrait les métadonnées et remplit les descripteurs de l'enregistrement. Une fois la synchronisation terminée, l'enregistrement passe à DRAFT. Si la synchronisation échoue, l'enregistrement passe au statut CREATE_FAILED avec les détails de l'erreur disponibles dans le champ Raison du statut de la page des détails de l'enregistrement. Pour résoudre les problèmes, consultez la section Erreurs de synchronisation des enregistrements. Pour mettre à jour l'enregistrement lorsque la source change, choisissez Gérer, puis Synchronisation sur la page détaillée de l'enregistrement, ou choisissez Gérer → Modifier et sélectionnez Re-sync depuis le point de terminaison.

Pour des exemples de création d'enregistrements à l'aide de la AWS CLI et du SDK avec synchronisation, voir Synchroniser des enregistrements provenant de sources externes.

Manuel

  1. 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.

  2. (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.

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

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

  5. 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é

  6. Un éditeur spécifique au descripteur apparaît en fonction de votre sélection de descripteur. Entrez la configuration de votre protocole au format JSON. Pour les descripteurs de serveur MCP et de carte d'agent A2A, activez Afficher le schéma officiel pour afficher le schéma de référence côte à côte. La console valide votre JSON par rapport au schéma officiel et affiche les erreurs en ligne (par exemple, « Nom » de la propriété manquante ») à l'aide d'un bouton Diagnostiquer avec Amazon Q. Pour plus de détails sur la configuration par descripteur, voir Types d'enregistrements pris en charge.

  7. (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.

  8. Choisissez-en parmi :

    1. Créer en tant que brouillon — Crée l'enregistrement au statut Brouillon.

    2. Créer et soumettre pour approbation  : crée l'enregistrement et le soumet immédiatement pour approbation.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Ouvrez la page détaillée du registre dans la Bedrock-AgentCore console.

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

  3. 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 appeler le point de terminaison, et le registre récupérera les métadonnées depuis la source. Disponible uniquement pour les types d'enregistrement MCP et Agent. Pour mettre à jour l'enregistrement après la modification de la source, vous devez déclencher manuellement la synchronisation. 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.

Synchronisation depuis le terminal

  1. Dans Détails de l'enregistrement, sélectionnez le type d'enregistrement : MCP ou Agent.

    Note

    La synchronisation n'est prise en charge que pour les types d'enregistrement MCP et Agent. Les types d'enregistrement Agent Skills et Custom ne prennent pas en charge la synchronisation. Utilisez plutôt le type de source Manuel.

  2. Entrez l'URL du point de terminaison. Il doit s'agir d'une URL HTTPS valide.

  3. Dans Type d'identification, choisissez la manière dont le registre autorise le terminal :

    1. IAM — Fournissez un ARN de rôle pour la signature Sigv4 et un nom de service (par exemple, bedrock-agentcoreexecute-api,lambda). Spécifiez éventuellement une région pour la signature.

    2. OAuth  : sélectionnez ou saisissez l'ARN d'un fournisseur d'informations d'identification dans Identity. AgentCore Configurez éventuellement les étendues et les paramètres personnalisés sous Configuration supplémentaire.

    3. Aucune — Aucune autorisation (pour les terminaux publics).

  4. Choisissez Créer un registre.

    L'enregistrement est créé avec le statut CREATION. Le registre se connecte au point de terminaison, extrait les métadonnées et remplit les descripteurs de l'enregistrement. Une fois la synchronisation terminée, l'enregistrement passe à DRAFT. Si la synchronisation échoue, l'enregistrement passe au statut CREATE_FAILED avec les détails de l'erreur disponibles dans le champ Raison du statut de la page des détails de l'enregistrement. Pour résoudre les problèmes, consultez la section Erreurs de synchronisation des enregistrements. Pour mettre à jour l'enregistrement lorsque la source change, utilisez le bouton Synchroniser sur la page détaillée de l'enregistrement ou sélectionnez un point Re-sync de terminaison lors de la modification.

Pour des exemples de création d'enregistrements à l'aide de la AWS CLI et du SDK avec synchronisation, voir Synchroniser des enregistrements provenant de sources externes.

Manuel

  1. Dans Détails de l'enregistrement, saisissez :

    1. Nom — Doit commencer par une lettre ou un chiffre. Les caractères valides sont a-z, 0-9 A-Z, _ (trait de soulignement), - (tiret),. (point) et/(barre oblique). Le nom peut comporter jusqu'à 255 caractères.

    2. Description (facultatif) : de 1 à 4 096 caractères.

    3. Version de l'enregistrement — Spécifiez la version de cet enregistrement (par exemple, 1.0.0, v2.1).

  2. Sous Type d'enregistrement, sélectionnez l'une des options suivantes : MCP, Agent, Agent Skills ou Custom.

  3. Un éditeur spécifique au type apparaît. Entrez la configuration de votre protocole au format JSON.

    1. Pour les types Agent et MCP, cochez Afficher le schéma officiel pour afficher le schéma de référence côte à côte à titre indicatif.

    2. La console valide votre JSON par rapport au schéma officiel et affiche les erreurs en ligne (par exemple, « Nom » de la propriété manquante ») à l'aide d'un bouton Diagnostiquer avec Amazon Q.

  4. Choisissez-en parmi :

    1. Créer en tant que brouillon — Crée l'enregistrement au statut Brouillon.

    2. Créer et soumettre pour approbation  : crée l'enregistrement et le soumet immédiatement 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 "my-mcp-server" \
  --display-name "MyMCPServer" \
  --record-type MCP \
  --descriptors '{"mcpServer": {"data": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"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 "MyMCPServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

AWS Kit SDK

Exemple
AWS Agent Registry namespace
import boto3
import json

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

server_content = json.dumps({
    "name": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    displayName='MyMCPServer',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11'
        }
    },
    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": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='MyMCPServer',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'inlineContent': server_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Note

Dans l'agent-registryespace de noms, name se trouve la clé unique au sein d'un registre (name+ la recordVersion combinaison doit être unique). À utiliser displayName pour l'étiquette lisible par l'homme. La descriptors structure est plate et saisie par type de descripteur principal (mcpServer,, a2aAgentCardagentSkillsDefinition,custom) ; les schemaVersion champsinlineContent/précédents sont renommés endata/. dataSchemaVersion

Répertorier les enregistrements du

Console

Exemple
AWS Agent Registry namespace

  1. Ouvrez la page détaillée du registre dans la console AWS Agent Registry.

  2. La section Enregistrements du registre affiche :

    1. Compteurs récapitulatifs de l'état  : total soumis, en attente d'approbation, approuvé, obsolète, rejeté.

    2. Tableau des enregistrements avec colonnes : Nom, Nom d'affichage, Description, État, Type d'enregistrement, ARN de l'enregistrement, Dernière mise à jour.

  3. Utilisez la barre de recherche d'enregistrements pour filtrer par nom.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Ouvrez la page détaillée du registre dans la Bedrock-AgentCore console.

  2. La section Enregistrements du registre affiche :

    1. Compteurs récapitulatifs de l'état  : total soumis, en attente d'approbation, approuvé, obsolète, rejeté.

    2. Tableau des enregistrements avec colonnes : Nom, Description, État, Type d'enregistrement, ARN de l'enregistrement, Dernière mise à jour.

  3. Utilisez la barre de recherche d'enregistrements pour filtrer par nom.

  4. Utilisez la liste déroulante Mettre à jour le statut pour effectuer des modifications d'état en bloc sur les enregistrements sélectionnés.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS Kit SDK

Exemple
AWS Agent Registry namespace
import boto3

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

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['status']} - {record['recordType']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['name']} - {record['status']} - {record['descriptorType']}")
Note

Dans l'agent-registryespace de noms, ListRegistryRecords accepte un filters paramètre structuré (une liste d'{"name": "<dotted.path>", "values": […​]}entrées) au lieu de paramètres de requête discrets par champ. Noms de filtres pris en charge : namestatus, etrecordType.

Afficher les détails de l'enregistrement

Console

Exemple
AWS Agent Registry namespace

  1. Sur la page détaillée du registre de la console AWS Agent Registry, choisissez un nom d'enregistrement dans la table des enregistrements.

  2. La page des détails de l'enregistrement affiche :

    1. Section des détails de l'enregistrement : nom, nom d'affichage, description, ARN de l'enregistrement, statut (affiché sous forme de badge à côté du nom de l'enregistrement), version, date de dernière mise à jour, type d'enregistrement, numéro d'enregistrement, date de création.

    2. Section de configuration de la synchronisation (si configurée) : type de synchronisation, URL source et détails du fournisseur d'informations d'identification (ARN du rôle IAM, ARN du service, de la région ou du fournisseur OAuth, type d'autorisation, étendues, paramètres personnalisés).

    3. Section de configuration du protocole : contenu du descripteur affiché au format JSON (par exemple, « Carte d'agent » pour les enregistrements A2A, « Serveur » et « Outils » pour les enregistrements MCP).

    4. Section Tags : affiche les balises associées à l'enregistrement sous forme de tableau clé-valeur. Pour ajouter, supprimer ou modifier des balises, choisissez Modifier dans cette section pour ouvrir la page Modifier les balises.

  3. Actions disponibles :

    1. Liste déroulante de l'état des mises à jour : Soumettre pour approbation, Approuver, Rejeter ou Déprécier.

    2. Bouton Gérer : choisissez Modifier pour modifier l'enregistrement, Supprimer pour le supprimer définitivement ou Synchronisation pour déclencher une nouvelle synchronisation à partir du point de terminaison configuré (enregistrements MCP et Agent uniquement). La synchronisation ouvre une boîte de dialogue de confirmation ; l'enregistrement passe à l'état MISE À JOUR pendant la synchronisation.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Sur la page détaillée du registre de la Bedrock-AgentCore console, choisissez un nom d'enregistrement dans la table des enregistrements.

  2. La page des détails de l'enregistrement affiche :

    1. Section des détails de l'enregistrement : nom, description, ARN de l'enregistrement, statut (affiché sous forme de badge à côté du nom de l'enregistrement), version, date de dernière mise à jour, type d'enregistrement, numéro d'enregistrement, date de création.

    2. Section de configuration de la synchronisation (si configurée) : type de synchronisation, URL source et détails du fournisseur d'informations d'identification (ARN du rôle IAM, ARN du service, de la région ou du fournisseur OAuth, type d'autorisation, étendues, paramètres personnalisés).

    3. Section de configuration du protocole : contenu du descripteur affiché au format JSON (par exemple, « Carte d'agent » pour les enregistrements A2A, « Serveur » et « Outils » pour les enregistrements MCP).

  3. Actions disponibles :

    1. Bouton de synchronisation (enregistrements MCP et Agent uniquement) : déclenche une nouvelle synchronisation à partir du point de terminaison configuré. Ouvre une boîte de dialogue de confirmation avant de poursuivre. L'enregistrement passe au statut UPDATE lors de la synchronisation.

    2. Liste déroulante de l'état des mises à jour : Soumettre pour approbation, Approuver, Rejeter ou Déprécier.

    3. Three-dot menu () — Modifier ou supprimer.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

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

AWS Kit SDK

Exemple
AWS Agent Registry namespace
import boto3

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

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name (dedup key): {response['name']}")
print(f"Display Name: {response['displayName']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Record Type: {response['recordType']}")
print(f"Version: {response['recordVersion']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name: {response['name']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Descriptor Type: {response['descriptorType']}")
print(f"Version: {response['recordVersion']}")

Mettre à jour un enregistrement de registre

Console

Exemple
AWS Agent Registry namespace

  1. Sur la page détaillée de l'enregistrement de la console AWS Agent Registry, choisissez Gérer, puis Modifier.

  2. Sur la page Modifier l'enregistrement, mettez à jour l'une des options suivantes :

    1. Nom, Nom d'affichage, Description, Version de l'enregistrement sous Détails de l'enregistrement.

    2. Type d'enregistrement et descripteur  : modifiez la forme du and/or descripteur de type sémantique si nécessaire. Pour modifier le type, vous devrez peut-être sélectionner un nouveau descripteur et saisir à nouveau son contenu.

  3. (enregistrements MCP et Agent uniquement) Sous Synchroniser depuis le terminal, configurez éventuellement la synchronisation :

    Vous pouvez mettre à jour les enregistrements par synchronisation, qu'ils aient été créés à l'origine par synchronisation ou non. Lorsque la synchronisation est déclenchée lors d'une mise à jour, l'enregistrement passe au statut MISE À JOUR. En cas de succès, une nouvelle version de l'enregistrement est créée avec le statut BROUILLON. En cas d'échec, l'enregistrement passe au statut UPDATE_FAILED avec les détails de l'erreur dans le champ Raison du statut. Les données synchronisées remplacent le nom, la description, la version, les définitions d'outils et les définitions de serveur de l'enregistrement par les valeurs trouvées à la source, mais ne modifient pas les champs que la source ne fournit pas. Un administrateur ou un curateur doit revoir et approuver le nouveau brouillon pour qu'il soit visible dans les résultats de recherche. D'ici là, la révision approuvée précédente (le cas échéant) reste consultable. Pour plus d'informations sur le comportement des révisions doubles, voir Cycle de vie des enregistrements.

    1. Entrez une URL de point de terminaison pour activer la synchronisation. Les champs de type d'informations d'identification apparaissent lorsqu'un point de terminaison est fourni. Si la synchronisation est déjà configurée pour l'enregistrement, les champs du point de terminaison et du fournisseur d'informations d'identification sont préremplis avec la configuration existante.

    2. Choisissez un type d'identification (IAM, OAuth ou None) et remplissez les champs obligatoires. Si l'enregistrement a déjà été configuré avec un fournisseur d'informations d'identification, les valeurs existantes sont préremplies.

    3. Sélectionnez Re-sync depuis le point de terminaison pour déclencher une nouvelle synchronisation lors de l'enregistrement. L'enregistrement passe au statut UPDATE lors de la synchronisation.

    4. Pour supprimer la synchronisation, cliquez sur le bouton Effacer à côté du champ de point de terminaison. Cela réinitialise le point de terminaison et tous les champs d'identification.

  4. Sous Configuration de l'enregistrement, mettez à jour les définitions de l'enregistrement dans l'éditeur JSON.

    1. Vous pouvez configurer le point de terminaison pour la synchronisation et modifier manuellement les définitions de l'enregistrement. Lorsque la synchronisation est déclenchée, le registre extrait les dernières métadonnées depuis le point de terminaison et met à jour le nom, la description, la version, les définitions d'outils et les définitions de serveur de l'enregistrement avec les valeurs trouvées à la source, en prévalant sur toute modification manuelle de ces champs. Les champs que la source ne fournit pas ne sont pas modifiés.

  5. La console valide votre JSON par rapport au schéma officiel et affiche les erreurs en ligne à l'aide d'un bouton Diagnostiquer avec Amazon Q.

  6. Choisissez-en parmi :

    1. Enregistrer les modifications  : enregistre l'enregistrement en tant que brouillon.

    2. Enregistrer et soumettre pour approbation  : enregistre et soumet en une seule étape.

Une bannière de réussite confirme : « [Nom] a été mis à jour et soumis pour approbation avec succès. »

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Sur la page détaillée de l'enregistrement de la Bedrock-AgentCore console, choisissez le menu à trois points (), puis choisissez Modifier.

  2. Sur la page Modifier l'enregistrement, mettez à jour l'une des options suivantes :

    1. Nom, description, version de l'enregistrement sous Détails de l'enregistrement.

    2. Type d'enregistrement  : modifiez le type de protocole si nécessaire.

  3. (enregistrements MCP et Agent uniquement) Sous Synchroniser depuis le terminal, configurez éventuellement la synchronisation :

    Vous pouvez mettre à jour les enregistrements par synchronisation, qu'ils aient été créés à l'origine par synchronisation ou non. Lorsque la synchronisation est déclenchée lors d'une mise à jour, l'enregistrement passe au statut MISE À JOUR. En cas de succès, une nouvelle version de l'enregistrement est créée avec le statut BROUILLON. En cas d'échec, l'enregistrement passe au statut UPDATE_FAILED avec les détails de l'erreur dans le champ Raison du statut. Les données synchronisées remplacent le nom, la description, la version, les définitions d'outils et les définitions de serveur de l'enregistrement par les valeurs trouvées à la source, mais ne modifient pas les champs que la source ne fournit pas. Un administrateur ou un curateur doit revoir et approuver le nouveau brouillon pour qu'il soit visible dans les résultats de recherche. D'ici là, la révision approuvée précédente (le cas échéant) reste consultable. Pour plus d'informations sur le comportement des révisions doubles, voir Cycle de vie des enregistrements.

    1. Entrez une URL de point de terminaison pour activer la synchronisation. Les champs de type d'informations d'identification apparaissent lorsqu'un point de terminaison est fourni. Si la synchronisation est déjà configurée pour l'enregistrement, les champs du point de terminaison et du fournisseur d'informations d'identification sont préremplis avec la configuration existante.

    2. Choisissez un type d'identification (IAM, OAuth ou None) et remplissez les champs obligatoires. Si l'enregistrement a déjà été configuré avec un fournisseur d'informations d'identification, les valeurs existantes sont préremplies.

    3. Sélectionnez Re-sync depuis le point de terminaison pour déclencher une nouvelle synchronisation lors de l'enregistrement. L'enregistrement passe à l'état MISE À JOUR lors de la synchronisation.

    4. Pour supprimer la synchronisation, cliquez sur le bouton Effacer à côté du champ de point de terminaison. Cela réinitialise le point de terminaison et tous les champs d'identification.

  4. Sous Configuration de l'enregistrement, mettez à jour les définitions de l'enregistrement dans l'éditeur JSON.

    1. Vous pouvez configurer le point de terminaison pour la synchronisation et modifier manuellement les définitions de l'enregistrement. Lorsque la synchronisation est déclenchée, le registre extrait les dernières métadonnées depuis le point de terminaison et met à jour le nom, la description, la version, les définitions d'outils et les définitions de serveur de l'enregistrement avec les valeurs trouvées à la source, en prévalant sur toute modification manuelle de ces champs. Les champs que la source ne fournit pas ne sont pas modifiés.

  5. La console valide votre JSON par rapport au schéma officiel et affiche les erreurs en ligne à l'aide d'un bouton Diagnostiquer avec Amazon Q.

  6. Choisissez-en parmi :

    1. Enregistrer les modifications — Enregistre l'enregistrement en tant que brouillon.

    2. Enregistrer et soumettre pour approbation  : enregistre et soumet en une seule étape.

Une bannière de réussite confirme : « [Nom] a été mis à jour et soumis pour approbation avec succès. »

Note

Les balises ne sont pas modifiées depuis la page Modifier l'enregistrement de la console AWS Agent Registry. Pour modifier les balises, accédez à la page détaillée de l'enregistrement, choisissez Modifier dans la section Balises, ajoutez ou supprimez des balises sur la page Modifier les balises, puis choisissez Enregistrer les modifications. (Les balises ne sont prises en charge que dans la console AWS Agent Registry.)

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --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(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")

Soumettre un enregistrement pour approbation

Console

À partir de la page détaillée de l'enregistrement -

  1. Choisissez le menu déroulant État de la mise à jour

  2. Choisissez ensuite Soumettre pour approbation.

    1. Vous pouvez également utiliser Créer et soumettre pour approbation ou Enregistrer et soumettre pour approbation lors de la création ou de la modification.

Note

Si la Auto-Approval configuration du registre est définie sur TRUE, la soumission d'un enregistrement pour approbation l'approuve automatiquement. Sinon, si la Auto-Approval configuration est définie sur FALSE, l'enregistrement passe au statut « En attente d'approbation » et attend que le conservateur l'approuve ou le rejette. En outre, une EventBridge notification Amazon est déclenchée indiquant qu'un nouvel enregistrement a été demandé pour approbation.

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

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"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
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"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED

Supprimer un enregistrement de registre

Console

Exemple
AWS Agent Registry namespace

  1. Sur la page détaillée de l'enregistrement de la console AWS Agent Registry, choisissez Gérer, puis Supprimer.

  2. Confirmez la suppression en saisissant delete lorsque vous y êtes invité.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Sur la page détaillée de l'enregistrement de la Bedrock-AgentCore console, choisissez le menu à trois points (), puis choisissez Supprimer.

  2. Confirmez la suppression en saisissant delete lorsque vous y êtes invité.

La suppression est définitive et ne peut pas être annulée.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

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

AWS Kit SDK

Exemple
AWS Agent Registry namespace
import boto3

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

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")

Validation du schéma

Lorsque vous créez ou modifiez un enregistrement, la console et l'API valident la configuration de votre protocole par rapport au schéma officiel du type d'enregistrement sélectionné. Vous trouverez plus de détails sur les validations dans Types d'enregistrements pris en charge.