Workflow-Fehler mit KI beheben

Beschreibung

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 über die Ansicht Protokoll des Projekts, bereits auf den fehlgeschlagenen Schritt ausgerichtet. Er öffnet sich außerdem über ein Problem auf der Registerkarte Weave des Projekts.

Den Behebungsassistenten öffnen

Auf der Registerkarte Protokoll des Projekts, neben dem Rohprotokolleintrag:

Öffnen Sie das Projekt und klicken Sie auf die Registerkarte Protokoll.
Wählen Sie in der Protokollliste den Eintrag für den fehlgeschlagenen Schritt aus. Die vollständige Meldung – einschließlich eines etwaigen Tracebacks – öffnet sich im Bereich rechts auf der Registerkarte Protokollnachricht.
Wechseln Sie in diesem Bereich zur Registerkarte AI Assistant.

Der Chat AI Assistant ö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 und gleichzeitig unter AI Assistant mit dem Assistenten chatten. Bei einigen häufigen Fehlern ist die erste Antwort stattdessen eine Erklärung – siehe Häufige Fehler.

Über die Registerkarte „Weave”

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.

So funktioniert es

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.
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.
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.
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.
Angebot einer erneuten Ausführung – Eine zweite Karte fragt, ob der Schritt jetzt erneut ausgeführt werden soll, um die Behebung zu bestätigen. Wenn Sie zustimmen, führt der Assistent den Schritt aus und teilt Ihnen mit, ob er erfolgreich war, mit einer Warnung endete oder erneut fehlgeschlagen ist; ein neuer Fehlschlag ist ein Fehler, den er dann diagnostiziert. Ist der Schritt nach zwei Minuten nicht abgeschlossen, teilt er 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 rückgängig machen

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.

Häufige Fehler

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

Was er beheben kann

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.

Was er nicht tut

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.

Tipps

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.