---
title: "Compétences en dépannage : problèmes courants et solutions"
description: "Problèmes courants de compétences — résultats instables, étapes ignorées, erreurs lors de l'accès au rapport — et comment résoudre chacun d'entre eux."
url: https://help-takeoff.kreo.net/fr/articles/11688709-competences-en-depannage-problemes-courants-et-solutions
collection: "Skills"
updated: 2026-07-15
language: fr
alternates: [en]
---

# Compétences en dépannage : problèmes courants et solutions

Problèmes courants de compétences — résultats instables, étapes ignorées, erreurs lors de l'accès au rapport — et comment résoudre chacun d'entre eux.

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](https://help-takeoff.kreo.net/en/articles/11688707-writing-effective-skill-instructions-best-practices.md).

## 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](https://help-takeoff.kreo.net/en/articles/11688702-skill-steps-how-to-describe-tasks.md).

## 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é](https://help-takeoff.kreo.net/en/articles/11688703-using-ifelse-branching-for-quality-control.md).

## 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](https://help-takeoff.kreo.net/en/articles/11688704-adding-notes-to-skills-for-team-collaboration.md).

## 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](https://help-takeoff.kreo.net/en/articles/11688708-editing-and-improving-an-existing-skill.md) : 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.

## Related

- [Qu'est-ce que les compétences ? Un aperçu](https://help-takeoff.kreo.net/fr/articles/11688700-qu-est-ce-que-les-competences-un-apercu.md)
- [Créer votre première compétence](https://help-takeoff.kreo.net/fr/articles/11688701-creer-votre-premiere-competence.md)
- [Skill Steps: How to Describe Tasks](https://help-takeoff.kreo.net/fr/articles/11688702-skill-steps-how-to-describe-tasks.md)
- [Utilisation de la ramification If/Else pour le contrôle de qualité](https://help-takeoff.kreo.net/fr/articles/11688703-utilisation-de-la-ramification-ifelse-pour-le-controle-de-qualite.md)
- [Adding Notes to Skills for Team Collaboration](https://help-takeoff.kreo.net/fr/articles/11688704-adding-notes-to-skills-for-team-collaboration.md)