Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Flow-Builder

Der Flow-Builder ist die zentrale Arbeitsumgebung, in der du das Verhalten deines AI Agents gestaltest. Auf einem Canvas ordnest du Schritte an, verbindest sie miteinander und definierst den Prozess.

Wo finde ich den Flow Builder?

Du erreichst den Flow Builder über AI Agent → Entwicklung → Flow-Builder. Dort wird zunächst die Flow-Übersicht angezeigt – eine Tabellenansicht aller vorhandenen Flows. Mit einem Klick auf einen Flow gelangst du in den jeweiligen Canvas, also die visuelle Arbeitsfläche des Flow Builders.

Erklärung – Was genau ist der Flow Builder?

Der Flow Builder ist ein visueller Editor, in dem du den Gesprächsablauf deines AI Agents per Drag & Drop zusammenbaust. Die Arbeitsfläche wird als Canvas bezeichnet. Auf diesem Canvas platzierst du sogenannte Schritte – also die einzelnen Bausteine eines Flows – und verbindest sie über Verbindungslinien miteinander.

Jeder Flow hat einen eigenen Canvas. Innerhalb dieses Canvas bestimmst du, was der AI Agent tun soll: Nachrichten senden, auf Nutzereingaben warten, Bedingungen prüfen, Variablen setzen, externe Dienste aufrufen und vieles mehr.

Die Benutzeroberfläche des Flow Builders besteht aus drei Bereichen:

  • Navigation (links): Die Hauptnavigation der Plattform bleibt dauerhaft sichtbar und ermöglicht dir jederzeit den Wechsel zu anderen Bereichen.

  • Canvas (Mitte): Die zentrale Arbeitsfläche, auf der du Schritte platzierst, verbindest und bearbeitest.

  • Seitenleiste „Schritt hinzufügen" (rechts): Hier findest du alle verfügbaren Schritttypen, gruppiert nach Kategorien. Die Seitenleiste lässt sich bei Bedarf ein- und ausklappen.

Navigation und Bedienung im Canvas

Canvas bewegen und zoomen

Du kannst den Canvas frei bewegen und zoomen, um auch bei komplexen Flows den Überblick zu behalten:

  • Verschieben (Panning): Halte die Maustaste auf einer freien Fläche gedrückt und ziehe den Canvas in die gewünschte Richtung.

  • Zoomen: Nutze das Mausrad, um rein- oder rauszuzoomen. Alternativ stehen in der Toolbar am unteren Rand des Canvas die Schaltflächen + und – sowie eine prozentuale Zoom-Anzeige zur Verfügung.

  • Alles anzeigen: Passt den Bildausschnitt automatisch an, damit alle eingefügten Schritte sichtbar sind.

  • Anordnen: Ordnet die Schritte auf dem Canvas automatisch an.

Sprache wechseln

In der Toolbar findest du außerdem ein Sprach-Dropdown. Darüber wählst du die Sprache aus, für die du aktuell Inhalte konfigurierst – z. B. „Deutsch". Die Sprachauswahl betrifft sprachabhängige Inhalte wie Textnachrichten in Blöcken.

Tastenkürzel

Der Flow Builder unterstützt einige gängige Tastenkürzel, die deine Arbeit beschleunigen:

  • Strg + C / Strg + V – Schritt(e) kopieren und einfügen

  • Backspace – Ausgewählte Schritte löschen

  • Shift + Mausklick – Mehrere Schritte auswählen (Mehrfachauswahl)

  • Strg + F – Browser-Suche öffnen (um Text auf dem Canvas zu finden)

Schritte – Die Bausteine deines Flows

Schritte sind die einzelnen Bausteine, aus denen ein Flow aufgebaut ist. Jeder Schritt erfüllt eine bestimmte Aufgabe – z. B. eine Nachricht senden, eine Bedingung prüfen oder einen externen Dienst aufrufen.

Verfügbare Schritttypen

Die Schritttypen sind in der rechten Seitenleiste nach Kategorien gruppiert. Die wichtigsten Kategorien im Überblick:

Schritte hinzufügen

  1. Klicke in der rechten Seitenleiste auf den gewünschten Schritttyp und ziehe in auf den Canvas.

  2. Klicke auf den neuen Schritt, um ihn zu konfigurieren – der jeweilige Bearbeitungsdialog öffnet sich.

Schritte bearbeiten

Klicke auf einen Schritt im Canvas, um seinen Bearbeitungsdialog zu öffnen. Je nach Schritttyp stehen unterschiedliche Konfigurationsmöglichkeiten zur Verfügung – z. B. Name, Beschreibung, Elemente, Bedingungen oder Prompt-Eingaben.

Schritte verschieben

Schritte lassen sich per Drag & Drop frei auf dem Canvas positionieren. Ziehe einen Schritt einfach an die gewünschte Stelle. Bestehende Verbindungen bleiben dabei erhalten.

Um mehrere Schritte gleichzeitig zu verschieben, nutze die Mehrfachauswahl: Halte Shift gedrückt und klicke die gewünschten Schritte an. Anschließend kannst du die gesamte Auswahl gemeinsam verschieben.

Schritte kopieren: Innerhalb eines AI Agents

Du kannst einen oder mehrere Schritte kopieren und an anderer Stelle im Canvas einfügen:

  • Per Tastenkürzel: Wähle einen oder mehrere Schritte aus und drücke Strg + C zum Kopieren, dann Strg + V zum Einfügen.

  • Per Rechtsklick: Wähle einen oder mehrere Schritte aus, klicke mit der rechten Maustaste und wähle „Kopieren" aus dem Kontextmenü.

Beim Kopieren werden die Schritte inklusive ihrer Konfiguration dupliziert. Sofern verbundene Schritte mitkopiert werden, werden auch die Verbindungen dupliziert.

Trigger und Intentionen sowie Einstieg und Fallback können nicht kopiert werden, da sie im AI Agent einzigartig sind.

Schritte kopieren: In einen anderen AI Agent

Du kannst Blöcke nicht nur innerhalb eines AI Agents kopieren, sondern auch von einem AI Agent in einen anderen einfügen – unabhängig davon, ob sich beide im selben Workspace befinden.

Beim Kopieren zwischen AI Agents gelten jedoch einige Einschränkungen:

Was wird nicht mitkopiert:

  • Variablen, Entitäten und Tags: Diese werden nicht automatisch übertragen. Sie können im Ziel-AI Agent als Platzhalter oder gelöschte Elemente angezeigt werden. Stelle sicher, dass die benötigten Ressourcen im Ziel-AI Agent vorhanden sind, oder lege sie dort nachträglich an.

  • Intentionen und Trigger: Diese können grundsätzlich nicht kopiert werden.

  • App-Module: Auch App-Module werden nicht mit übertragen.

Sprache beachten: Die Ausgangssprache des kopierten Blocks sollte im Ziel-AI Agent vor dem Einfügen aktiviert werden. Andernfalls können die Textinhalte nicht übernommen werden.

Schritte löschen

Es gibt mehrere Wege, einen Schritt zu löschen:

  • Über den Bearbeitungsdialog: Öffne den Schritt und klicke auf das Papierkorb-Symbol.

  • Per Tastatur: Wähle einen oder mehrere Schritte aus und drücke Backspace.

  • Per Rechtsklick: Wähle einen oder mehrere Schritte aus, klicke mit der rechten Maustaste und wähle „Löschen" aus dem Kontextmenü.

Das Löschen eines Schritts entfernt auch alle Verbindungen, die von oder zu diesem Schritt führen. Überprüfe nach dem Löschen den Flow auf fehlende Verbindungen oder Logiklücken.

Schritte verbinden

Verbindungen zwischen Schritten legen fest, in welcher Reihenfolge der AI Agent die Schritte durchläuft. Verbindungen werden als Linien zwischen den Schritten dargestellt und zeigen die Richtung des Gesprächsflusses an.

Unverbundene Schritte und Ausgänge führen automatisch in den Fallback.

Verbindung erstellen

  1. Bewege die Maus über den Ausgangspunkt (den kleinen Kreis) am rechten Rand eines Schritts.

  2. Klicke und ziehe eine Linie zum Eingangspunkt des gewünschten Zielschritts.

  3. Lasse die Maustaste los, um die Verbindung herzustellen.

Verfügt ein Schritt über mehrere Ausgänge – z. B. bei einer Bedingung (Wahr/Falsch) oder einem Kontext-Schritt –, wird beim Ziehen einer Verbindung ein Auswahlmenü mit den verfügbaren Ausgängen angezeigt. Wähle den gewünschten Ausgang aus, um die Verbindung zuzuordnen.

Die Verbindungslinien werden automatisch mit dem Namen des jeweiligen Ausgangs beschriftet, sodass du auf einen Blick erkennst, welcher Pfad wohin führt.

Verbindung entfernen

Um eine bestehende Verbindung zu entfernen, klicke direkt auf die Verbindungslinie. Die Verbindung wird dadurch gelöscht.

Verbindung neu zuweisen

Du kannst einen Ausgang auch direkt neu verbinden, ohne die alte Verbindung vorher zu löschen. Ziehe dazu eine neue Linie vom Ausgangspunkt des Schritts zum gewünschten neuen Zielschritt. Die bisherige Verbindung wird automatisch durch die neue ersetzt.

IDs im Flow Builder

Innerhalb deines AI Agents sind alle Elemente über eindeutige IDs identifizierbar. Das betrifft Flows, Schritte, Tags, Variablen und weitere Objekte.

Für Flows und Schritte gilt dabei folgendes System:

  • Flow-IDs sind pro AI Agent einmalig. Jeder Flow hat eine eindeutige ID, die in der Flow-Tabellenansicht angezeigt wird.

  • Schritt-IDs sind pro Flow einmalig. Ein Schritt hat innerhalb seines Flows eine eindeutige ID. Dieselbe ID kann aber in einem anderen Flow erneut vorkommen.

Durch die Kombination aus Flow-ID und Schritt-ID bleibt jeder Schritt im gesamten AI Agenteindeutig identifizierbar.

IDs sind vor allem dann relevant, wenn du mit der API arbeitest, die Rohdaten auswertest oder bei Support-Anfragen einen bestimmten Schritt oder Flow referenzieren möchtest.

Best Practices

  • Schritte logisch anordnen: Platziere Schritte auf dem Canvas so, dass der Gesprächsfluss von links nach rechts oder von oben nach unten verläuft. Das erleichtert die Orientierung – besonders bei größeren Flows.

  • Aussagekräftige Namen vergeben: Benenne jeden Schritt so, dass sein Zweck auf einen Blick erkennbar ist – z. B. „IBAN abfragen" statt „Block 1". Das spart Zeit bei der späteren Wartung.

  • Subflows für Struktur nutzen: Lagere wiederkehrende oder thematisch abgegrenzte Abläufe in Subflows aus. Das hält den Hauptflow übersichtlich und macht einzelne Teile wiederverwendbar.

  • Verbindungen regelmäßig prüfen: Stelle sicher, dass alle Ausgänge mit einem Folgeschritt verbunden sind. Unverbundene Ausgänge können dazu führen, dass der Fallback ausgelöst wird oder der Flow unerwartet endet.

  • Beschreibungsfelder nutzen: Viele Schritte bieten ein optionales Beschreibungsfeld. Nutze es, um den Zweck eines Schritts zu dokumentieren – besonders bei komplexen Flows oder wenn mehrere Personen am AI Agent arbeiten.

  • Mehrfachauswahl für Effizienz: Nutze Shift + Klick und die Kopier-Funktion, um ähnliche Schritte schnell zu duplizieren und anzupassen, anstatt sie einzeln neu zu erstellen.

PreviousBuildNextFlows

Last updated