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.

Diagnostiquez les problèmes AgentCore d'évaluation à l'aide d'un assistant de codage IA

Si votre configuration AgentCore d'évaluation ne produit pas de résultats, ou si vous voyez des erreurs telles que des erreurs ou des scores d'évaluation vides LogEventMissingExceptionAgentSpanMappingException, vous pouvez utiliser la compétence de diagnostic AgentCore d'évaluation pour résoudre le problème vous-même.

La compétence est un fichier de démarquage qui fonctionne avec n'importe quel assistant de codage IA. Vous le chargez dans votre assistant, vous indiquez votre AWS région, votre type de déploiement et, éventuellement, un identifiant de session, et l'assistant vous propose un diagnostic étape par étape. La compétence fonctionne avec les agents déployés sur AgentCore Runtime et les agents hébergés sur une infrastructure tierce (Amazon ECS, Amazon EKS, AWS Lambda ou tout autre environnement). L'assistant interroge vos propres groupes de CloudWatch journaux Amazon pour identifier la cause première et recommander une solution.

Quels sont les diagnostics de compétence

La compétence couvre les problèmes d'évaluation les plus courants :

Conditions préalables

Copiez la compétence

La source de compétences est disponible dans Source de compétences de diagnostic. Copiez l'intégralité du bloc de code de cette rubrique et enregistrez-le SKILL.md dans un nouveau dossier nommé agentcore-eval-diagnostic/ sur votre ordinateur.

La compétence est un simple fichier de démarquage. Il ne contient que des informations publiques et fonctionne uniquement sur votre propre compte. Aucun accès côté service n'est requis.

Intégrez la compétence à votre assistant de codage IA

Enregistrez la source de compétences depuis la source de compétences de diagnostic dans un SKILL.md dossier nommé agentcore-eval-diagnostic/ sur votre machine, puis déplacez ou copiez ce dossier dans le répertoire des compétences de votre assistant de codage IA. La compétence suit la norme ouverte Agent Skills, de sorte que chaque outil la découvre à partir de son propre dossier de compétences dédié. N'ajoutez pas le contenu de la compétence à des fichiers d'instructions génériques tels que AGENTS.mdCLAUDE.md, ouGEMINI.md.

Kiro CLI

Placez le dossier de compétences à .kiro/skills/agentcore-eval-diagnostic/ dans votre projet, ou à ~/.kiro/skills/agentcore-eval-diagnostic/ pour le rendre disponible dans tous les espaces de travail. Pour plus de détails sur la configuration, consultez la documentation sur les compétences de la CLI Kiro.

Claude Code

Placez le dossier de compétences à .claude/skills/agentcore-eval-diagnostic/ dans votre projet, ou ~/.claude/skills/agentcore-eval-diagnostic/ à pour le rendre disponible pour tous les projets. Pour plus de détails sur la configuration, consultez la documentation relative aux compétences de Claude Code.

Interface de ligne de commande OpenAI Codex

Placez le dossier de compétences à .agents/skills/agentcore-eval-diagnostic/ dans votre référentiel, ou ~/.agents/skills/agentcore-eval-diagnostic/ à pour le rendre disponible dans tous les référentiels. Pour plus de détails sur la configuration, consultez la documentation relative aux compétences du Codex CLI.

Curseur

Le curseur utilise des règles plutôt que des compétences. Enregistrez le contenu des compétences en tant que règle de projet dans.cursor/rules/agentcore-eval-diagnostic.md. Pour plus de détails sur la configuration, consultez la documentation relative aux règles du curseur.

CLI Gemini

Placez le dossier de compétences sur pour le ~/.gemini/skills/agentcore-eval-diagnostic/ rendre disponible dans tous les espaces de travail, ou dans le répertoire des compétences de votre projet pour une utilisation spécifique au projet. Pour plus de détails sur la configuration, consultez la documentation relative aux compétences de Gemini CLI.

Tout autre assistant IA

Si votre assistant prend en charge la norme Agent Skills, placez le dossier de compétences dans le répertoire que votre assistant utilise pour découvrir les compétences. Si votre assistant ne prend pas en charge les compétences d'agent, chargez la compétence en collant le contenu de SKILL.md dans une invite système, un message utilisateur ou un fichier contextuel. La compétence est autonome et ne dépend d'aucune caractéristique spécifique à l'outil.

Exécuter un diagnostic

Après avoir chargé la compétence, lancez une nouvelle discussion avec votre assistant IA et fournissez :

L'assistant interroge vos groupes de CloudWatch journaux, identifie la cause première de la panne et produit un rapport de diagnostic structuré. Le rapport inclut :

L'assistant exécute toutes les requêtes de votre propre AWS compte par rapport à vos propres groupes de CloudWatch journaux. Il n'accède à aucun journal AWS côté service ni à aucune donnée interne.

Exemple d'interaction

Vous : Ma région estus-west-2, j'utilise AgentCore Runtime avec une évaluation en ligne et mon identifiant de session estmy-session-abc123. Mon évaluation ne donne aucun résultat. Peux-tu le diagnostiquer ?

Assistant IA :

## AgentCore Evaluation Diagnostic Report

Session: my-session-abc123
Region: us-west-2

Summary: Service name mismatch — spans are emitted under
'my_agent.DEFAULT' but the evaluation configuration expects
'wrong_name.DEFAULT'.

Findings:
| Check                | Status | Details |
| -------------------- | ------ | ------- |
| Eval config status   | OK     | ENABLED, 100% sampling |
| Spans found          | OK     | 15 spans for this session |
| Scope support        | OK     | strands.telemetry.tracer found |
| Service name match   | FAIL   | Config expects wrong_name.DEFAULT |

Recommended fix: Update the evaluation configuration's serviceNames to
match 'my_agent.DEFAULT'.

Résolution des problèmes liés à la compétence elle-même

Si l'assistant ne peut pas interroger vos groupes de journaux, vérifiez que :

Documents associés