DocumentAssistant IADiagnostiquer les exécutions en échec

Analyser les exécutions en échec avec l'assistant IA

Confiez-lui une exécution en échec : il repère l'étape fautive, explique la cause, corrige le workflow sur place et relance.

Quand une exécution échoue, le temps part rarement dans la correction mais dans la recherche : laquelle des centaines d'événements a réellement échoué, et sur quel champ. Cette page montre comment confier ce travail à l'assistant IA.

Commencez par la page de détail de l'exécution

Ouvrez la page de détail de l'exécution en échec.
Ouvrez l'assistant IA : deux boutons, diagnostiquer et relancer, apparaissent au-dessus du champ de saisie. Cliquez sur diagnostiquer — ou demandez simplement pourquoi cette exécution a échoué, le résultat est le même.
Sa réponse désigne l'étape fautive, donne la cause directe de l'erreur et indique comment modifier la configuration du workflow concernée.
Une fois la correction validée, laissez-le modifier le workflow directement, puis relancez.

Ce qu'il voit réellement

La plateforme ne balance pas tout le journal d'exécution au modèle : ce serait coûteux et noierait l'essentiel. L'assistant reçoit un faisceau de preuves compressé :

l'état global de l'exécution, la progression, les heures de début et de fin et le message d'erreur de premier niveau ;
une chronologie des états de toutes les étapes : statut, type, nombre de tentatives, durée et si la reprise automatique l'a déjà sauvée ;
le détail complet uniquement pour l'étape en échec et l'étape courante : entrées, sorties, pile d'erreurs et configuration de cette étape ;
et la structure du workflow lui-même, afin de distinguer une erreur de configuration d'un problème du système externe.

Il hérite de vos droits

Ces preuves sont assemblées côté serveur selon vos droits : une exécution que vous ne pouvez pas voir, l'assistant ne la lit pas non plus. Idem pour les workflows partagés en équipe, selon votre place dans cette équipe.

« Confier la correction à l'IA » dans l'éditeur

Quand les problèmes apparaissent avant même l'exécution, il existe un chemin plus court :

le panneau de diagnostic en bas de l'éditeur permet de confier un problème précis, ou tous d'un coup, à l'IA pour correction ;
l'entrée du panneau de propriétés d'étape ouvre l'assistant avec tout le contexte de cette étape, sans copier de YAML à la main ;
l'assistant produit toujours un diff ; rien n'est enregistré tant que vous n'avez pas confirmé, et la modification rejoint l'historique d'annulation de l'éditeur.

Types d'échecs courants et jusqu'où il vous aide

Type d'échec	Ce que l'assistant peut faire
Erreurs de configuration (variable non résolue, type de champ incorrect, étape non reliée)	Identifie le champ exact et propose la correction ; vous pouvez lui demander de l'appliquer sur place.
Identifiant manquant ou expiré	Indique de quel service l'autorisation manque ; à vous de l'ajouter ou de la remplacer dans la page Intégrations.
Erreurs d'une API externe (limitation de débit, droits insuffisants, paramètres refusés)	Explique le sens de la réponse en amont et suggère une politique de réessai ou un ajustement des paramètres — mais les problèmes du compte fournisseur lui-même se règlent dans sa console.
Une étape de code qui lève une exception	Lit le script et la pile d'erreurs pour cerner le comportement, puis renvoie un script corrigé.
Une exécution interrompue en cours de route	S'appuie sur l'historique de reprise pour indiquer quelles étapes ont déjà réussi et où il est le plus sûr de reprendre.

En lot : ce qui a échoué récemment

Ouvrez l'assistant depuis la liste des exécutions : l'un des boutons rapides affiche les échecs récents — pratique pour passer en revue le matin les tâches planifiées de la nuit avant d'examiner chacune.