La plupart des problèmes de compétences remontent à l'une de quelques causes. Cet article énumère les causes courantes et comment les corriger.
Le résultat est différent à chaque exécution
Cause : formulation vague dans une ou plusieurs étapes. L'agent interprète une instruction ambiguë différemment d'une exécution à l'autre.
Correction : trouvez l'étape dont la sortie varie et rendez-la spécifique. « Ouvrir toutes les pages contenant des plans d'étage » est stable ; « ouvrir toutes les pages où les gens vivent » ne l'est pas. Utilisez les termes du produit : plans d'étage, mesures, pages, groupes. Voir Writing Effective Skill Instructions: Best Practices.
L'agent saute ou confond les étapes
Cause : une étape contient plusieurs tâches à la fois, ou l'ordre des étapes ne correspond pas au processus réel.
Correction : divisez les étapes combinées — une action par étape — et vérifiez la séquence. Les étapes courtes et ciblées sont exécutées de manière fiable ; les étapes longues et composées ne le sont pas. Voir Skill Steps: How to Describe Tasks.
Une erreur précoce se retrouve dans le résultat final
Cause : aucun point de contrôle dans le flux de travail, donc une erreur se propage à travers chaque étape suivante sans être remarquée.
Correction : ajoutez des vérifications Si/Sinon après les étapes où les erreurs sont probables, et avant les étapes où elles sont coûteuses — par exemple, avant la génération d'un rapport. L'agent détectera l'erreur à sa propre étape et la recommencera. Voir Utilisation du branchement Si/Sinon pour le contrôle de qualité.
Une étape fonctionne pour moi mais pas pour mes collègues
Cause : l'étape repose sur un contexte qui existe dans votre esprit, pas dans la compétence.
Correction : intégrez ce contexte dans la compétence — affinez la formulation de l'étape et ajoutez une note expliquant ce que l'étape attend et produit. Voir Ajout de notes aux compétences pour la collaboration en équipe.
Je ne trouve pas la bonne compétence
Cause : noms, descriptions et étiquettes manquants ou incohérents.
Correction : nommez les compétences selon ce qu'elles font, décrivez l'entrée et la sortie, et convenez d'un schéma d'étiquetage avec l'équipe. Voir [Nomination, description et étiquetage des compétences].
Le résultat n'est toujours pas correct après affinage
Parcourez la boucle d'amélioration dans Édition et amélioration d'une compétence existante : exécutez, vérifiez, localisez l'étape problématique, resserrez-la, exécutez à nouveau. Si une étape spécifique continue de mal fonctionner indépendamment de la formulation, contactez le support et décrivez l'étape ainsi que le résultat que vous obtenez.