Corriger les erreurs de workflow avec l'IA

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 depuis la visionneuse Journal du projet, déjà dirigé vers l’étape qui a échoué. Il s’ouvre aussi depuis un problème de l’onglet Weave du projet.

Ouvrir l’assistant de correction

Depuis l’onglet Journal du projet, à côté de l’entrée brute du journal :

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 l’onglet Message du journal.
Passez ce panneau sur l’onglet Assistant IA.

Le chat Assistant IA 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 et dialoguer avec l’assistant sous Assistant IA, côte à côte. Pour quelques erreurs courantes, sa première réponse est une explication — consultez Erreurs courantes.

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

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.
Propose une ré-exécution — une seconde carte demande s’il faut ré-exécuter l’étape maintenant pour confirmer la correction. Approuvez-la et l’assistant exécute l’étape puis vous indique si elle a réussi, s’est terminée avec un avertissement ou a de nouveau échoué ; un nouvel échec est une erreur qu’il diagnostique ensuite. Si l’étape ne s’est pas terminée au bout de deux minutes, il 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.

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

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
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

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

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.

Astuces

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.