View a markdown version of this page

Création et gestion des enregistrements - Amazon Bedrock AgentCore
Création d'un enregistrement de registreLister les enregistrements du registreAfficher les détails de l'enregistrementMettre à jour un enregistrement de registreSoumettre un enregistrement pour approbationSupprimer un enregistrement de registreValidation du schéma

Création et gestion des enregistrements

Migration d'espaces de noms à venir

AWS Le registre des agents est actuellement en version préliminaire publique sous l'espace de noms bedrock-agentcore. À compter du 6 août 2026, le service passe à l'espace de noms agent-registry. Si vous utilisez le registre des AWS agents, vous devez mettre à jour vos points de terminaison, vos politiques IAM, vos clients SDK, vos scripts CLI et vos données de registre. Pour plus d'informations sur la migration depuis la version préliminaire publique, consultez le guide complet de migration du registre.

Création d'un enregistrement de registre

Console

  1. Ouvrez la page détaillée du registre.

  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ère les métadonnées depuis la source. Disponible uniquement pour les types d'enregistrement MCP et Agent. Pour mettre à jour l'enregistrement après le changement de source, vous devez déclencher manuellement la synchronisation. Voir Synchroniser des 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. Sous 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. Sous Type d'identifiant, choisissez la manière dont le registre autorise le point de terminaison :

    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 entrez un ARN du 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 points de terminaison publics).

  4. Choisissez Créer un registre.

    L'enregistrement est créé dans le statut CREATING. Le registre se connecte au point de terminaison, extrait les métadonnées et renseigne les descripteurs de l'enregistrement. Une fois la synchronisation terminée, l'enregistrement passe au format DRAFT. Si la synchronisation échoue, l'enregistrement passe au statut CREATE_FAILED avec les détails de l'erreur disponibles dans le champ Motif du statut sur la page détaillée de l'enregistrement. Pour résoudre les problèmes, consultez la section Enregistrer les erreurs de synchronisation. 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 Re-sync depuis le point de terminaison lors de la modification.

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

Manuel

  1. Sous Détails de l'enregistrement, entrez :

    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) — 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, activez l'option 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 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)

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

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

Lister les enregistrements du registre

Console

  1. Ouvrez la page détaillée du registre.

  2. La section des enregistrements du registre affiche :

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

    2. Table des enregistrements avec colonnes : nom, description, statut, 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 le menu déroulant État de mise à jour pour modifier le statut en bloc des enregistrements sélectionnés.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS Kit SDK

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']}")

Afficher les détails de l'enregistrement

Console

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

  2. La page détaillée 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, ID 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 de subvention, étendues, paramètres personnalisés).

    3. Section de configuration du protocole — Le contenu du descripteur est affiché sous forme de JSON formaté (par exemple, « carte 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 continuer. L'enregistrement passe au statut MISE À JOUR lors de la synchronisation.

    2. Liste déroulante du statut de mise à jour : Soumettre pour approbation, approuver, rejeter ou annuler.

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

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

aws bedrock-agentcore-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS Kit SDK

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

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

  2. Sur la page Modifier l'enregistrement, mettez à jour l'un des éléments suivants :

    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 point de terminaison, configurez éventuellement la synchronisation :

    Vous pouvez mettre à jour les enregistrements par synchronisation, qu'ils aient été créés à l'origine avec synchronisation ou non. Lorsque la synchronisation est déclenchée pendant une mise à jour, l'enregistrement passe au statut MISE À JOUR. En cas de succès, une nouvelle version d'enregistrement est créée au statut DRAFT. En cas d'échec, l'enregistrement passe au statut UPDATE_FAILED avec les détails de l'erreur dans le champ Motif 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 examiner 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 de double révision, consultez la section Cycle de vie des enregistrements.

    1. Entrez l'URL du point de terminaison pour activer la synchronisation. Les champs de type 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'identifiant (IAM, OAuth ou None) et renseignez 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 un point de terminaison pour déclencher une nouvelle synchronisation lors de l'enregistrement. L'enregistrement passe au statut MISE À JOUR lors de la synchronisation.

    4. Pour supprimer la synchronisation, cliquez sur le bouton Effacer situé à côté du champ du 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 récupère les dernières métadonnées du point de terminaison et met à jour le nom, la description, la version, les définitions des outils et les définitions du serveur de l'enregistrement avec les valeurs trouvées à la source, l'emportant 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 sous forme de brouillon.

    2. Enregistrer et soumettre pour approbation — Sauvegarde et envoi en une seule étape.

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

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS Kit SDK

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 envoyer pour approbation ou Enregistrer et envoyer pour approbation lors de la création ou de la modification.

Note

Si la Auto-Approval configuration du registre est définie sur VRAI, le fait de soumettre 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 curateur 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)

aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS Kit SDK

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

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

  2. Confirmez la suppression en tapant « supprimer » lorsque vous y êtes invité

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

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

aws bedrock-agentcore-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS Kit SDK

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 la section Types d'enregistrements pris en charge.