Gesprächs-Flows bauen

Ein Flow beschreibt, wie ein Gespräch abläuft. Du baust ihn im Flow-Editor als Zustandsgraph: eine Landkarte aus Zuständen (States) und Übergängen zwischen ihnen.

Der Flow-Editor

Der Flow-Editor ist eine grafische Oberfläche, in der du Zustände als Knoten anordnest und mit Verbindungen (Übergängen) verknüpfst. Du kannst den Graphen frei anordnen, Zustände hinzufügen, bearbeiten und wieder entfernen.

Flow-Editor mit Zustandsliste und Zustands-Konfiguration — Der Flow-Editor: links die Zustandsliste, rechts die Konfiguration des gewählten Zustands (Anweisungen, erlaubte Tools, Ausgänge).

Rückgängig und Wiederherstellen

Jede Änderung im Entwurf lässt sich rückgängig machen. Das gilt für bearbeitete Felder und Typwechsel ebenso wie für gelöschte Zustände und einen Flow-Import. Nutze dafür die Schaltflächen Rückgängig und Wiederherstellen in der Kopfzeile des Editors oder die Tastenkürzel.

Aktion	Windows / Linux	macOS
Rückgängig	`Strg` + `Z`	`⌘` + `Z`
Wiederherstellen	`Strg` + `Umschalt` + `Z` oder `Strg` + `Y`	`⌘` + `Umschalt` + `Z`

Tippst du mehrere Zeichen hintereinander in dasselbe Feld, zählt das als ein einziger Schritt. Der Verlauf umfasst die letzten 50 Schritte und gilt, solange der Editor geöffnet ist. Steht der Cursor in einem Textfeld, wirken die Tastenkürzel auf das Textfeld selbst.

Sicherheitsabfragen

Bevor der Editor etwas verwirft, fragt er nach und nennt die Folgen.

Zustand löschen zeigt, wie viele Ausgänge anderer Zustände auf diesen Zustand zeigen und dadurch ihr Ziel verlieren. Ist es der Startzustand, weist der Dialog darauf hin, dass der Flow danach keinen Einstiegspunkt mehr hat.
Typ ändern (Standard, Weiterleitung, Auflegen) listet auf, was dabei verloren geht, etwa Ausgänge, Bedingungen, erlaubte Tools oder die Weiterleitungsnummer. Ein späteres Zurückstellen des Typs holt diese Angaben nicht zurück.
Flow importieren weist darauf hin, dass der Import jeden Zustand im Entwurf ersetzt.

Alle drei Aktionen kannst du anschließend mit Rückgängig zurücknehmen.

Zustände

Ein Flow besteht aus Zuständen – den Schritten des Gesprächs. Ein Zustand trägt eigene Anweisungen, erlaubte Tools und Übergänge zu Folgezuständen. Zwei zusätzliche Punkte schließen das Gespräch ab:

Weiterleiten

Verbindet den Anruf an eine externe Rufnummer (z. B. an einen Menschen).

Auflegen

Beendet den Anruf.

Übergänge und Bedingungen

Ein Zustand besitzt Outputs – benannte, sortierte Übergänge zu Folgezuständen. Jeder Output ist an eine Bedingung geknüpft:

ein Tool, das im Zustand aufgerufen wurde,
ein erwarteter Response-Code (das Ergebnis des Tools),
optional negiert (“trifft nicht zu”).

Beim Durchlaufen prüft der Agent die Outputs in ihrer Reihenfolge. Der erste passende Übergang bestimmt den Folgezustand.

Ohne Response-Code kein Übergang. Löst ein Tool keinen deklarierten Response-Code aus, bleibt der Agent im aktuellen Zustand. So behältst du die Kontrolle über den Gesprächsverlauf.

Beispiel

[Begrüßung & Anliegen]
   ── classify → "termin"    →  [Termin buchen]
   ── classify → "sonstiges" →  [Weiterleiten: an Praxis]

[Termin buchen]
   ── book_appointment → "ok"        →  [Auflegen: Verabschiedung]
   ── book_appointment → "kein_slot" →  [Termin buchen]

Tools im Zustand

Pro Zustand legst du fest, welche Tools der Agent dort verwenden darf. Sie stammen aus drei Kategorien (Details unter Integrationen & Tools):

Built-In-Tools – plattform-eigen und ohne Konfiguration, etwa classify zum Einordnen des Anliegens. Die Kategorien werden zu Response-Codes für deine Übergänge.
Connector-Tools – fachliche Aktionen wie „Termin buchen” oder „Patient suchen”, die über einen Connector an dein System gehen (z. B. planorg PVS).
MCP-Tools – Tools eines angebundenen MCP-Servers.

classify, Weiterleitung und Auflegen funktionieren vollständig. Die Connector-Tool-Ausführung ist für die angebundenen Systeme (MCP-Server, planorg PVS, Demo-Connectoren) live.

Zustands-Anweisungen

Jeder Zustand kann eigene Anweisungen tragen, die nur dort gelten (zusätzlich zu den Basis-Instructions des Agenten).

Wie du gute Anweisungen formulierst – global und pro Schritt – zeigt der Prompting-Guide.

Validierung

Der Editor prüft deinen Flow laufend – etwa ob alle Zustände erreichbar sind und Übergänge gültig sind. Offene Punkte werden angezeigt, bevor du veröffentlichst.

Versionierung

Entwurf bearbeiten

Du arbeitest immer auf einem bearbeitbaren Entwurf (Draft).

Veröffentlichen

Beim Veröffentlichen wird der Entwurf validiert und als unveränderliche, nummerierte Version gespeichert.

Aktivieren

Du setzt eine Version als Live-Version. Neue Anrufe nutzen sie ab sofort.

Frühere Versionen kannst du schreibgeschützt einsehen und bei Bedarf wieder als Entwurf öffnen.

Flows importieren und exportieren

Du kannst einen kompletten Flow als JSON-Datei exportieren und an anderer Stelle wieder importieren – praktisch zum Sichern, Duplizieren oder Übertragen zwischen Agenten.

Exportieren

Öffne im Flow-Editor das ⋮-Menü (oben rechts) und wähle Flow exportieren. Der Dialog zeigt die Flow-Daten als JSON an. Du kannst sie kopieren oder mit Datei herunterladen als JSON-Datei speichern. Export ist auch in der schreibgeschützten Versionsansicht möglich.

Importieren

Öffne im Entwurf dasselbe Menü und wähle Flow importieren. Ziehe im Reiter Datei eine zuvor exportierte JSON-Datei in den Dialog oder füge das JSON im Reiter Text ein. Mit Flow importieren ersetzt der Inhalt den aktuellen Entwurf. Prüfe das Ergebnis anschließend mit einem Test-Anruf.

Der Import überschreibt den bestehenden Entwurf. Bereits veröffentlichte Versionen bleiben unberührt – der importierte Flow wird erst mit dem nächsten Veröffentlichen zu einer Version. Gefällt dir das Ergebnis nicht, holst du den vorherigen Entwurf mit Rückgängig zurück.

Denselben Flow kannst du in beliebig viele Agenten importieren, auch mandantenübergreifend. Jeder Agent verwaltet die Zustände seines Entwurfs getrennt von allen anderen. Einen kompletten Agenten samt Instructions und Connectoren überträgst du über den Agenten-Export.

Aufbau einer Export-Datei

Die Datei enthält ein Objekt flow mit:

startStateId – ID des Start-Zustands.
statesOrder – Reihenfolge der Zustände.
states – die Zustände, je Schlüssel eine Zustands-ID. Ein Zustand trägt:
- type – REGULAR, FORWARD oder HANGUP.
- name – Anzeigename.
- stateInstructions – die Anweisungen des Zustands.
- allowedTools – erlaubte Tools (bei REGULAR).
- outputsOrder / outputs – die Ausgänge. Jeder Ausgang hat ein Ziel (transitionTo) und conditions aus tool, responseCode und isNegated.
Ein FORWARD-Zustand trägt zusätzlich die Ziel-Rufnummer, ein HANGUP-Zustand nur Name und Anweisungen.

Beispiel

Ein exportierter Flow (Auszug aus dem Demo-Agenten „Forderungsmanagement”):

{
  "flow": {
    "startStateId": "3b3aeb6f-3f07-4a7d-9e72-29ec1c728179",
    "statesOrder": [
      "3b3aeb6f-3f07-4a7d-9e72-29ec1c728179",
      "5ea95814-f003-4497-ab48-b7198ff6e4b1",
      "1d206d25-7529-407c-a29f-f516d66d2866",
      "ebc687d6-ed86-4ac8-b6ab-412061367298"
    ],
    "states": {
      "3b3aeb6f-3f07-4a7d-9e72-29ec1c728179": {
        "type": "REGULAR",
        "name": "S1 Begrüßung & Identifikation",
        "stateInstructions": "Begrüße den Anrufer und frage nach Geburtsdatum und Kundennummer. Frage so lange nach, bis beides genannt wurde.",
        "allowedTools": ["verify_customer"],
        "outputsOrder": ["0ee3293b-6e72-4472-9cb1-5a7f48a7b460"],
        "outputs": {
          "0ee3293b-6e72-4472-9cb1-5a7f48a7b460": {
            "name": "Ausgang 1",
            "transitionTo": "5ea95814-f003-4497-ab48-b7198ff6e4b1",
            "conditions": [
              { "tool": "verify_customer", "responseCode": "CUSTOMER_VERIFIED", "isNegated": false }
            ]
          }
        }
      },
      "5ea95814-f003-4497-ab48-b7198ff6e4b1": {
        "type": "REGULAR",
        "name": "S2 Saldo mitteilen & Absicht klären",
        "stateInstructions": "Rufe den offenen Betrag ab und lies ihn samt Rechnungsgrund und Fälligkeit vor. Frage, ob eine Ratenzahlung gewünscht ist.",
        "allowedTools": ["get_balance", "classify"],
        "outputsOrder": ["3477d025-58a5-4eb8-ae38-7369ada2ed13"],
        "outputs": {
          "3477d025-58a5-4eb8-ae38-7369ada2ed13": {
            "name": "Ausgang 1",
            "transitionTo": "1d206d25-7529-407c-a29f-f516d66d2866",
            "conditions": [
              { "tool": "classify", "responseCode": "Ratenzahlung gewünscht", "isNegated": false }
            ]
          }
        }
      },
      "1d206d25-7529-407c-a29f-f516d66d2866": {
        "type": "REGULAR",
        "name": "S3 Ratenplan aushandeln",
        "stateInstructions": "Frage nach Wunsch-Ratenanzahl ODER Wunschrate. Lies den Plan vor und hole ein klares Ja ein, bevor du verbindlich vereinbarst.",
        "allowedTools": ["propose_installment_plan", "agree_installment_plan"],
        "outputsOrder": ["0ac15add-b8f1-4f38-8c84-4b46352b2141"],
        "outputs": {
          "0ac15add-b8f1-4f38-8c84-4b46352b2141": {
            "name": "Ausgang 1",
            "transitionTo": "ebc687d6-ed86-4ac8-b6ab-412061367298",
            "conditions": [
              { "tool": "agree_installment_plan", "responseCode": "AGREEMENT_CONFIRMED", "isNegated": false }
            ]
          }
        }
      },
      "ebc687d6-ed86-4ac8-b6ab-412061367298": {
        "type": "HANGUP",
        "name": "Verabschiedung",
        "stateInstructions": "Fasse das Ergebnis in einem Satz zusammen, bedanke dich und verabschiede dich."
      }
    }
  }
}

Einstieg

Agenten & Gespräche

Integration & Tools

Auswertung & Verwaltung

Gesprächs-Flows bauen

Der Flow-Editor

Rückgängig und Wiederherstellen

Sicherheitsabfragen

Zustände

Weiterleiten

Auflegen

Übergänge und Bedingungen

Beispiel

Tools im Zustand

Zustands-Anweisungen

Validierung

Versionierung

Flows importieren und exportieren

Aufbau einer Export-Datei

Beispiel

​Der Flow-Editor

​Rückgängig und Wiederherstellen

​Sicherheitsabfragen

​Zustände

Weiterleiten

Auflegen

​Übergänge und Bedingungen

​Beispiel

​Tools im Zustand

​Zustands-Anweisungen

​Validierung

​Versionierung

​Flows importieren und exportieren

​Aufbau einer Export-Datei

​Beispiel

Der Flow-Editor

Rückgängig und Wiederherstellen

Sicherheitsabfragen

Zustände

Übergänge und Bedingungen

Beispiel

Tools im Zustand

Zustands-Anweisungen

Validierung

Versionierung

Flows importieren und exportieren

Aufbau einer Export-Datei

Beispiel