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-agentcore`espace 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](registry-faq.md). ## Création d'un enregistrement de registre ### Console **Example** 1. Ouvrez la page détaillée du registre dans la console [AWS Agent Registry](https://console.aws.amazon.com/agent-registry/home?region=us-east-1#). 1. Dans la ** section Enregistrements ** du registre, choisissez ** Créer un enregistrement**. 1. 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 ](registry-sync-records.md) pour plus de détails. 1. **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. 1. Entrez l'**URL du ** point de terminaison. Il doit s'agir d'une URL HTTPS valide. 1. 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-registry``execute-api`,`lambda`). Spécifiez éventuellement une ** région ** pour la signature. 1. **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. 1. **Aucune ** — Aucune autorisation (pour les terminaux publics). 1. 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](registry-troubleshooting.md#registry-troubleshooting-sync-errors). 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. ](registry-sync-records.md) **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. 1. (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. 1. (Facultatif) ** Dans Description**, entrez une description pour l'enregistrement. La description peut comprendre de 1 à 4 096 caractères. 1. Dans Version de l'**enregistrement**, entrez un identifiant de version pour l'enregistrement (par exemple, `1.0.0` ou`v2.1`). 1. 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. 1. 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é ** 1. 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. ](registry-supported-record-types.md) 1. (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. 1. Choisissez-en parmi : 1. **Créer en tant que brouillon ** — Crée l'enregistrement au statut Brouillon. 1. **Créer et soumettre pour approbation ** : crée l'enregistrement et le soumet immédiatement pour approbation. 1. Ouvrez la page détaillée du registre dans la [ Bedrock-AgentCore console](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#). 1. Dans la ** section Enregistrements ** du registre, choisissez ** Créer un enregistrement**. 1. 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 ](registry-sync-records.md) pour plus de détails. 1. **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. 1. Entrez l'**URL du ** point de terminaison. Il doit s'agir d'une URL HTTPS valide. 1. 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-agentcore``execute-api`,`lambda`). Spécifiez éventuellement une ** région ** pour la signature. 1. **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. 1. **Aucune ** — Aucune autorisation (pour les terminaux publics). 1. 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](registry-troubleshooting.md#registry-troubleshooting-sync-errors). 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. ](registry-sync-records.md) **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. 1. **Description ** (facultatif) : de 1 à 4 096 caractères. 1. **Version de l'enregistrement ** — Spécifiez la version de cet enregistrement (par exemple, 1.0.0, v2.1). 1. Sous Type d'**enregistrement**, sélectionnez l'une des options suivantes : ** MCP**, ** Agent**, ** Agent Skills ** ou ** Custom**. 1. 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. 1. 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. 1. Choisissez-en parmi : 1. **Créer en tant que brouillon ** — Crée l'enregistrement au statut Brouillon. 1. **Créer et soumettre pour approbation ** : crée l'enregistrement et le soumet immédiatement pour approbation. ### AWS INTERFACE DE LIGNE DE COMMANDE (CLI) **Example** ``` aws agent-registry-control create-registry-record \ --registry-id \ --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 ``` ``` aws bedrock-agentcore-control create-registry-record \ --registry-id \ --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 **Example** ``` 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='', 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 ``` ``` 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='', 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-registry`espace 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`,, `a2aAgentCard``agentSkillsDefinition`,`custom`) ; les `schemaVersion` champs`inlineContent`/précédents sont renommés en`data`/. `dataSchemaVersion` ## Répertorier les enregistrements du ### Console **Example** 1. Ouvrez la page détaillée du registre dans la console [AWS Agent Registry](https://console.aws.amazon.com/agent-registry/home?region=us-east-1#). 1. La ** section Enregistrements du ** registre affiche : 1. **Compteurs récapitulatifs de l'état ** : total soumis, en attente d'approbation, approuvé, obsolète, rejeté. 1. **Tableau des enregistrements ** avec colonnes : Nom, Nom d'affichage, Description, État, Type d'enregistrement, ARN de l'enregistrement, Dernière mise à jour. 1. Utilisez la ** barre ** de recherche d'enregistrements pour filtrer par nom. 1. Ouvrez la page détaillée du registre dans la [ Bedrock-AgentCore console](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#). 1. La ** section Enregistrements du ** registre affiche : 1. **Compteurs récapitulatifs de l'état ** : total soumis, en attente d'approbation, approuvé, obsolète, rejeté. 1. **Tableau des enregistrements ** avec colonnes : Nom, Description, État, Type d'enregistrement, ARN de l'enregistrement, Dernière mise à jour. 1. Utilisez la ** barre ** de recherche d'enregistrements pour filtrer par nom. 1. 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) **Example** ``` aws agent-registry-control list-registry-records \ --registry-id "" \ --region us-east-1 ``` ``` aws bedrock-agentcore-control list-registry-records \ --registry-id "" \ --region us-east-1 ``` ### AWS Kit SDK **Example** ``` import boto3 client = boto3.client('agent-registry-control') response = client.list_registry_records( registryId='' ) for record in response['registryRecords']: print(f"{record['displayName']} ({record['name']}) - {record['status']} - {record['recordType']}") ``` ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.list_registry_records( registryId='' ) for record in response['registryRecords']: print(f"{record['name']} - {record['status']} - {record['descriptorType']}") ``` **Note** Dans l'`agent-registry`espace de noms, `ListRegistryRecords` accepte un `filters` paramètre structuré (une liste d'`{"name": "", "values": […​]}`entrées) au lieu de paramètres de requête discrets par champ. Noms de filtres pris en charge : `name``status`, et`recordType`. ## Afficher les détails de l'enregistrement ### Console **Example** 1. Sur la page détaillée du registre de la console [AWS Agent Registry](https://console.aws.amazon.com/agent-registry/home?region=us-east-1#), choisissez un nom d'enregistrement dans la table des enregistrements. 1. 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. 1. ****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). 1. ****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). 1. ****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. 1. Actions disponibles : 1. **Liste ** déroulante de l'état des mises à jour : Soumettre pour approbation, Approuver, Rejeter ou Déprécier. 1. ****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. 1. Sur la page détaillée du registre de la [ Bedrock-AgentCore console](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#), choisissez un nom d'enregistrement dans la table des enregistrements. 1. 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. 1. ****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). 1. ****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). 1. 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. 1. **Liste ** déroulante de l'état des mises à jour : Soumettre pour approbation, Approuver, Rejeter ou Déprécier. 1. **Three-dot menu () ** — Modifier ou supprimer. ### AWS INTERFACE DE LIGNE DE COMMANDE (CLI) **Example** ``` aws agent-registry-control get-registry-record \ --registry-id "" \ --record-id "" \ --region us-east-1 ``` ``` aws bedrock-agentcore-control get-registry-record \ --registry-id "" \ --record-id "" \ --region us-east-1 ``` ### AWS Kit SDK **Example** ``` import boto3 client = boto3.client('agent-registry-control') response = client.get_registry_record( registryId='', 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']}") ``` ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.get_registry_record( registryId='', 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 **Example** 1. Sur la page détaillée de l'enregistrement de la console [AWS Agent Registry](https://console.aws.amazon.com/agent-registry/home?region=us-east-1#), choisissez ** Gérer**, puis ** Modifier**. 1. 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. 1. **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. 1. (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 ](registry-record-lifecycle.md) 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. 1. 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. 1. 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. 1. 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. 1. 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. 1. 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. 1. Choisissez-en parmi : 1. **Enregistrer les modifications ** : enregistre l'enregistrement en tant que brouillon. 1. **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. » 1. Sur la page détaillée de l'enregistrement de la [ Bedrock-AgentCore console](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#), choisissez le menu à trois points (), puis choisissez ** Modifier**. 1. 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. 1. **Type d'enregistrement ** : modifiez le type de protocole si nécessaire. 1. (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 ](registry-record-lifecycle.md) 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. 1. 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. 1. 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. 1. 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. 1. 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. 1. 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. 1. Choisissez-en parmi : 1. **Enregistrer les modifications ** — Enregistre l'enregistrement en tant que brouillon. 1. **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) **Example** ``` aws agent-registry-control update-registry-record \ --registry-id "" \ --record-id "" \ --description "Updated description" \ --region us-east-1 ``` ``` aws bedrock-agentcore-control update-registry-record \ --registry-id "" \ --record-id "" \ --description "Updated description" \ --region us-east-1 ``` ### AWS Kit SDK **Example** ``` import boto3 client = boto3.client('agent-registry-control') response = client.update_registry_record( registryId='', recordId='', description='Updated description' ) print(f"Updated: {response['name']} - Status: {response['status']}") ``` ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.update_registry_record( registryId='', 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 1. 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) **Example** ``` aws agent-registry-control submit-registry-record-for-approval \ --registry-id "" \ --record-id "" \ --region us-east-1 ``` ``` aws bedrock-agentcore-control submit-registry-record-for-approval \ --registry-id "" \ --record-id "" \ --region us-east-1 ``` ### AWS Kit SDK **Example** ``` import boto3 client = boto3.client('agent-registry-control') response = client.submit_registry_record_for_approval( registryId='', recordId='' ) print(f"Status: {response['status']}") # PENDING_APPROVAL or APPROVED ``` ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.submit_registry_record_for_approval( registryId='', recordId='' ) print(f"Status: {response['status']}") # PENDING_APPROVAL or APPROVED ``` ## Supprimer un enregistrement de registre ### Console **Example** 1. Sur la page détaillée de l'enregistrement de la console [AWS Agent Registry](https://console.aws.amazon.com/agent-registry/home?region=us-east-1#), choisissez ** Gérer**, puis ** Supprimer**. 1. Confirmez la suppression en saisissant `delete` lorsque vous y êtes invité. 1. Sur la page détaillée de l'enregistrement de la [ Bedrock-AgentCore console](https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1#), choisissez le menu à trois points (), puis choisissez ** Supprimer**. 1. 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) **Example** ``` aws agent-registry-control delete-registry-record \ --registry-id "" \ --record-id "" \ --region us-east-1 ``` ``` aws bedrock-agentcore-control delete-registry-record \ --registry-id "" \ --record-id "" \ --region us-east-1 ``` ### AWS Kit SDK **Example** ``` import boto3 client = boto3.client('agent-registry-control') response = client.delete_registry_record( registryId='', recordId='' ) print("Record deleted successfully") ``` ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.delete_registry_record( registryId='', 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 ](registry-supported-record-types.md) pris en charge.