View a markdown version of this page

Synchroniser les enregistrements provenant de sources externes - Base rocheuse de l'Amazonie AgentCore
Vue d’ensembleSynchronisation depuis un serveur MCP publicSynchroniser depuis un serveur OAuth-protected MCPSynchroniser depuis un serveur IAM-protected MCPSynchronisation à partir d'une carte d'agent A2ADéclencher la synchronisation sur un enregistrement existant

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.

Synchroniser les enregistrements provenant de sources externes

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.

Vue d’ensemble

AWS Le registre des agents peut synchroniser automatiquement les métadonnées des enregistrements provenant de sources externes en se connectant à l'URL fournie avec des informations d'identification sortantes. Lorsque vous fournissez une URL et un fournisseur d'informations d'identification (facultatif pour les ressources publiques qui ne nécessitent aucune autorisation d'accès), le système extrait les définitions du serveur et de l'outil et remplit les descripteurs de l'enregistrement conformément aux schémas de protocole officiels. Il met également à jour le nom, la description et la version de l'enregistrement si ces valeurs se trouvent à la source.

Synchronisation depuis un serveur MCP public

Pour les serveurs MCP publics qui ne nécessitent ni authentification ni autorisation :

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 Synchroniser depuis le point de terminaison.

  4. Sous Détails de l'enregistrement, dans Type, choisissez MCP. Le descripteur est défini sur le serveur MCP.

  5. Pour Endpoint, entrez l'URL du serveur MCP public (par exemple,https://knowledge-mcp.global.api.aws). Il doit s'agir d'une URL HTTPS valide.

  6. Sous Type d'identification, choisissez Aucune.

  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 Créer un registre.

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 Synchroniser depuis le point de terminaison.

  4. Sous Détails de l'enregistrement, choisissez MCP comme type d'enregistrement.

  5. Pour Endpoint, entrez l'URL du serveur MCP public (par exemple,https://knowledge-mcp.global.api.aws). Il doit s'agir d'une URL HTTPS valide.

  6. Sous Type d'identification, choisissez Aucune.

  7. Choisissez Créer un registre.

L'enregistrement est créé avec le statut CREATION. Le registre se connecte au point de terminaison, extrait les définitions du serveur et de l'outil et renseigne 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. Pour résoudre les problèmes, consultez la section Erreurs de synchronisation des enregistrements.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "aws-knowledge-server" \
  --display-name "AWS Knowledge Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "https://knowledge-mcp.global.api.aws"
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "aws-knowledge-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "https://knowledge-mcp.global.api.aws"
    }
  }' \
  --region us-east-1

AWS Kit SDK

Exemple
AWS Agent Registry namespace
import boto3

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

response = client.create_registry_record(
    registryId='<registryId>',
    name='aws-knowledge-server',
    displayName='AWS Knowledge Server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'source': {
                'fromUrl': {
                    'url': 'https://knowledge-mcp.global.api.aws'
                }
            }
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.create_registry_record(
    registryId='<registryId>',
    name='aws-knowledge-server',
    descriptorType='MCP',
    synchronizationType='URL',
    synchronizationConfiguration={
        'fromUrl': {
            'url': 'https://knowledge-mcp.global.api.aws'
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Note

Dans l'agent-registryespace de noms, la configuration de synchronisation se déplace à l'intérieur de chaque descripteur en tant que source (prise en charge uniquement sur mcpServer les descripteurs a2aAgentCard principaux). Les synchronizationConfiguration champssynchronizationType/de niveau supérieur n'existent plus.

L'enregistrement est créé avec le statut CREATION. La durée de synchronisation varie de quelques secondes à quelques minutes, en fonction de la taille des métadonnées. Une fois la synchronisation terminée, il passe à DRAFT avec les descripteurs extraits du serveur MCP, y compris les définitions du serveur et des outils.

Synchroniser depuis un serveur OAuth-protected MCP

Lorsque le serveur MCP est protégé par OAuth, vous devez créer un client M2M sur le serveur d'autorisation, puis configurer un fournisseur d'informations d'identification à partir d' AgentCore Identity contenant l'ID client et le secret autorisé pour appeler le serveur MCP. Une fois que vous avez le fournisseur d'informations d'identification, vous pouvez le fournir au registre pour la synchronisation :

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 Synchroniser depuis le point de terminaison.

  4. Sous Détails de l'enregistrement, dans Type, choisissez MCP. Le descripteur est défini sur le serveur MCP.

  5. Pour Endpoint, entrez l'URL du serveur OAuth-protected MCP. Il doit s'agir d'une URL HTTPS valide.

  6. Sous Type d'identification, choisissez OAuth.

  7. Pour Fournisseur d'informations d'identification, sélectionnez ou entrez l'ARN du fournisseur d'informations d'identification dans Identity. AgentCore

  8. (Facultatif) Développez la configuration supplémentaire pour configurer :

    1. Portées  : étendues OAuth à demander lors de l'obtention d'un jeton d'accès.

    2. Paramètres personnalisés  : paramètres clé-valeur supplémentaires pour la demande de jeton OAuth.

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

  10. Choisissez Créer un registre.

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 Synchroniser depuis le point de terminaison.

  4. Sous Détails de l'enregistrement, choisissez MCP comme type d'enregistrement.

  5. Pour Endpoint, entrez l'URL du serveur OAuth-protected MCP. Il doit s'agir d'une URL HTTPS valide.

  6. Sous Type d'identification, choisissez OAuth.

  7. Pour Fournisseur d'informations d'identification, sélectionnez ou entrez l'ARN du fournisseur d'informations d'identification dans Identity. AgentCore

  8. (Facultatif) Développez la configuration supplémentaire pour configurer :

    1. Portées  : étendues OAuth à demander lors de l'obtention d'un jeton d'accès.

    2. Paramètres personnalisés  : paramètres clé-valeur supplémentaires pour la demande de jeton OAuth.

  9. Choisissez Créer un registre.

L'enregistrement est créé avec le statut CREATION. Le registre se connecte au terminal à l'aide des informations d'identification OAuth, extrait les définitions du serveur et de l'outil 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. Pour résoudre les problèmes, consultez la section Erreurs de synchronisation des enregistrements.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "oauth-mcp-server" \
  --display-name "OAuth MCP Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "$MCP_OAUTH_URL",
          "credentialProviderConfigurations": [
            {
              "credentialProviderType": "OAUTH",
              "credentialProvider": {
                "oauthCredentialProvider": {
                  "providerArn": "$OAUTH_PROVIDER_ARN",
                  "grantType": "CLIENT_CREDENTIALS"
                }
              }
            }
          ]
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "oauth-mcp-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "$MCP_OAUTH_URL",
        "credentialProviderConfigurations":
        [
            {
                "credentialProviderType": "OAUTH",
                "credentialProvider":
                {
                    "oauthCredentialProvider":
                    {
                        "providerArn": "$OAUTH_PROVIDER_ARN",
                        "grantType": "CLIENT_CREDENTIALS"
                    }
                }
            }
        ]
    }
  }' \
  --region us-east-1

Autorisations IAM supplémentaires requises :

Note

Ces autorisations IAM liées à la synchronisation autorisent l'identité de la charge de travail et les ressources du fournisseur d'informations d'identification OAuth gérées par Identity. AgentCore Ces ressources restent intentionnellement dans l'bedrock-agentcoreespace de noms. Cette politique ne change donc pas.

{
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "bedrock-agentcore:GetWorkloadAccessToken"
            ],
            "Resource":
            [
                "arn:aws:bedrock-agentcore:*:<account>:workload-identity-directory/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action":
            [
                "bedrock-agentcore:GetResourceOauth2Token"
            ],
            "Resource":
            [
                "arn:aws:bedrock-agentcore:<region>:<account>:token-vault/default/oauth2credentialprovider/<oauthProviderName>"
            ]
        }
    ]
}
Note

Étendez la GetResourceOauth2Token déclaration à l'ARN du fournisseur d'informations d'identification OAuth spécifique dont le jeton d'accès a besoin pour ce rôle. Évitez les caractères génériques dans le segment fournisseur de l'ARN, par exemple en accordant l'accès à tous les fournisseurs token-vault/ d'token-vault/default/oauth2credentialprovider/informations d'identification OAuth du compte, ce qui peut permettre l'accès aux informations d'identification entre les équipes. Suivez le principe du moindre privilège en nommant le fournisseur spécifique dans le Resource champ, par exemplearn:aws:bedrock-agentcore:<region>:<account>:token-vault/default/oauth2credentialprovider/<oauthProviderName>.

Limites:

  • L'appelant CreateRegistryRecord ou UpdateRegistryRecord doit avoir une identité de charge de travail GetWorkloadAccessToken associée au registre et une GetResourceOauth2Token autorisation sur le fournisseur d'informations d'identification.

  • Le fournisseur d'informations d'identification doit provenir du même compte.

Synchroniser depuis un serveur IAM-protected MCP

Pour les serveurs MCP sur Amazon Bedrock AgentCore Runtime ou Amazon Bedrock AgentCore Gateway, spécifiez un rôle IAM pour la signature SIGv4. Le rôle doit être autorisé à accéder au service cible. Par exemple : bedrock-agentcore:InvokeAgentRuntime ou bedrock-agentcore:InvokeAgentRuntimeForUser sur AgentCore Runtime ; bedrock-agentcore:InvokeGateway sur AgentCore Gateway.

Outre le rôle IAM, vous devez spécifier le service champ pour la signature SIGv4. Si votre MCP s'exécute sur AgentCore Runtime ou AgentCore Gateway, la valeur doit êtreagent-registry. Si votre MCP s'exécute sur Amazon API Gateway, il devrait l'êtreexecute-api, et si votre MCP s'exécute sur AWS Lambda, il devrait l'être. lambda

regionla valeur est facultative. Par défaut, la demande sera signée avec la même région que le 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 Synchroniser depuis le point de terminaison.

  4. Sous Détails de l'enregistrement, dans Type, choisissez MCP. Le descripteur est défini sur le serveur MCP.

  5. Pour Endpoint, entrez l'URL du serveur IAM-protected MCP. Il doit s'agir d'une URL HTTPS valide.

  6. Dans Type d'identification, choisissez IAM.

  7. Pour Role ARN, entrez l'ARN du rôle IAM à assumer pour la signature Sigv4.

  8. Dans Service, entrez le nom du service pour la signature SIGv4 (par exemple, agent-registryexecute-api,lambda).

  9. (Facultatif) Développez la configuration supplémentaire et choisissez une région pour la signature SIGv4. Si elle n'est pas spécifiée, la région du registre est utilisée.

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

  11. Choisissez Créer un registre.

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 Synchroniser depuis le terminal.

  4. Sous Détails de l'enregistrement, choisissez MCP comme type d'enregistrement.

  5. Pour Endpoint, entrez l'URL du serveur IAM-protected MCP. Il doit s'agir d'une URL HTTPS valide.

  6. Dans Type d'identification, choisissez IAM.

  7. Dans Role ARN, entrez l'ARN du rôle IAM à assumer pour la signature Sigv4.

  8. Dans Service, entrez le nom du service pour la signature SIGv4 (par exemple, bedrock-agentcoreexecute-api,lambda).

  9. (Facultatif) Développez la configuration supplémentaire et choisissez une région pour la signature SIGv4. Si elle n'est pas spécifiée, la région du registre est utilisée.

  10. Choisissez Créer un registre.

L'enregistrement est créé avec le statut CREATION. Le registre se connecte au terminal à l'aide des informations d'identification IAM, extrait les définitions du serveur et de l'outil 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. Pour résoudre les problèmes, consultez la section Erreurs de synchronisation des enregistrements.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "gateway-mcp-server" \
  --display-name "Gateway MCP Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "$MCP_IAM_URL",
          "credentialProviderConfigurations": [
            {
              "credentialProviderType": "IAM",
              "credentialProvider": {
                "iamCredentialProvider": {
                  "roleArn": "$IAM_ROLE_ARN",
                  "service": "$SIGNING_SERVICE",
                  "region": "$SIGNING_REGION"
                }
              }
            }
          ]
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "gateway-mcp-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "$MCP_IAM_URL",
        "credentialProviderConfigurations":
        [
            {
                "credentialProviderType": "IAM",
                "credentialProvider":
                {
                    "iamCredentialProvider":
                    {
                        "roleArn": "$IAM_ROLE_ARN",
                        "service": "$SIGNING_SERVICE",
                        "region": "$SIGNING_REGION"
                    }
                }
            }
        ]
    }
  }' \
  --region us-east-1

Autorisations IAM supplémentaires requises :

Note

Cette iam:PassRole politique autorise le registre à transférer un rôle à AgentCore Identity pour la synchronisation sortante. La valeur de iam:PassedToService condition bedrock-agentcore.amazonaws.com fait référence au principal du service AgentCore Identity et ne change pas.

{
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "iam:PassRole"
            ],
            "Resource":
            [
                "arn:aws:iam::<account>:role/<sync-role>"
            ],
            "Condition":
            {
                "StringEquals":
                {
                    "iam:PassedToService": "bedrock-agentcore.amazonaws.com"
                }
            }
        }
    ]
}

Synchronisation à partir d'une carte d'agent A2A

Fournissez l'URL de la carte d'agent ou l'URL de base de l'agent où .well-known/agent-card.json vous pouvez découvrir :

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 Synchroniser depuis le terminal.

  4. Sous Détails de l'enregistrement, dans Type, choisissez Agent. Le descripteur est réglé sur une carte d'agent A2A.

  5. Pour Endpoint, entrez l'URL de la carte d'agent (par exemple,https://agent.example.com/.well-known/agent-card.json). Il doit s'agir d'une URL HTTPS valide.

  6. Dans Type d'identification, choisissez la méthode d'autorisation appropriée :

    1. Aucune — Pour les cartes d'agent accessibles au public.

    2. IAM — Pour les agents hébergés sur AgentCore Runtime ou Gateway. Indiquez l'ARN du rôle et le nom du service.

    3. OAuth — Pour les agents. OAuth-protected Sélectionnez ou saisissez l'ARN du fournisseur d'informations d'identification.

  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 Créer un registre.

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 Synchroniser depuis le terminal.

  4. Dans Détails de l'enregistrement, choisissez Agent comme type d'enregistrement.

  5. Pour Endpoint, entrez l'URL de la carte d'agent (par exemple,https://agent.example.com/.well-known/agent-card.json). Il doit s'agir d'une URL HTTPS valide.

  6. Dans Type d'identification, choisissez la méthode d'autorisation appropriée :

    1. Aucune — Pour les cartes d'agent accessibles au public.

    2. IAM — Pour les agents hébergés sur AgentCore Runtime ou Gateway. Indiquez l'ARN du rôle et le nom du service.

    3. OAuth — Pour les agents. OAuth-protected Sélectionnez ou saisissez l'ARN du fournisseur d'informations d'identification.

  7. Choisissez Créer un registre.

L'enregistrement est créé avec le statut CREATION. Le registre se connecte au terminal, extrait les métadonnées de la carte d'agent 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. Pour résoudre les problèmes, consultez la section Erreurs de synchronisation des enregistrements.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "travel-agent" \
  --display-name "Travel Agent" \
  --record-type AGENT \
  --descriptors '{
    "a2aAgentCard": {
      "source": {
        "fromUrl": {
          "url": "https://agent.example.com/.well-known/agent-card.json"
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "travel-agent" \
  --descriptor-type A2A \
  --synchronization-type URL \
  --synchronization-configuration '{"fromUrl": {"url": "https://agent.example.com/.well-known/agent-card.json"}}' \
  --region us-east-1

Vous pouvez également spécifier des fournisseurs d'informations d'identification pour la synchronisation A2A, par exemple vous pouvez effectuer la synchronisation à partir d'un agent hébergé sur. AgentCore À utiliser agent-registry comme service champ lorsque la cible de synchronisation est un agent hébergé sur AgentCore Runtime ou Gateway.

Exemple
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "a2a_agent_record" \
  --display-name "A2A Agent Record" \
  --record-type AGENT \
  --descriptors "{
    \"a2aAgentCard\": {
      \"source\": {
        \"fromUrl\": {
          \"url\": \"$A2A_URL\",
          \"credentialProviderConfigurations\": [{
            \"credentialProviderType\": \"IAM\",
            \"credentialProvider\": {
              \"iamCredentialProvider\": {
                \"roleArn\": \"$IAM_INVOKER_ROLE\",
                \"service\": \"agent-registry\"
              }
            }
          }]
        }
      }
    }
  }"
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "a2a_agent_record" \
  --descriptor-type A2A \
  --synchronization-type URL \
  --synchronization-configuration "{
    \"fromUrl\": {
        \"url\": \"$A2A_URL\",
        \"credentialProviderConfigurations\": [{
            \"credentialProviderType\": \"IAM\",
            \"credentialProvider\": {
                \"iamCredentialProvider\": {
                    \"roleArn\": \"$IAM_INVOKER_ROLE\",
                    \"service\": \"bedrock-agentcore\"
                }
            }
        }]
    }
  }"

Déclencher la synchronisation sur un enregistrement existant

Console

  1. Ouvrez la page détaillée de l'enregistrement d'un enregistrement MCP ou d'un agent pour lequel la synchronisation est configurée.

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

  2. Dans la boîte de dialogue de confirmation, consultez le message indiquant que la synchronisation ramènera l'enregistrement à l'état de brouillon.

  3. Choisissez Synchroniser pour confirmer.

Vous pouvez également déclencher la synchronisation pendant la modification :

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

  2. Sous Synchroniser depuis le point de terminaison, cochez la case Re-sync depuis le point de terminaison.

  3. Sélectionnez Enregistrer les modifications.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Sur la page détaillée de l'enregistrement de la Bedrock-AgentCore console, cliquez sur le bouton Synchroniser dans les actions d'en-tête.

  2. Dans la boîte de dialogue de confirmation, consultez le message indiquant que la synchronisation ramènera l'enregistrement à l'état de brouillon.

  3. Choisissez Synchroniser pour confirmer.

Vous pouvez également déclencher la synchronisation pendant la modification :

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

  2. Sous Synchroniser depuis le point de terminaison, cochez la case Re-sync depuis le point de terminaison.

  3. Sélectionnez Enregistrer les modifications.

L'enregistrement passe à l'état MISE À JOUR lors de la synchronisation. Une fois terminé, il revient à DRAFT avec les descripteurs mis à jour depuis la source. Si la synchronisation échoue, l'enregistrement passe au statut UPDATE_FAILED avec les détails de l'erreur disponibles dans le champ Motif du statut. Pour résoudre les problèmes, consultez la section Erreurs de synchronisation des enregistrements.

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Exemple
AWS Agent Registry namespace
aws agent-registry-control update-registry-record \
  --registry-id $REGISTRY_ID \
  --record-id $RECORD_ID \
  --trigger-synchronization \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record \
  --registry-id $REGISTRY_ID \
  --record-id $RECORD_ID \
  --trigger-synchronization \
  --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>',
    triggerSynchronization=True
)
print(f"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>',
    triggerSynchronization=True
)
print(f"Status: {response['status']}")
Note

Si le statut de l'enregistrement n'est pas BROUILLON (par exemple, APPROUVÉ), la mise à jour crée une nouvelle révision BROUILLON. La révision approuvée reste détectable.

Résolution des problèmes  : voir Erreurs de synchronisation des enregistrements.