KI & JSON-Import

Der Reiter KI / JSON im Flow-Formular ermöglicht zwei ergänzende Arbeitsweisen: Sie können einen vorbereiteten Prompt für externe KI-Assistenten kopieren und den generierten JSON-Flow direkt importieren.

Wann ist dieser Weg sinnvoll?

• Sie möchten eine komplexe Automatisierung erstellen, sind sich aber nicht sicher, welche Aktionstypen und Felder am besten passen.
• Sie arbeiten mit einem KI-Assistenten (z. B. Claude oder ChatGPT) zusammen, um Flows automatisch generieren zu lassen.
• Sie haben ein Flow-JSON aus einer anderen Quelle (z. B. einem Kollegen oder einer Vorlage) und möchten es direkt laden.

---

KI-Prompt kopieren und einen Flow generieren

1. Öffnen Sie Einstellungen → Automatisierung → Flows → Flow erstellen (oder öffnen Sie einen bestehenden Flow zum Bearbeiten).
2. Wechseln Sie zum Reiter KI / JSON im Formular.
3. Klicken Sie auf KI-Prompt kopieren — der vollständige Systemprompt wird in die Zwischenablage kopiert. Der Prompt enthält:
   • Das vollständige JSON-Schema für Flows
   • Eine Beschreibung aller verfügbaren Aktionstypen und ihrer Felder
   • Alle Trigger-Typen und ihre Variablen
   • Beispiel-Flows als Orientierung
4. Öffnen Sie Ihren KI-Assistenten (z. B. Claude unter claude.ai oder ChatGPT).
5. Fügen Sie den kopierten Prompt ein und beschreiben Sie anschließend in eigenen Worten, was Ihr Flow tun soll. Beispiel:

   "Erstelle einen Flow, der ausgelöst wird, wenn eine Bewertung mit 4 oder mehr Sternen eingeht. Dann soll eine Admin-Benachrichtigung mit dem Produktnamen und dem Bewertungstext erstellt werden."

6. Der KI-Assistent antwortet mit einem JSON-Flow-Objekt.

---

Flow-JSON importieren

1. Kopieren Sie das JSON, das der KI-Assistent ausgegeben hat.
2. Fügen Sie es in das Textfeld auf dem Reiter KI / JSON ein.
3. Klicken Sie auf Validieren & Importieren.

Was passiert dann:

Ergebnis	Was das System tut
Gültiges JSON	Die Formularfelder werden automatisch mit den Werten aus dem JSON befüllt. Der Reiter wechselt auf die Formularansicht. Prüfen Sie die Felder und klicken Sie auf Speichern.
Ungültiges JSON	Fehlermeldungen erscheinen mit lesbaren Hinweisen auf das fehlerhafte Feld, z. B. "Aktion 2: Unbekannter Aktionstyp 'send_sms'". Korrigieren Sie das JSON und versuchen Sie es erneut.

---

Eigenes JSON schreiben oder anpassen

Sie können das JSON auch manuell eingeben oder ein bestehendes anpassen. Die wichtigsten Felder auf oberster Ebene:

{
  "name": "Mein Flow",
  "description": "Optionale Beschreibung",
  "trigger": "order.placed",
  "enabled": true,
  "priority": 0,
  "actions": [
    {
      "type": "create_notification",
      "config": {
        "title": "Neue Bestellung #{{trigger.orderNumber}}",
        "message": "Wert: {{trigger.total}} {{trigger.currency}}"
      }
    }
  ]
}

Verfügbare type-Werte für Aktionen

Typ	Aktionstyp
send_email	E-Mail senden
create_notification	Benachrichtigung erstellen
change_order_status	Bestellstatus ändern
add_tag	Tag hinzufügen
set_variable	Variable setzen
stop_flow	Flow stoppen
delay	Verzögerung
webhook	Webhook
conditional	Bedingte Verzweigung

---

Hinweise

• Das Importieren befüllt nur das Formular — der Flow wird erst nach dem Klick auf Speichern tatsächlich gespeichert.
• Unbekannte Aktionstypen im JSON erzeugen eine Fehlermeldung mit dem nicht erkannten Typnamen.
• Falls der KI-Assistent Felder hinzufügt, die im Schema nicht existieren, werden sie beim Importieren still ignoriert.
• Der KI-Prompt enthält keine Kundendaten oder Shop-spezifischen Informationen — er ist rein schema-beschreibend und kann bedenkenlos in externe Dienste eingefügt werden.