Visueller Editor

Der Workflow-Editor ist die Seite, auf der Sie jeden Tag die meiste Zeit verbringen. In diesem Artikel geht es um jeden Bereich und jede Schaltfläche, sodass Sie wissen, wo Sie klicken müssen, wenn Sie X ausführen möchten.

Gesamtlayout

Der Editor ist ein typisches dreispaltiges Layout:

• Obere Symbolleiste — Kernoperationen wie Speichern/Überprüfen/Ausführen/Importieren/Exportieren/Versionsverlauf usw.
• Leinwand in der linken Spalte — DAG-Visualisierung mit Drag-and-Drop-Knoten, Verbindungen, Zoom und Minikarten
• Rechte Spalte YAML — Monaco Editor bearbeitet YAML-Quellen direkt mit Syntaxhervorhebung/automatischer Vervollständigung/Fehlermeldungen
• untere Statusleiste — Status speichern, Sperrhalter bearbeiten, Position des Mitarbeiter-Cursors, letzte Überprüfungszeit
• Rechte Schublade — KI-Assistent, Breakpoint-Panel, variabler Snapshot (bei Bedarf öffnen)

Canvas vs. YAML: Bidirektionale Synchronisierung auf Byte-Ebene

Dies ist der offensichtlichste Unterschied zwischen Braidrun und anderen Marken. Ein DAG-Diagramm und ein YAML sind äquivalent auf Byteebene:

• Sie ändern eine Zeile in YAML und der entsprechende Knoten auf der Leinwand wird sofort aktualisiert;
• Sie ziehen eine Verbindungslinie auf die Leinwand und gleichzeitig erscheint das entsprechende depend_on-Feld in YAML;
• Kommentare/Leerzeilen/Feldreihenfolge gehen nicht verloren – das exportierte YAML ist genau das gleiche wie das, was Sie im Editor sehen.

Obere Symbolleiste

Sparen

Standardmäßig wird die Eingabe automatisch einmal gespeichert, nachdem Sie 5 Sekunden lang mit der Eingabe aufgehört haben. Es kann auch manuell durch Drücken von Strg / Befehlstaste + S ausgelöst werden. Bei jedem Speichern wird ein erstellt Versionsschnappschuss(Keine einfache Überschreibung).

Rückgängig / Wiederherstellen

In der Symbolleiste gibt es die beiden Schaltflächen Rückgängig / Wiederherstellen mit den Tastenkürzeln Strg / Cmd + Z und Strg / Cmd + Umschalt + Z. Es handelt sich um einen editorweiten Verlaufsstapel: Leinwand-Ziehen, YAML-Änderungen und jeder vom KI-Assistenten schrittweise erstellte Schritt gehen in dieselbe Historie ein — auch ein „von der KI verpatzter Schritt“ lässt sich mit einem Klick zurücknehmen. Fortlaufende Eingaben werden zu einem Eintrag zusammengefasst, und der beim automatischen Speichern zurückgeschriebene Zeitstempel erzeugt keine überflüssige Historie; es werden höchstens die letzten 50 Snapshots behalten, und beim Wechsel zu einem anderen Workflow wird die Historie zurückgesetzt.

Überprüfen

Rufen Sie den Plattformparser auf, um einen Roundtrip durchzuführen:

1. YAML → WorkflowDefinition-Objekt (Syntaxebene)
2. WorkflowDefinition → Semantische Überprüfung (ob die Variablenreferenz geparst werden kann, ob die Voreinstellung gefunden werden kann, ob es Schleifen in Abhängigkeiten gibt)
3. WorkflowDefinition → YAML-Roundtrip (bei Abweichungen wird ein Fehler gemeldet)

Fehler werden zeilenweise im YAML mit einer roten Wellenlinie markiert; ein Klick springt zur betreffenden Zeile. Die Ergebnisse der Tiefenprüfung fließen ebenfalls in das unten beschriebene Diagnose-Panel ein. Bereinigen Sie sie vollständig, bevor Sie speichern und veröffentlichen.

Ausführen

Wenn Sie auf diese Schaltfläche klicken, wird ein Dialogfeld geöffnet, in dem Sie Folgendes tun können:

• Füllen Sie die Variablen des Workflows aus (Standardwerte werden vorab ausgefüllt).
• Prüfen/Stornieren dry-run (standardmäßig aktiviert – für die erste Ausführung dringend empfohlen)
• Triggerquelle auswählen (manuell/Zeitplansimulation)

Nachdem Sie auf „Ausführung starten“ geklickt haben, öffnet der Editor automatisch eine Schublade auf der rechten Seite, um den Echtzeit-Ereignisfluss anzuzeigen, und öffnet gleichzeitig die Ausführungsdetails auf der aktuellen Registerkarte.

Import/Export

• YAML importieren – Lädt YAML aus einer Datei/Pasteboard/einer URL und überschreibt dabei den aktuellen Inhalt.
• YAML exportieren – Laden Sie das aktuelle YAML in eine lokale Datei herunter. Geeignet für die Git-Versionskontrolle.
• Importieren Sie externe Formate wie Dify/Langflow – Pro oder höher Paket erforderlich, die Plattform konvertiert automatisch in Braidrun YAML.

Versionsverlauf

Bei jedem Speichern wird ein Snapshot erstellt und standardmäßig 100 Versionen beibehalten (keine Begrenzung für Enterprise). Sie können:

• Alle Snapshots auflisten (einschließlich Zeit, Ersparnis, Anzahl der geänderten Zeilen)
• Mit aktuellem Versionsunterschied vergleichen
• Rollback auf eine beliebige historische Version (durch das Rollback wird ein neuer Snapshot erstellt und der Verlauf nicht wirklich überschrieben)

Promote to module / Demote from module

Wählen Sie mehrere aufeinanderfolgende Schritte auf der Leinwand aus und klicken Sie auf „Zum Modul hochstufen“, um diese Schritte in ein unabhängiges Sub_Workflow-Modul zu extrahieren, und die ursprüngliche Position wird zum Modulaufruf. Rückwärtsbetrieb herabstufen. Siehe Details Modularisierung und Wiederverwendung.

Canvas-operationen für die linke Spalte

Neuen Knoten hinzufügen

• Die Schaltfläche „+“ in der unteren linken Ecke öffnet die Schritttypauswahl und wählt einen Hauptmodus aus.
• Es kann auch durch Ziehen des „Schrittvorlagenfragments“ aus der rechten Spalte auf die Leinwand hinzugefügt werden.

Verbinden

Ziehen Sie den Ausgabeendpunkt eines Knotens auf den Eingabeendpunkt eines anderen Knotens, um die depend_on-Beziehung automatisch in YAML hinzuzufügen. Auf der Plattform können Sie keine Kanten zeichnen, die Schleifen bilden. Wenn Sie versuchen, eine Schleife zu zeichnen, werden Sie zurückgewiesen und geröstet.

Knoten-rechtsklick-menü

• Bearbeiten – Öffnen Sie den YAML-Snippet dieses Schritts zur teilweisen Bearbeitung.
• Kopieren – Klonen Sie eine Kopie des aktuellen Schritts (die ID wird automatisch angehängt).
• Löschen – Es wird eine Warnung ausgegeben, wenn beim Löschen nachgelagerte Referenzen vorhanden sind.
• Als Start/Ende festlegen – Markiert den expliziten Ein-/Ausstieg des Workflows (nur für state_machine erforderlich).

Zoom und Minikarte

In der unteren rechten Ecke befindet sich eine Minikarte, mit der Sie schnell springen können, wenn ein komplexer Arbeitsablauf die Leinwandgröße überschreitet. Strg/Befehl + Scrollrad zum Zoomen; Leertaste + Ziehen zum Schwenken.

Rechte Spalte YAML

Automatische Vervollständigung

Basierend auf dem JSON-Schema können allgemeine Feldnamen, voreingestellte Namen und vorhandene Schritt-IDs vervollständigt werden. Strg / Befehlstaste + Space Force-Erwachen.

Fold / Unfold

Klicken Sie links neben der Zeilennummer auf den Pfeil, um den gesamten Schritt auszublenden. Tastenkombination Strg / Befehl + Umschalt + [ / ].

Suchen und ersetzen

Strg/Befehl+F Suchen, Strg/Befehl+H Ersetzen. Unterstützen Sie die Regelmäßigkeit. Es wirkt sich nur auf den aktuellen Workflow aus, andere Workflows werden davon nicht beeinflusst.

Diagnose- und Problem-Panel

Der Editor verfügt über zwei Lint-Ebenen, die denselben Satz von Regelcodes teilen:

• Sofortdiagnose auf Client-Seite — Nach jeder Bearbeitung wird sofort lokal neu berechnet (Strukturregeln wie Abhängigkeitszyklen, hängende Referenzen, Vorschläge für ähnlich geschriebene step id) und ohne Verzögerung das Problem-Panel, die Knoten-Badges und das Symbolleisten-Badge angetrieben.
• Tiefenprüfung auf Server-Seite — Wird beim Klick auf „Validieren“ in der Symbolleiste aufgerufen POST /api/workflows/lint und liefert alle Probleme auf einmal (die Speicherprüfung stoppt beim ersten Fehler, der Lint nicht) und ergänzt Regeln, die serverseitige Daten benötigen, etwa zu Agent-Presets und Modulverträgen.

Das Badge in der Symbolleiste zeigt in Echtzeit die Anzahl der Fehler / Warnungen an (rot bei Fehlern, gelb bei ausschließlich Warnungen); ein Klick löst eine Tiefenprüfung aus und öffnet das Problem-Panel. Jedes Problem im Panel trägt einen Schritt-Lokalisierungs-Chip (Klick springt zum entsprechenden Knoten) und Behebungsvorschläge; einzelne oder alle lassen sich „an die KI zur Behebung übergeben“ — der Editor setzt die Probleme zu einem strukturierten prompt zusammen und sendet ihn an den KI-Assistenten.

Rechte Schublade

AI Assistent

Klicken Sie zum Erweitern auf das Symbol „AI Assistant“ in der Mitte der rechten Spalte. Unterstützung:

• Verwenden Sie natürliche Sprache, um einen Teil der Logik zu beschreiben, der geändert werden soll, und der Assistent zeigt eine Diff-Vorschau an.
• Slash-Befehle: /execute, /validate, /export, /new, /undo, /help;
• /undo nimmt die Änderungen des Assistenten zurück (bis zu 10 Schritte); auch das editoreigene Strg / Cmd + Z kann die KI-Änderungen schrittweise rückgängig machen.

Sehen Sie sich die vollständigen Funktionen an Orchestrieren Sie mit KI-Assistenten.

Haltepunktfenster

Dieses Panel leuchtet auf, wenn die Ausführung im Debug-Modus ausgeführt wird. Sie können während der Pause Haltepunkte hinzufügen/löschen, den Trefferverlauf anzeigen und Variablen bearbeiten. Siehe Details Debuggen von Haltepunkten.

Variablen-snapshot

Wenn Sie auf einen Schritt klicken, werden alle verfügbaren Variablen angezeigt, bevor der Schritt ausgeführt wird – einschließlich var:* /steps.*.data /classifier.* /credentials.* (Anmeldeinformationswerte werden desensibilisiert angezeigt).

Kollaborative Bearbeitungssperre

Es kann jeweils nur eine Person den gleichen Workflow bearbeiten – wer zuerst einsteigt, erhält die Sperre. Wenn andere Personen darauf zugreifen, befindet es sich im schreibgeschützten Modus und in der Statusleiste wird „xxx wird bearbeitet“ angezeigt. Die Sperre wird nach 5 Minuten Inaktivität automatisch aufgehoben oder muss vom Administrator zwangsweise entsperrt werden.

Häufig verwendete Tastenkombinationen

Einige der am häufigsten im Editor verwendeten – sehen Sie sich die vollständige Liste an Tastaturkürzel.

• Ctrl / Cmd + S — Sparen
• Ctrl / Cmd + E — Ausführen (Dialogfeld öffnen)
• Ctrl / Cmd + Shift + V — Überprüfen
• Ctrl / Cmd + Z — Rückgängig machen (gilt sowohl für den YAML-Editor als auch für den KI-Assistenten)
• Ctrl / Cmd + Shift + Z — Wiederholen
• Alt + A — KI-Assistenten-Schublade wechseln
• Alt + B — Haltepunkt-Panel wechseln

Nächster Schritt

• 8 Schrittarten — Die maßgebliche Referenz zum Schreiben der einzelnen Schritte
• Yaml-syntaxreferenz — Eine ausführlichere Feldreferenz
• Ki-assistent — Verwenden Sie natürliche Sprache, um den Arbeitsablauf zu ändern