Corriger les erreurs de workflow avec l'IA
Description
Section intitulée « Description »Lorsqu’une étape de workflow échoue ou consigne un avertissement, l’assistant de correction IA lit cette erreur, détermine sa cause et, lorsque la cause est une mauvaise configuration de l’étape elle-même, propose une configuration corrigée et l’applique une fois que vous l’avez approuvée. Il ne se contente pas d’expliquer l’erreur : il peut effectuer la modification à votre place.
Il fait partie du Weave AI de PlaidCloud et s’ouvre dans le dock Weave, déjà dirigé vers l’étape qui a échoué, depuis la visionneuse Journal du projet, l’éditeur de workflow et l’onglet Weave du projet. Lorsqu’une exécution planifiée échoue, Weave peut avoir préparé la correction pour vous ; consultez Une correction en attente après un échec d’exécution.
Ouvrir l’assistant de correction
Section intitulée « Ouvrir l’assistant de correction »Depuis l’onglet Journal du projet :
- Ouvrez le projet et cliquez sur l’onglet Journal.
- Dans la liste du journal, sélectionnez l’entrée de l’étape qui a échoué. Son message complet — y compris toute trace d’appels — s’ouvre dans le panneau de droite sous Message du journal.
- Cliquez sur Corriger sous le message. Une erreur ou un avertissement provenant d’une étape propose Corriger ; les autres entrées proposent Demander à Weave. ⋯ à côté contient Expliquer et les autres actions Weave.
Le dock s’ouvre déjà dirigé vers le workflow et l’étape dont provient l’entrée de journal sélectionnée ; il commence donc le diagnostic immédiatement — vous n’avez pas à lui indiquer quelle étape a échoué. Vous pouvez lire l’erreur brute sous Message du journal pendant que l’assistant répond dans le dock. Pour quelques erreurs courantes, sa première réponse est une explication — consultez Erreurs courantes.
Depuis l’éditeur de workflow
Section intitulée « Depuis l’éditeur de workflow »Sélectionnez une étape marquée d’un point rouge sur le canevas. Dans l’Inspecteur, la carte Dernière erreur d’exécution affiche Corriger à côté de son titre lorsque l’assistant de correction est activé, et Demander à Weave sinon. Consultez Lorsqu’une étape échoue.
Depuis un clic droit
Section intitulée « Depuis un clic droit »Faites un clic droit sur l’étape dans le canevas ou dans la liste des étapes, ou sur la ligne d’erreur du journal, et choisissez Corriger dans la section Weave du menu. Corriger est proposé lorsque la dernière exécution de l’étape a échoué ou qu’un constat en propose un, et jamais sur une ligne d’avertissement. Le dock Weave s’ouvre sur cette étape. Dans Monitor ou dans l’afficheur de Journal, Corriger sur une ligne produit le même effet.
Depuis l’onglet Weave
Section intitulée « Depuis l’onglet Weave »Dans l’onglet Weave du projet, cliquez sur Corriger sur la carte d’un problème détecté par Weave. L’assistant s’ouvre dans sa propre fenêtre, déjà dirigé vers l’étape concernée par le problème, et part du problème tel que Weave le signale maintenant. Consultez Corriger un constat avec l’assistant IA pour savoir quels constats proposent Corriger.
Fonctionnement
Section intitulée « Fonctionnement »- Diagnostique — il lit la configuration de l’étape en échec ainsi que les tables et colonnes qu’elle utilise, et vérifie ses affirmations par rapport à vos données plutôt que de deviner à partir du seul texte de l’erreur.
- Propose — s’il trouve une véritable mauvaise configuration, il présente la modification sur une carte : Pourquoi l’étape a échoué en une phrase, puis un encadré pour chaque paramètre qui change, nommé, lorsque c’est possible, comme dans le formulaire de l’étape, avec la valeur actuelle en rouge et la nouvelle valeur en vert. Seul ce qui change est listé — pour une liste de colonnes, seulement les colonnes qui changent. Rien n’est enregistré à ce stade.
- Vous approuvez — sélectionnez Approuver N modifications sur la carte, ou Pas maintenant pour laisser l’étape telle quelle. Répondre avec vos propres mots fonctionne aussi. Les boutons deviennent disponibles une fois que l’assistant a terminé sa réponse, et votre approbation vient toujours dans un message postérieur à la proposition.
- Applique — une fois que vous avez approuvé, il écrit la modification dans l’étape, par le même chemin que celui de l’éditeur d’étape. Ce qui est enregistré est la modification de la carte, et une approbation ne l’enregistre qu’une fois. Juste avant l’enregistrement, il conserve une copie des paramètres actuels de l’étape, afin que vous puissiez annuler la correction — consultez Annuler une correction.
- Ré-exécute et confirme — dans le navigateur, la même approbation couvre la ré-exécution : Weave ré-exécute l’étape corrigée avec la comptabilisation ERP désactivée et vous indique si elle a réussi, s’est terminée avec un avertissement ou a de nouveau échoué, par exemple Corrigée et ré-exécutée : Allocate by Driver a réussi en 4 min, 46 812 lignes, dans sa fourchette habituelle. S’il n’a pas pu confirmer, il en explique la raison et n’affirme jamais que l’étape est corrigée. Dans l’application mobile, une seconde carte demande s’il faut ré-exécuter l’étape. Si l’étape ne s’est pas terminée au bout de deux minutes, Weave l’indique, et le résultat apparaît dans le workflow et dans l’onglet Journal.
L’assistant ne propose pas de ré-exécution pour une étape qui comptabilise vers un système ERP ou exécute un autre workflow — ré-exécutez-la depuis son workflow, où vous choisissez le mode de comptabilisation ERP — ni lorsque le chat n’est pas lié à un workflow, ni lorsque votre rôle ne peut pas exécuter de workflows. Si le workflow est déjà en cours d’exécution, rien n’est exécuté et l’assistant propose de réessayer.
Chaque proposition, votre approbation ou votre refus, et la modification elle-même sont consignés dans l’historique d’activité Weave du projet, avec précisément ce que la modification a remplacé et écrit. Votre approbation est consignée avant que la modification ne soit effectuée. Si elle ne peut pas être consignée, rien n’est enregistré et la carte l’indique, et vous pourrez approuver à nouveau plus tard.
Une correction en attente après un échec d’exécution
Section intitulée « Une correction en attente après un échec d’exécution »Lorsqu’une exécution de workflow lancée par une planification ou un capteur échoue, Weave examine l’échec immédiatement et, lorsqu’il le peut, prépare la correction avant que quiconque n’ouvre le journal. Pour une exécution que vous avez lancée manuellement, il prépare une correction lorsque la cause est une colonne source qui a été renommée.
La correction attend sous la forme d’une carte intitulée d’après l’échec, par exemple Month-End Close failed at Allocate by Driver. Elle indique pourquoi l’exécution a échoué, ce qui change et ce qu’elle ré-exécute : Then: re-run Month-End Close from Allocate by Driver, then Margin Report. ERP posting is off for these runs. Vous la trouvez :
- dans la ligne de l’exécution en échec dans Monitor → Constatations, qui s’ouvre pour afficher la carte ;
- sur l’entrée du journal et sur la marque de l’étape dans le canevas ;
- dans le dock, sous la forme d’une ligne Waiting for you.
Le propriétaire de la carte est averti dans PlaidCloud, Month-End Close failed. Weave has a fix for you to review., et sur son téléphone s’il utilise l’application mobile. Cliquez sur Apply and re-run pour enregistrer la correction et ré-exécuter à partir de l’étape en échec. Weave indique ensuite si l’exécution a réussi.
- Toute personne dont le rôle permet de modifier l’étape en échec, ainsi que le propriétaire de la carte, peut l’approuver, sur le web.
- Weave prépare une carte par cause et ne réexamine pas le même échec sur une étape inchangée une fois qu’il n’a trouvé aucune correction ou que la carte a été refusée.
- Une étape qui comptabilise dans un ERP ou écrit en dehors de PlaidCloud ne reçoit aucune carte.
Corriger plusieurs étapes à la fois
Section intitulée « Corriger plusieurs étapes à la fois »Lorsque le même problème touche plusieurs étapes, comme une colonne renommée utilisée dans six mappages, Weave propose toutes les modifications sur une seule carte avec une section numérotée pour chacune, ce qu’il va ré-exécuter, et tout ce qu’il n’a pas pu inclure, comme une étape que votre rôle ne peut pas modifier. Un seul Approuver 6 modifications les applique toutes, puis Weave ré-exécute chaque étape corrigée une fois, avec la comptabilisation ERP désactivée, et indique si le problème a disparu. Si une étape a changé après votre approbation, Weave ne l’applique pas, s’arrête, et indique combien ont été appliquées. Un seul Défaire remet toutes les étapes corrigées en place. Si Weave a préparé la carte pendant votre absence, elle attend dans cette conversation, dans le dock, sous la forme d’une ligne Waiting for you que vous ouvrez pour approuver ; voir Cartes en attente.
Annuler une correction
Section intitulée « Annuler une correction »La carte d’une correction indique si la correction peut être annulée : Weave conserve une copie des paramètres actuels de l’étape ; vous pouvez donc l’annuler pendant une durée limitée, sauf si l’étape est de nouveau modifiée avant. Une carte sans cette ligne ne peut pas être annulée. Si Weave ne peut pas conserver la copie, il n’enregistre rien et l’indique, et vous pouvez le lui redemander.
Une fois la correction enregistrée, la carte affiche Défaire. L’entrée de la correction dans l’historique d’activité Weave du projet propose le même bouton ; vous pouvez donc annuler une correction après la fermeture de son chat. Toute personne dont le rôle permet de modifier les étapes du projet peut annuler une correction, pas seulement celle qui l’a approuvée.
Défaire ouvre une fenêtre qui montre ce que l’annulation rétablit : chaque paramètre modifié par la correction, tel qu’il est Actuel et tel qu’il sera Après restauration. Choisissez ensuite :
- Défaire — rétablir les paramètres de l’étape tels qu’ils étaient juste avant la correction.
- Défaire et exécuter — les rétablir, puis exécuter l’étape. Cette option est proposée lorsque votre rôle peut exécuter des workflows, que l’étape se trouve toujours dans le workflow où la correction a été faite (ou, à défaut, dans un seul workflow) et que vous pouvez ouvrir ce workflow, et que l’étape ne comptabilise pas vers un système ERP et n’exécute pas d’autre workflow. L’exécution elle-même ne peut pas être annulée.
- Annuler — laisser l’étape telle quelle.
L’annulation ne modifie que les paramètres de l’étape. Les données que les exécutions de l’étape ont déjà écrites restent en l’état : ré-exécutez l’étape pour les reconstruire.
Weave n’annule pas une correction, et ne modifie rien, lorsque :
- L’étape a changé depuis la correction. L’annulation rétablirait des paramètres obsolètes ; la fenêtre affiche donc l’étape telle qu’elle est Actuel à côté de ses paramètres Avant la modification de Weave, et vous pouvez la modifier vous-même.
- L’étape a déjà les paramètres qu’elle avait avant la correction.
- La copie n’est plus conservée. Les copies sont conservées pendant une durée limitée.
- Votre rôle ne peut pas modifier l’étape, ou le projet est verrouillé.
- Weave n’a pas pu consigner l’annulation. Réessayez plus tard.
Une annulation est consignée dans l’historique d’activité comme une modification à part entière, par exemple Effectué comme approuvé : annulation de la modification par Weave des paramètres d’une étape.
Erreurs courantes
Section intitulée « Erreurs courantes »Lorsqu’une étape échoue avec l’une de ces erreurs courantes, la première réponse est une explication que PlaidCloud possède déjà pour ce type d’erreur ; elle apparaît donc immédiatement.
Pour tout type d’étape :
- une expression qui utilise une colonne absente de la table lue par l’étape
- un mappage de colonnes dont la colonne source est absente de la table lue par l’étape
- une étape qui s’est arrêtée avant d’écrire quoi que ce soit parce que ses tables source ne correspondent pas à ses paramètres : une colonne qu’elle utilise ou une clé de jointure qu’une table n’a pas, une clé de jointure que l’étape ne liste pas, ou une table source qui n’a pas été construite
- un paramètre requis par l’étape qui a été laissé vide, comme la connexion qu’elle utilise ou la table qu’elle lit
- un workflow exécuté par l’étape qui a échoué — la cause se trouve probablement dans l’une des étapes de ce workflow ; consultez donc le journal de ce workflow
- une table nommée par l’étape et introuvable
- un entrepôt Snowflake ou Databricks qui bloque l’adresse de PlaidCloud, rejette sa connexion, a épuisé son quota, est introuvable ou inutilisable, ou n’a pas un privilège nécessaire au rôle de PlaidCloud
Pour une étape SQL Extract :
- du SQL qui ne peut pas être lu tel qu’il est écrit, comme un mot-clé mal orthographié ou une parenthèse non fermée
- une fonction que la base de données ne reconnaît pas
- une table qui n’existe pas
- une fonction appelée avec un type de valeur qu’elle ne sait pas traiter, comme la somme d’une colonne de texte (sur Databend)
- une valeur qui ne peut pas être convertie dans le type demandé par le SQL, comme du texte là où un nombre ou une date était attendu (sur Databend)
Pour une étape Table Extract, avec des corrections qui renvoient aux onglets et champs propres à l’étape plutôt qu’au SQL :
- une table source qui n’existe pas encore, ou n’existe plus (sur Databend)
- une expression qui utilise une fonction que la base de données ne reconnaît pas (sur Databend)
- une fonction appelée avec un type de valeur qu’elle ne sait pas traiter, comme la somme d’une colonne de texte dans une expression ou avec Résumer (sur Databend)
- une étape sans colonne de sortie, par exemple dont toutes les colonnes ont été supprimées
L’explication indique la cause habituelle de l’erreur, les mots du message d’erreur à examiner et la manière de la corriger. Elle est générale : elle ne contrôle pas votre étape et ne modifie rien. Pour que l’assistant examine l’étape elle-même, répondez. À partir de là, il fonctionne comme décrit dans Fonctionnement, l’explication faisant partie de la conversation.
Toute autre erreur va directement au diagnostic propre de l’assistant. Cela inclut les erreurs de base de données listées ci-dessus lorsqu’elles proviennent de tout autre type d’étape.
Ce qu’il peut corriger
Section intitulée « Ce qu’il peut corriger »L’assistant répare la configuration de l’unique étape d’où vient l’erreur — par exemple un nom de colonne ou de fonction mal saisi, une expression invalide, un type de données ou une conversion erronés, ou du SQL mal formé. Il modifie le strict nécessaire pour corriger l’erreur : un échec, une modification ciblée, le reste de la configuration restant tel quel.
Une expression qui échoue — dans une colonne, un filtre ou une clause having — est confiée au même spécialiste des expressions que celui qui accompagne l’Éditeur d’expressions, avec l’erreur et les colonnes de la table source. L’expression corrigée qu’il renvoie est contrôlée avant d’être proposée, et la proposition reste une modification de ce seul champ de l’étape, approuvée de la même manière que n’importe quelle autre.
Ce qu’il ne fera pas
Section intitulée « Ce qu’il ne fera pas »Son seul levier est la configuration de cette étape, et il le dit franchement lorsque le problème se situe ailleurs, plutôt que de maquiller une modification en solution.
- Il modifie la configuration d’une seule étape et rien d’autre — il ne crée pas, ne supprime pas et ne réordonne pas d’étapes, ne crée pas de tables, ne modifie pas une autre étape et ne change pas vos données.
- De nombreux échecs ne sont pas des problèmes de configuration : données source manquantes ou mal formées, étape amont qui a échoué en premier, erreur transitoire ou d’infrastructure, problème de permissions, Python défaillant dans une UDF ou une étape de code utilisateur, fichier manquant dans un compte de documents, ou limite de ressources ou de délai. Dans ces cas, il explique ce qu’il a trouvé et vous indique où se trouve la vraie correction.
- Les avertissements sont souvent bénins et n’exigent aucune modification — il le dira clairement plutôt que d’inventer une modification.
- Lorsqu’il n’est pas certain qu’une modification fonctionnera, il le dit et précise ce dont il doute au lieu de présenter une supposition comme une certitude.
- Le diagnostic s’appuie sur la configuration en direct de votre étape et sur les métadonnées de vos tables ; il reflète donc le projet tel qu’il est maintenant — pas une forme mise en cache ou supposée.
- Une fois la correction appliquée, répondez oui lorsque l’assistant propose de ré-exécuter l’étape, ou ré-exécutez-la vous-même, pour confirmer que l’erreur est résolue.
- Si l’assistant indique que la cause est extérieure à la configuration de l’étape (données incorrectes, échec en amont, problème de permissions), c’est la réponse — corrigez-la là où elle se trouve réellement plutôt que de demander à l’assistant de modifier quand même l’étape.