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.
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.
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.
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é.
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.
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].
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.
