Zum Inhalt springen
PlaidCloud

Einen Workflow mit dem KI-Assistenten reparieren

ca. 20 Minuten · ein fehlschlagender Schritt, eine KI-Diagnose, eine angewendete Korrektur

Sie führen einen Workflow aus, ein Schritt wird rot, und der Fehlertext allein sagt Ihnen nicht, was Sie ändern müssen. Dieses Tutorial begleitet Sie genau durch diesen Moment: Sie öffnen den integrierten AI Assistant von PlaidCloud, lassen ihn den fehlschlagenden Schritt anhand Ihrer Live-Daten diagnostizieren, genehmigen die vorgeschlagene Korrektur und führen den Schritt erneut aus, um sie zu bestätigen. Danach nutzen Sie denselben Assistenten, um aus einer Beschreibung in natürlicher Sprache einen SQL-Extraktionsschritt zu schreiben.

Dies ist der produktinterne AI Assistant, der Ihnen beim Erstellen und Reparieren von Workflows hilft. Er ist nicht dasselbe wie das Verbinden eines externen KI-Coding-Agenten (Claude Code, Cursor, MCP) mit Ihrem Tenant – dieser ergänzende Weg steht unter Einen KI-Coding-Agenten verbinden.

Was Sie tun werden

Abschnitt betitelt „Was Sie tun werden“
Phase Was Sie verwenden
Den Schritt fehlschlagen sehen und den Fehler lesen Die Registerkarte Protokoll des Projekts
Den fehlschlagenden Schritt diagnostizieren und beheben Den Reparaturassistenten, auf der Registerkarte AI Assistant des Protokolleintrags
Die Korrektur bestätigen Antworten Sie mit Ja, wenn der Assistent anbietet, den Schritt erneut auszuführen
Eine neue Abfrage ohne SQL-Kenntnisse hinzufügen Generate SQL with AI in einem Schritt SQL extrahieren

Voraussetzungen

Abschnitt betitelt „Voraussetzungen“
  • Ein PlaidCloud-Workspace (starten Sie eine kostenlose Testversion, falls Sie keinen haben) und ein Projekt, das Sie bearbeiten können.
  • Ein Workflow mit mindestens einem Schritt – idealerweise einem, der fehlschlägt oder den Sie zum Fehlschlagen bringen können (ein falsch geschriebener Spaltenname in einer Transformation genügt, um das Szenario nachzustellen).

Der Assistent repariert mit Ihren Berechtigungen. Er kann nur einen Schritt ändern, den Sie selbst bereits bearbeiten könnten, und jede seiner Änderungen lässt sich rückgängig machen, indem Sie den Schritt erneut ausführen oder direkt bearbeiten. Siehe Fixing Workflow Errors with AI.

Schritt 1: Den Workflow ausführen und den Fehler finden

Abschnitt betitelt „Schritt 1: Den Workflow ausführen und den Fehler finden“

Wenn ein Schritt fehlschlägt, erscheint eine Fehleranzeige sowohl am Workflow als auch am fehlgeschlagenen Schritt, und der Fehler wird in das Workflow-Protokoll geschrieben.

  1. Öffnen Sie Ihr Projekt und führen Sie den Workflow aus (oder den einzelnen Schritt, den Sie testen).
  2. Wechseln Sie zur Registerkarte Protokoll des Projekts. Das Protokoll listet Ereignisse auf, während Schritte laufen – darunter Warnungen und Fehler.
  3. Wählen Sie in der Protokollliste den Eintrag des fehlgeschlagenen Schritts aus. Seine vollständige Meldung – einschließlich eines etwaigen Tracebacks – öffnet sich im Bereich rechts unter der Registerkarte Protokollnachricht.

Kein defekter Workflow zur Hand? Bauen Sie in 30 Sekunden einen. Bearbeiten Sie in einem beliebigen Transformationsschritt den Ausdruck einer Spalte so, dass er auf eine nicht vorhandene Spalte verweist – ändern Sie etwa net_amount in net_amnt – und speichern Sie. Führen Sie den Schritt aus, und er schlägt fehl; im Protokoll steht, dass die Spalte net_amnt nicht existiert. Das ist eine echte Fehlkonfiguration, die der Reparaturassistent erkennen soll, und damit können Sie dieses Tutorial sauber von Anfang bis Ende durcharbeiten.

Mehr dazu, wie Fehler sichtbar werden und welche Optionen zu ihrer Behandlung bestehen, finden Sie unter Managing Step Errors und Viewing Workflow Log.

Schritt 2: Den Reparaturassistenten öffnen

Abschnitt betitelt „Schritt 2: Den Reparaturassistenten öffnen“

Der Reparaturassistent befindet sich direkt neben dem Rohfehler und ist bereits auf den fehlgeschlagenen Schritt ausgerichtet.

  1. Suchen Sie bei ausgewähltem fehlgeschlagenem Protokolleintrag den Bereich rechts, der Protokollnachricht anzeigt.
  2. Wechseln Sie in diesem Bereich zur Registerkarte AI Assistant.

Der Chat AI Assistant öffnet sich bereits mit Bezug auf den Workflow und den Schritt, aus dem der ausgewählte Protokolleintrag stammt, sodass Sie ihm nicht sagen müssen, welcher Schritt fehlgeschlagen ist. Sie können den Rohfehler unter Protokollnachricht lesen und gleichzeitig unter AI Assistant mit dem Assistenten chatten.

Bei den meisten Fehlern beginnt er sofort mit der Diagnose. Bei einigen häufigen – etwa einem Ausdruck, der eine nicht vorhandene Spalte nennt – besteht die erste Antwort stattdessen aus einer kurzen Erklärung, die PlaidCloud für diese Art von Fehler bereits hat: was ihn üblicherweise verursacht, auf welche Wörter der Fehlermeldung Sie achten sollten und wie er sich beheben lässt. Diese Erklärung betrachtet Ihren Schritt nicht. Antworten Sie – zum Beispiel „Bitte prüfe diesen Schritt und behebe ihn“ –, und der Assistent übernimmt von dort. Siehe Common Errors.

Schritt 3: Diagnose und Korrekturvorschlag abwarten

Abschnitt betitelt „Schritt 3: Diagnose und Korrekturvorschlag abwarten“

Der Assistent arbeitet in fester Reihenfolge, und nichts wird gespeichert, bevor Sie es sagen:

  1. Diagnostiziert – er liest die Konfiguration des fehlschlagenden Schritts sowie die Tabellen und Spalten, die er berührt, und prüft seine Aussagen an Ihren Daten, statt allein aus dem Fehlertext zu raten.
  2. Schlägt vor – findet er eine echte Fehlkonfiguration, zeigt er die korrigierte Schrittkonfiguration und erklärt verständlich, was er geändert hat und warum. Zu diesem Zeitpunkt wird nichts geschrieben.
  3. Sie genehmigen – er wartet auf Ihre ausdrückliche Freigabe. Eine mehrdeutige Antwort gilt nicht als Genehmigung.
  4. Wendet an – nach Ihrer Genehmigung schreibt er die korrigierte Konfiguration in den Schritt, über denselben Weg, den der Schritteditor verwendet.
  5. Bietet eine erneute Ausführung an – er fragt, ob der Schritt jetzt erneut ausgeführt werden soll. Antworten Sie mit Ja, und er führt den Schritt aus und sagt Ihnen, ob die Korrektur funktioniert hat.

Lesen Sie die vorgeschlagene Änderung, bevor Sie sie genehmigen. 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 Cast oder fehlerhaftes SQL – und ändert dabei so wenig wie nötig, um den Fehler zu beheben.

Er ist ehrlich darüber, was er nicht beheben kann. Sein einziger Hebel ist die Konfiguration dieses einen Schritts. Er erstellt, löscht oder sortiert keine Schritte um, bearbeitet keinen anderen Schritt und ändert Ihre Daten nicht. Viele Fehler sind gar keine Konfigurationsprobleme – fehlende oder fehlerhafte Quelldaten, ein vorgelagerter Schritt, der zuerst fehlgeschlagen ist, ein vorübergehender oder infrastrukturbedingter Fehler, ein Berechtigungsproblem oder fehlerhafte Logik in einer Transformation oder UDF. In solchen Fällen erklärt er, was er gefunden hat, und weist auf die Stelle hin, an der die eigentliche Lösung liegt, statt eine Änderung als Lösung auszugeben.

Schritt 4: Genehmigen und erneut ausführen

Abschnitt betitelt „Schritt 4: Genehmigen und erneut ausführen“
  1. Wenn die vorgeschlagene Konfiguration richtig aussieht, bestätigen Sie die Änderung ausdrücklich. Der Assistent wendet sie auf den Schritt an.
  2. Wenn der Assistent fragt, ob der Schritt erneut ausgeführt werden soll, antworten Sie mit Ja. Er führt den Schritt aus und sagt Ihnen, ob er erfolgreich war oder erneut fehlschlug. Sie können den Schritt oder den Workflow auch selbst erneut ausführen.

Hat der Assistent Ihnen mitgeteilt, dass die Ursache außerhalb der Konfiguration des Schritts liegt – fehlerhafte Daten, ein vorgelagerter Fehler, ein Berechtigungsproblem –, dann ist das die Antwort. Beheben Sie es dort, wo es tatsächlich liegt, statt den Assistenten den Schritt trotzdem bearbeiten zu lassen.

Warnungen sind oft harmlos. Ist der Protokolleintrag eine Warnung und kein harter Fehler, sagt der Assistent häufig, dass keine Änderung nötig ist, statt eine Änderung zu erfinden. Das ist ein gültiges Ergebnis, keine Sackgasse.

Schritt 5: Einen SQL-Extraktionsschritt mit KI erzeugen

Abschnitt betitelt „Schritt 5: Einen SQL-Extraktionsschritt mit KI erzeugen“

Nun nutzen Sie denselben zugrunde liegenden Assistenten, um neue Arbeit hinzuzufügen, nicht nur um zu reparieren. Der Schritt SQL extrahieren führt ein schreibgeschütztes SELECT aus und schreibt das Ergebnis in eine neue Tabelle – und der Schritteditor kann diese Abfrage für Sie schreiben.

  1. Klicken Sie in der Ansicht Schritte des Workflows auf Schritt erstellen und wählen Sie entweder Tabellen → SQL extrahieren oder AI → SQL Extract (AI Assisted). Beide öffnen denselben Editor, der oben auf der Seite SQL-Extraktionsparameter einen Bereich Generate SQL with AI enthält.
  2. (Optional) Quelltabellen auswählen. Wählen Sie in der Liste Quelltabellen eine oder mehrere Tabellen aus, aus denen die Abfrage lesen soll. Lassen Sie sie leer, damit der Assistent das Projekt untersucht und die relevanten Tabellen selbst auswählt.
  3. Beschreiben Sie, was Sie möchten. Schreiben Sie im Feld Beschreiben das gewünschte Ergebnis in natürlicher Sprache – zum Beispiel „ordne jedes Hauptbuchkonto anhand seines Kontonummernbereichs einem Aktivitätspool zu“.
  4. Klicken Sie auf SQL generieren. Der Assistent schreibt ein einzelnes schreibgeschütztes SELECT, validiert es durch Ausführen und füllt den Editor SQL-Select-Abfrage sowie die Zuordnungsseite Tabellendatenauswahl mit den erkannten Spalten. Haben Sie die Quellliste leer gelassen, werden die von ihm gewählten Tabellen in der Liste markiert, sodass Sie sehen, was er verwendet hat.

Es ist nichts einzurichten. Dies verwendet dasselbe integrierte Modell wie der AI Assistant – Sie müssen dafür keinen KI-Agenten und keine LLM-Verbindung pro Workspace konfigurieren.

Schritt 6: Den Schritt prüfen und speichern

Abschnitt betitelt „Schritt 6: Den Schritt prüfen und speichern“

Das generierte SQL ist ein Ausgangspunkt, keine Blackbox.

  1. Bearbeiten Sie es frei. Der SQL-Editor ist vollständig bearbeitbar – verfeinern Sie die Abfrage, fügen Sie einen Join hinzu oder ändern Sie die Spaltenliste, bevor Sie speichern.
  2. Wählen Sie eine Zieltabelle. Wählen oder benennen Sie die Zieltabelle, in die der Schritt sein Ergebnis schreibt.
  3. Speichern Sie den Schritt. Er wird als gewöhnlicher Schritt „SQL extrahieren“ gespeichert und läuft wie jeder andere im Rahmen des Workflows.

Der Assistent schreibt ausschließlich schreibgeschützte SELECT-Anweisungen – niemals INSERT, UPDATE, DELETE oder anderes datenänderndes SQL. Die Generierung erstellt nur Entwurf und Vorschau; der Schritt wird beim Speichern angelegt und läuft, wenn der Workflow läuft. Läuft eine generierte Abfrage nicht, zeigt der Editor das SQL zusammen mit dem Fehler an, sodass Sie es korrigieren können – oder Sie passen Ihre Beschreibung an und generieren erneut. Alle Einzelheiten finden Sie unter Generating SQL Extract Steps with AI.

Das ist die Unterstützung. Sie haben einen fehlschlagenden Schritt anhand von Live-Daten diagnostiziert, die Korrektur der KI genehmigt und angewendet, sie durch eine erneute Ausführung bestätigt und aus einem Satz in natürlicher Sprache einen funktionierenden SQL-Extraktionsschritt erzeugt – derselbe Assistent repariert, was defekt ist, und baut, was neu ist.

Wie es weitergeht

Abschnitt betitelt „Wie es weitergeht“