View a markdown version of this page

Résolution des problèmes - Amazon Bedrock AgentCore
Erreurs de validation de schémaEnregistrer les erreurs de synchronisation

Résolution des problèmes

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.

Erreurs de validation de schéma

Lorsque vous créez différents types d'enregistrements, vous pouvez voir une exception de validation pour les descripteurs. Consultez la section Types d'enregistrements pris en charge pour connaître les schémas valides.

Erreurs courantes :

  • « La version du schéma '0.3.0' n'est pas prise en charge pour le type de descripteur 'a2a'. » — La valeur du champ SchemaVersion doit être 0.3 au lieu de. 0.3.0 Cela correspond à la description officielle de la version du protocole A2A : « Utiliser la dernière version mineure prise en charge par version majeure ».

  • « La validation du schéma a échoué : le contenu n'est pas conforme à la version du schéma « 0.3 » pour le type de descripteur « a2a ». » — Vous pouvez trouver le schéma sur Types d'enregistrements pris en charge. Notez que le contenu sera validé par rapport à #/ definitions/AgentCard dans le schéma json.

Enregistrer les erreurs de synchronisation

Lorsque vous créez ou mettez à jour un enregistrement à l'aide de la fonction de synchronisation, l'enregistrement peut passer au statut CREATE_FAILED ou UPDATE_FAILED, avec une explication de ce qui s'est passé. statusReason

À haut niveau, les erreurs peuvent être classées comme suit : erreurs d'autorisation, erreurs de connexion, erreurs de validation et erreurs côté serveur.

Erreurs d'autorisation

La configuration de synchronisation est incorrecte ou a expiré :

  • « Impossible de se connecter au serveur MCP car les informations d'identification de l'appelant ont expiré. » — les informations d'identification de l'appelant de l'API de création ou de mise à jour ont expiré. Vous pouvez réessayer avec UpdateRegistryRecord l'API.

  • « Exception reçue de GetWorkloadAccessToken l'API : <detailed message>» — le registre appelle GetWorkloadAccessTokenl'API au nom de l'appelant. Reportez-vous au message détaillé pour en savoir plus sur l'erreur. Reportez-vous à la section Synchroniser les enregistrements provenant de sources externes si vous voyez une exception de refus d'accès.

  • « Impossible d'analyser l'ARN du fournisseur d'informations d'identification : <arn>» — ARN du fournisseur d'informations d'identification mal formé. Il doit s'agir d'un ARN de fournisseur d'informations d'identification valide créé à partir d' AgentCore Identity.

  • « Exception reçue de GetResourceOauth2Token l'API : <detailed message>» — le registre appelle GetResourceOauth2Tokenl'API au nom de l'appelant. Reportez-vous au message détaillé pour en savoir plus sur l'erreur. Reportez-vous à la section Synchroniser les enregistrements provenant de sources externes si vous voyez une exception de refus d'accès.

  • « Impossible d'assumer le rôle IAM fourni pour l'autorisation du serveur MCP. » — le registre appelle AssumeRole l'API au nom de l'appelant. Reportez-vous à la section Synchroniser les enregistrements provenant de sources externes pour connaître les autorisations IAM attendues, par exemple l'appelant doit avoir une iam:PassRole autorisation.

Erreurs de connexion

Impossible d'accéder au serveur :

  • « Impossible de récupérer la carte d'agent depuis l'URL : %s » — A2A IOException

  • « Le serveur MCP a renvoyé HTTP <code>» : réponse non 200/202 HTTP du serveur MCP. Vérifiez si l'URL est correcte et si le serveur MCP peut être connecté.

  • « L'URL fournie renvoie à une adresse IP non publique » — Le registre prend uniquement en charge la connexion aux serveurs d'adresses IP publics.

  • « Impossible de se connecter au serveur MCP » — IOException/connection échec

  • « URL du serveur MCP non valide » — URL mal formée

  • « Impossible d'initialiser la connexion MCP » — exception de demande d'initialisation

  • « Impossible d'envoyer la notification initialisée » — exception de notification

  • « Impossible de répertorier les outils du serveur MCP » — exception tools/list

  • « Expiration du délai de tools/list pagination du serveur MCP » : le registre ne prend en charge que 30 secondes au maximum lors de la pagination des outils depuis le serveur MCP. Contactez AWS le support si votre serveur MCP a besoin de plus de temps pour la synchronisation.

Erreurs de validation

Le serveur a répondu mais le contenu n'est pas pris en charge :

  • « Impossible d'analyser le JSON de la carte d'agent » — Contenu A2A vide ou JSON mal formé

  • « La carte d'agent dépasse la limite de taille maximale » — Réponse A2A trop importante

  • « Impossible d'analyser le JSON de la réponse du serveur MCP » — Contenu MCP vide ou mal formé

  • « Le serveur MCP a renvoyé une réponse non valide : résultat manquant » — Résultat MCP JSON-RPC manquant

  • « La réponse du serveur MCP dépasse la taille maximale autorisée » — Réponse MCP trop importante

  • « Le type de descripteur %s ne prend pas en charge la synchronisation d'URL » : type de descripteur non pris en charge

Erreurs côté serveur

  • « Erreur inconnue » — Il s'agit d'une erreur côté serveur. Réessayez ultérieurement ou contactez l' AWS assistance pour obtenir de l'aide.