Zum Inhalt springen

Workflow-Fehler mit KI beheben

Wenn ein Workflow-Schritt fehlschlägt oder eine Warnung protokolliert, liest der KI-Behebungsassistent diesen Fehler, ermittelt die Ursache und schlägt – wenn die Ursache in einer Fehlkonfiguration des Schritts selbst liegt – eine korrigierte Konfiguration vor, die er nach Ihrer Freigabe anwendet. Er geht über die bloße Erklärung des Fehlers hinaus: Er kann die Änderung für Sie vornehmen.

Er ist Teil von PlaidClouds Weave AI und öffnet sich im Weave-Dock, bereits auf den fehlgeschlagenen Schritt ausgerichtet – über die Ansicht Protokoll des Projekts, den Workflow-Editor und die Registerkarte Weave des Projekts. Schlägt eine geplante Ausführung fehl, kann Weave die Behebung bereits für Sie vorbereitet haben; siehe Eine Behebung wartet nach einer fehlgeschlagenen Ausführung.

Auf der Registerkarte Protokoll des Projekts:

  1. Öffnen Sie das Projekt und klicken Sie auf die Registerkarte Protokoll.
  2. Wählen Sie in der Protokollliste den Eintrag für den fehlgeschlagenen Schritt aus. Die vollständige Meldung – einschließlich eines etwaigen Stacktraces – öffnet sich im Bereich rechts unter Protokollnachricht.
  3. Klicken Sie unter der Meldung auf Beheben. Ein Fehler oder eine Warnung eines Schritts bietet Beheben an; andere Einträge bieten Weave fragen an. ⋯ daneben enthält Erklären und die übrigen Weave-Aktionen.

Das Dock öffnet sich bereits auf den Workflow und den Schritt ausgerichtet, aus dem der ausgewählte Protokolleintrag stammt, und beginnt sofort mit der Diagnose – Sie müssen ihm nicht sagen, welcher Schritt fehlgeschlagen ist. Sie können den Rohfehler unter Protokollnachricht lesen, während der Assistent im Dock antwortet. Bei einigen häufigen Fehlern ist die erste Antwort stattdessen eine Erklärung – siehe Häufige Fehler.

Wählen Sie auf der Arbeitsfläche einen Schritt mit einem roten Punkt aus. Im Inspector zeigt die Karte Fehler der letzten Ausführung neben ihrer Überschrift Beheben, wenn der Behebungsassistent aktiviert ist, andernfalls Weave fragen. Siehe Wenn ein Schritt fehlschlägt.

Klicken Sie mit der rechten Maustaste auf den Schritt auf der Arbeitsfläche oder in der Schrittliste oder auf die Fehlerzeile im Protokoll und wählen Sie im Bereich Weave des Menüs Beheben. Beheben wird angeboten, wenn die letzte Ausführung des Schritts fehlgeschlagen ist oder ein Befund diese Option bietet, und nie bei einer Warnzeile. Das Weave-Dock öffnet sich mit diesem Schritt. In Monitor oder im Viewer Protokoll bewirkt Beheben in einer Zeile dasselbe.

Klicken Sie auf der Registerkarte Weave des Projekts auf der Karte eines von Weave gefundenen Problems auf Beheben. Der Assistent öffnet sich in einem eigenen Fenster, bereits auf den Schritt ausgerichtet, um den es bei dem Problem geht, und geht von dem Problem aus, wie Weave es jetzt meldet. Unter Einen Befund mit dem KI-Assistenten beheben erfahren Sie, bei welchen Befunden Beheben angeboten wird.

  1. Diagnose – Er liest die Konfiguration des fehlgeschlagenen Schritts sowie die Tabellen und Spalten, auf die dieser zugreift, und prüft seine Annahmen anhand Ihrer Daten, statt allein aus dem Fehlertext zu raten.
  2. Vorschlag – Findet er eine echte Fehlkonfiguration, zeigt er die Änderung auf einer Karte: Why it failed in einem Satz, dann ein Feld für jede Einstellung, die sich ändert, nach Möglichkeit so benannt wie im Formular des Schritts, mit dem aktuellen Wert in Rot und dem neuen Wert in Grün. Es wird nur aufgeführt, was sich ändert – bei einer Spaltenliste nur die Spalten, die sich ändern. Zu diesem Zeitpunkt wird nichts gespeichert.
  3. Ihre Freigabe – Wählen Sie auf der Karte Approve N changes oder Jetzt nicht, um den Schritt unverändert zu lassen. Auch eine Antwort in eigenen Worten funktioniert. Die Schaltflächen werden verfügbar, sobald der Assistent seine Antwort beendet hat, und Ihre Freigabe erfolgt stets in einer Nachricht nach dem Vorschlag.
  4. Anwendung – Nach Ihrer Freigabe schreibt er die Änderung über denselben Weg in den Schritt, den auch der Schritt-Editor verwendet. Gespeichert wird die Änderung auf der Karte, und eine Freigabe speichert sie genau einmal. Unmittelbar vor dem Speichern legt er eine Kopie der aktuellen Einstellungen des Schritts an, damit Sie die Behebung rückgängig machen können – siehe Eine Behebung rückgängig machen.
  5. Führt erneut aus und bestätigt – Im Browser deckt dieselbe Freigabe auch die erneute Ausführung ab: Weave führt den behobenen Schritt mit deaktivierter ERP-Buchung erneut aus und teilt Ihnen mit, ob er erfolgreich war, mit einer Warnung endete oder erneut fehlgeschlagen ist, zum Beispiel Fixed and re-run: Allocate by Driver succeeded in 4 min, 46,812 rows, within its usual range. Konnte er es nicht bestätigen, nennt er den Grund und behauptet nie, der Schritt sei behoben. In der mobilen App fragt eine zweite Karte, ob der Schritt erneut ausgeführt werden soll. Ist der Schritt nach zwei Minuten nicht abgeschlossen, teilt Weave das mit, und das Ergebnis erscheint im Workflow und auf der Registerkarte Protokoll.

Der Assistent bietet keine erneute Ausführung an für einen Schritt, der in ein ERP-System bucht oder einen anderen Workflow ausführt – führen Sie ihn aus seinem Workflow erneut aus, wo Sie den ERP-Buchungsmodus wählen –, ebenso wenig, wenn der Chat nicht an einen Workflow gebunden ist oder wenn Ihre Rolle keine Workflows ausführen darf. Läuft der Workflow bereits, wird nichts ausgeführt, und der Assistent bietet an, es erneut zu versuchen.

Jeder Vorschlag, Ihre Freigabe oder Ablehnung und die Änderung selbst werden im Weave-Aktivitätsverlauf des Projekts festgehalten, einschließlich dessen, was die Änderung ersetzt und geschrieben hat. Ihre Freigabe wird vor der Änderung aufgezeichnet. Kann sie nicht aufgezeichnet werden, wird nichts gespeichert, die Karte weist darauf hin, und Sie können später erneut freigeben.

Eine Behebung wartet nach einer fehlgeschlagenen Ausführung

Abschnitt betitelt „Eine Behebung wartet nach einer fehlgeschlagenen Ausführung“

Schlägt eine von einem Zeitplan oder einem Sensor gestartete Workflow-Ausführung fehl, sieht sich Weave den Fehlschlag sofort an und bereitet, wenn möglich, die Behebung vor, bevor jemand das Protokoll öffnet. Bei einer Ausführung, die Sie manuell gestartet haben, bereitet es eine Behebung vor, wenn die Ursache eine umbenannte Quellspalte ist.

Die Behebung wartet als Karte, deren Titel den Fehlschlag nennt, etwa Month-End Close failed at Allocate by Driver. Sie gibt an, warum die Ausführung fehlgeschlagen ist, was sich ändert und was sie erneut ausführt: Then: re-run Month-End Close from Allocate by Driver, then Margin Report. ERP posting is off for these runs. Sie finden sie:

  • in der Zeile der fehlgeschlagenen Ausführung unter Monitor → Findings, die sich öffnet und die Karte zeigt;
  • am Protokolleintrag und an der Markierung des Schritts auf der Arbeitsfläche;
  • im Dock als Zeile Wartet auf Sie.

Der Besitzer der Karte wird in PlaidCloud benachrichtigt, Month-End Close failed. Weave has a fix for you to review., und auf seinem Smartphone, wenn er die mobile App verwendet. Klicken Sie auf Apply and re-run, um die Behebung zu speichern und ab dem fehlgeschlagenen Schritt erneut auszuführen. Weave teilt anschließend mit, ob die Ausführung erfolgreich war.

  • Jeder, dessen Rolle den fehlgeschlagenen Schritt bearbeiten darf, sowie der Besitzer der Karte kann sie freigeben, im Web.
  • Weave bereitet für jede Ursache eine Karte vor und sieht sich denselben Fehlschlag bei einem unveränderten Schritt nicht erneut an, sobald es keine Behebung gefunden hat oder die Karte abgelehnt wurde.
  • Ein Schritt, der in ein ERP-System bucht oder außerhalb von PlaidCloud schreibt, erhält keine Karte.

Wenn dasselbe Problem mehrere Schritte betrifft, etwa eine umbenannte Spalte, die in sechs Zuordnungen verwendet wird, schlägt Weave alle Änderungen auf einer Karte vor, mit einem nummerierten Abschnitt für jede, dem, was erneut ausgeführt wird, und allem, was nicht einbezogen werden konnte, etwa einem Schritt, den Ihre Rolle nicht bearbeiten darf. Ein einziges Approve 6 changes wendet alle an, dann führt Weave jeden behobenen Schritt einmal erneut aus, mit deaktivierter ERP-Buchung, und teilt mit, ob das Problem behoben ist. Hat sich ein Schritt nach Ihrer Freigabe geändert, wendet Weave ihn nicht an, hält an und teilt mit, wie viele angewendet wurden. Ein einziges Rückgängig setzt jeden behobenen Schritt zurück. Hat Weave die Karte vorbereitet, während Sie abwesend waren, wartet sie in dieser Unterhaltung im Dock, als Zeile Wartet auf Sie, die Sie zum Genehmigen öffnen; siehe Karten, die auf Sie warten.

Auf der Karte einer Behebung steht, wann die Behebung rückgängig gemacht werden kann: Weave keeps a copy of the step’s current settings, so you can undo this for a limited time, unless the step is changed again first. Eine Karte ohne diese Zeile kann nicht rückgängig gemacht werden. Kann Weave die Kopie nicht anlegen, speichert es nichts und teilt das mit, und Sie können es erneut anfordern.

Sobald die Behebung gespeichert ist, zeigt die Karte Rückgängig. Der Eintrag der Behebung im Weave-Aktivitätsverlauf des Projekts hat dieselbe Schaltfläche, sodass Sie eine Behebung auch nach dem Schließen des Chats rückgängig machen können. Jeder, dessen Rolle Schritte im Projekt ändern darf, kann eine Behebung rückgängig machen, nicht nur die Person, die sie freigegeben hat.

Rückgängig öffnet ein Fenster, das zeigt, was das Rückgängigmachen wiederherstellt: jede Einstellung, die die Behebung geändert hat, wie sie Aktuell ist und wie sie Nach dem Rückgängigmachen sein wird. Wählen Sie dann:

  • Rückgängig – die Einstellungen des Schritts so wiederherstellen, wie sie unmittelbar vor der Behebung waren.
  • Rückgängig und ausführen – sie wiederherstellen und anschließend den Schritt ausführen. Das wird angeboten, wenn Ihre Rolle Workflows ausführen darf, der Schritt sich noch in dem Workflow befindet, in dem die Behebung erfolgte (oder andernfalls nur in einem Workflow), Sie diesen Workflow öffnen können und der Schritt weder in ein ERP-System bucht noch einen anderen Workflow ausführt. Die Ausführung selbst lässt sich nicht rückgängig machen.
  • Abbrechen – den Schritt unverändert lassen.

Das Rückgängigmachen ändert nur die Einstellungen des Schritts. Daten, die Ausführungen des Schritts bereits geschrieben haben, bleiben unverändert: Führen Sie den Schritt erneut aus, um sie neu aufzubauen.

Weave macht eine Behebung nicht rückgängig und ändert nichts, wenn:

  • Der Schritt sich seit der Behebung geändert hat. Das Rückgängigmachen würde veraltete Einstellungen wiederherstellen. Das Fenster zeigt daher den Schritt, wie er Aktuell ist, neben seinen Einstellungen Vor der Änderung durch Weave, und Sie können ihn selbst ändern.
  • Der Schritt bereits die Einstellungen hat, die er vor der Behebung hatte.
  • Die Kopie nicht mehr aufbewahrt wird. Kopien werden nur für eine begrenzte Zeit aufbewahrt.
  • Ihre Rolle den Schritt nicht ändern darf oder das Projekt gesperrt ist.
  • Weave das Rückgängigmachen nicht aufzeichnen konnte. Versuchen Sie es später erneut.

Ein Rückgängigmachen wird im Aktivitätsverlauf als eigene Änderung aufgezeichnet, etwa als Done as approved: undo Weave’s change to a step’s settings.

Schlägt ein Schritt mit einem dieser häufigen Fehler fehl, ist die erste Antwort eine Erklärung, die PlaidCloud für diese Art von Fehler bereits hat und die daher sofort erscheint.

Bei jedem Schritttyp:

  • ein Ausdruck, der eine Spalte verwendet, die in der vom Schritt gelesenen Tabelle nicht vorhanden ist
  • eine Spaltenzuordnung, deren Quellspalte in der vom Schritt gelesenen Tabelle nicht vorhanden ist
  • ein Schritt, der angehalten hat, bevor er etwas geschrieben hat, weil seine Quelltabellen nicht zu seinen Einstellungen passen: eine Spalte, die er verwendet, oder ein Join-Schlüssel, den eine Tabelle nicht hat, ein Join-Schlüssel, den der Schritt nicht aufführt, oder eine Quelltabelle, die noch nicht erstellt wurde
  • eine Einstellung, die der Schritt benötigt und die leer geblieben ist, etwa die verwendete Verbindung oder die gelesene Tabelle
  • ein vom Schritt ausgeführter Workflow, der fehlgeschlagen ist – die Ursache liegt höchstwahrscheinlich in einem Schritt dieses Workflows, prüfen Sie also dessen Protokoll
  • eine Tabelle, die der Schritt nennt und die nicht gefunden werden kann
  • ein Snowflake- oder Databricks-Warehouse, das die Adresse von PlaidCloud blockiert, die Anmeldung ablehnt, sein Kontingent aufgebraucht hat, nicht gefunden oder nicht verwendet werden kann oder dem eine Berechtigung fehlt, die die Rolle von PlaidCloud benötigt

Bei einem Schritt SQL Extract:

  • SQL, das nicht wie geschrieben gelesen werden kann, etwa wegen eines falsch geschriebenen Schlüsselworts oder einer nicht geschlossenen Klammer
  • eine Funktion, die die Datenbank nicht erkennt
  • eine Tabelle, die nicht existiert
  • eine Funktion, der ein Werttyp übergeben wurde, mit dem sie nicht arbeiten kann, etwa das Summieren einer Textspalte (bei Databend)
  • ein Wert, der sich nicht in den vom SQL verlangten Typ umwandeln lässt, etwa Text, wo eine Zahl oder ein Datum erwartet wurde (bei Databend)

Bei einem Schritt Table Extract, mit Behebungen, die auf die eigenen Registerkarten und Felder des Schritts verweisen statt auf SQL:

  • eine Quelltabelle, die noch nicht existiert oder nicht mehr existiert (bei Databend)
  • ein Ausdruck, der eine Funktion verwendet, die die Datenbank nicht erkennt (bei Databend)
  • eine Funktion, der ein Werttyp übergeben wurde, mit dem sie nicht arbeiten kann, etwa das Summieren einer Textspalte in einem Ausdruck oder mit Zusammenfassen (bei Databend)
  • ein Schritt ohne Ausgabespalten, etwa einer, dessen Spalten alle entfernt wurden

Die Erklärung nennt, was den Fehler üblicherweise verursacht, auf welche Wörter in der Fehlermeldung Sie achten sollten und wie Sie ihn beheben. Sie ist allgemein gehalten: Sie prüft Ihren Schritt nicht und ändert nichts. Damit der Assistent sich den Schritt selbst ansieht, antworten Sie. Von da an arbeitet er wie unter So funktioniert es beschrieben, wobei die Erklärung Teil der Unterhaltung ist.

Jeder andere Fehler geht direkt an die eigene Diagnose des Assistenten. Dazu gehören die oben aufgeführten Datenbankfehler, wenn sie von einem anderen Schritttyp stammen.

Der Assistent repariert die Konfiguration des einen Schritts, aus dem der Fehler stammt – zum Beispiel einen falsch geschriebenen Spalten- oder Funktionsnamen, einen ungültigen Ausdruck, einen falschen Datentyp oder eine falsche Umwandlung oder fehlerhaftes SQL. Er ändert so wenig wie möglich, um den Fehler zu beheben: ein Fehler, eine gezielte Änderung, die übrige Konfiguration bleibt, wie sie war.

Ein Ausdruck, der fehlschlägt – in einer Spalte, einem Filter oder einer Having-Klausel –, wird zusammen mit dem Fehler und den Spalten der Quelltabelle an denselben Ausdrucksspezialisten übergeben, der neben dem Ausdruckseditor sitzt. Der korrigierte Ausdruck, den er zurückgibt, wird geprüft, bevor er vorgeschlagen wird, und der Vorschlag ist weiterhin eine Änderung an diesem einen Feld des Schritts, die genauso freigegeben wird wie jede andere.

Sein einziger Hebel ist die Konfiguration dieses Schritts, und er sagt offen, wenn das Problem woanders liegt, statt eine Änderung als Lösung auszugeben.

  • Er bearbeitet die Konfiguration eines Schritts und sonst nichts – er erstellt, löscht oder ordnet keine Schritte um, erstellt keine Tabellen, bearbeitet keinen anderen Schritt und ändert Ihre Daten nicht.
  • Viele Fehlschläge sind keine Konfigurationsprobleme: fehlende oder fehlerhafte Quelldaten, ein vorgelagerter Schritt, der zuerst fehlgeschlagen ist, ein vorübergehender Fehler oder ein Infrastrukturfehler, ein Berechtigungsproblem, fehlerhafter Python-Code in einer UDF oder einem Schritt mit Benutzercode, eine fehlende Datei in einem Dokumentenkonto oder ein Ressourcen- oder Zeitlimit. In diesen Fällen erklärt er, was er gefunden hat, und verweist Sie dorthin, wo die eigentliche Lösung liegt.
  • Warnungen sind oft harmlos und erfordern keine Änderung – er sagt das offen, statt eine Änderung zu erfinden.
  • Wenn er nicht sicher ist, dass eine Änderung funktioniert, sagt er das und nennt, worüber er unsicher ist, statt eine Vermutung als Gewissheit auszugeben.
  • Die Diagnose stützt sich auf Ihre aktuelle Schrittkonfiguration und Tabellenmetadaten und spiegelt das Projekt daher so wider, wie es jetzt ist – nicht in einer zwischengespeicherten oder angenommenen Form.
  • Antworten Sie nach einer angewendeten Behebung mit Ja, wenn der Assistent anbietet, den Schritt erneut auszuführen, oder führen Sie ihn selbst erneut aus, um zu bestätigen, dass der Fehler behoben ist.
  • Sagt der Assistent, die Ursache liege außerhalb der Konfiguration des Schritts (fehlerhafte Daten, ein vorgelagerter Fehlschlag, ein Berechtigungsproblem), ist das die Antwort – beheben Sie sie dort, wo sie tatsächlich liegt, statt den Assistenten den Schritt trotzdem bearbeiten zu lassen.