Résolution des problèmes
Une exécution a échoué
Comment retrouver une exécution échouée dans l’Historique, lire son erreur et corriger les causes habituelles.
Une exécution échoue lorsqu’une étape ne peut pas se terminer : un outil renvoie une erreur, une application n’est pas connectée, l’espace de travail n’a plus de crédits ou le forfait n’autorise pas une étape. Chaque exécution est enregistrée, vous pouvez donc lire après coup ce qui s’est passé.
Symptômes#
- L’agent s’arrête en cours de route ou donne une réponse vide ou générique.
- Un workflow se termine prématurément, ou une ligne de lot affiche Échec.
- Une exécution planifiée n’a rien fait.
- Vous voyez une bannière d’erreur après avoir cliqué sur publier, par exemple “Validation failed. Please fix the errors highlighted on the components.”
Retrouver l’exécution dans l’Historique#
- Cliquez sur Historique dans la barre latérale.
- Activez le filtre Messages d’erreur pour n’afficher que les sessions contenant une erreur. Vous pouvez aussi filtrer par Agent ou workflow et par chatbot.
- Ouvrez une session. Utilisez Simple ou Détaillé pour modifier le niveau de détail affiché.
- Lisez les événements de haut en bas. Ils sont étiquetés Message utilisateur, Sortie du chatbot, Message système, Hook de chat, Appel d’outil et Requête d’agent. Regardez les événements Appel d’outil pour trouver celui qui signale l’erreur.
Le panneau de métriques au-dessus du tableau (Afficher les métriques) trace l’évolution du Total des erreurs dans le temps. Votre forfait limite la profondeur de l’historique. Voir forfaits et limites. Pour les exécutions par lot, le tableau comporte les colonnes Statut et Erreur, et Relancer les échecs ou Réessayer la ligne relancent les lignes en échec.
Erreurs courantes et corrections#
| Ce que vous voyez | Cause | Correction |
|---|---|---|
| “Crédits insuffisants pour effectuer cette action. Veuillez recharger vos crédits.” | Le solde est vide | Plus de crédits |
| “Limite de crédits de l’espace de travail atteinte” | Une limite de dépenses de l’espace de travail | Augmentez-la dans Paramètres → Crédits |
| “NAME n’est pas configuré. Veuillez d’abord configurer l’intégration.” | L’étape nécessite une application qui n’est pas connectée | Connectez-la dans Intégrations |
| “… est connecté mais il manque les autorisations dont il a besoin. Veuillez reconnecter l’intégration et accorder les autorisations supplémentaires.” | La connexion manque d’une autorisation | Reconnectez-vous et acceptez toutes les autorisations |
| “… nécessite une nouvelle autorisation. Le token de rafraîchissement est expiré ou révoqué. Veuillez reconnecter l’intégration.” | La connexion a expiré ou a été révoquée | Reconnectez le compte |
| “Le composant NAME ne peut être utilisé qu’avec le forfait …” | L’étape n’est pas incluse dans votre forfait | Remplacez l’étape ou passez à un forfait supérieur |
| “Limite autorisée de … atteinte. Veuillez mettre à niveau votre forfait.” | Vous avez atteint un plafond de forfait en créant quelque chose | Supprimez-en un ou passez à un forfait supérieur |
| “Validation failed. Please fix the errors highlighted on the components.” | Une étape manque de paramètres obligatoires | Corrigez les étapes signalées, puis publiez à nouveau |
Exécutions planifiées#
Si l’espace de travail n’a plus de crédits, le système désactive la planification au lieu de réessayer indéfiniment. Ouvrez-la et réactivez-la une fois que vous avez des crédits. Voir planifications.
Corriger le problème#
- Retrouvez la session échouée et copiez l’erreur exacte.
- Faites-la correspondre au tableau, appliquez la correction et relancez la même entrée.
- Si l’erreur provient d’un service externe et que vous ne pouvez pas en déterminer la cause, testez l’étape seule depuis le canevas. Voir tests et journaux d’exécution.
Voir ce qu'a coûté une exécution
Consultez Transactions si vous ne savez pas ce qu’une exécution a dépensé. Chaque débit est listé avec son type et son contexte. Voir crédits.