kirche-einfach/docs/flow-authoring.md

33 lines
1.5 KiB
Markdown

# Flow authoring (Langflow → Webapp)
So kommt ein neuer Flow in die Webapp:
1. **In Langflow entwerfen und speichern** (bestehende Flows sind dort
bereits geladen). Name vergeben, speichern.
2. **Sync-Button in der Verwaltung klicken** ("Aus Langflow
synchronisieren"): holt alle Flows aus Langflow nach
`backend/flows/*.json` und deployed sie danach automatisch (neue
Version nur bei geändertem Inhalt, sonst übersprungen).
3. **Prüfen:** Die Versions-Tabelle zeigt Version, Autor und Status.
Danach erscheint der Flow automatisch auf der Seite Workflows mit
seinem Formular. Flows ohne Formular-Knoten zeigen ein Freitext-Feld.
## Regeln
- Die Datei heißt wie der Flow in Langflow (z. B. `intake_form.json`).
Umbenennen in Langflow erzeugt eine neue Datei; die alte bleibt
bestehen und muss bei Bedarf gelöscht werden.
- Eine gelöschte Datei löscht den Flow inklusive seiner Läufe
(Datei bleibt in Git erhalten).
- Fehler stehen in der Sync-Meldung (z. B. ungültiges Flow-JSON).
Der automatische Beobachter im Hintergrund syncet nur Dateien,
Langflow holt nur dieser Button.
## Formular-Felder
Für ein Web-Formular braucht der Flow einen CustomInputForm-Knoten:
jeder Eintrag dort ist ein Formularfeld (Name = Feld-Key, Anzeigename
= Label). Die Verbindung ChatInput nach `form_values` bitte behalten —
darüber kommen die ausgefüllten Werte an. Unbekannte Feldtypen fallen
automatisch auf ein Textfeld zurück. Details:
`backend/components/kirche/README.md`.