Variablen
Variablen sind Speicherorte für dynamische Werte innerhalb einer Unterhaltung. Sie ermöglichen es, Informationen wie Nutzerdaten oder erkannte Entitäten zu speichern und im Flow-Builder zu verwenden.
Wo finde ich Variablen?
Verwaltung von Variablen: AI Agent → Entwicklung → Variablen
Variablen im Flow Builder: Eingefügte Variablen werden farblich markiert: Blau für beschreibbare Variablen (benutzerdefiniert), Grau mit Schloss-Symbol für schreibgeschützte, automatisch befüllte Variablen (z. B. System- oder Konversationsvariablen wie Konversation-Id, Aktueller Zeitstempel). So sind Inhalt und Bearbeitungsstatus einer Variable auf einen Blick erkennbar.
Variablen-Picker: In den meisten Eingabefeldern im Flow Builder (z. B. in einem Text-Element) erscheint ein kleines Info-Menü. Es zeigt die verbleibende Zeichenanzahl, die Sprache sowie einen Button zum Einfügen von Variablen.
Was genau sind Variablen?
Variablen sind beschriftete Speicherorte für dynamische Werte, die während einer Unterhaltung im AI Agent verwendet werden. Sie ermöglichen es, Informationen wie den Namen eines Nutzers, eine IBAN oder eine Produktauswahl auf Konversations- oder Kontaktebene zu speichern und im Verlauf gezielt einzusetzen – etwa zur Anzeige in Nachrichten oder zur Prüfung in Bedingungen.
Zwei Arten von Variablen
Es gibt zwei grundlegende Arten von Variablen:
Standard Variablen werden automatisch durch das System erstellt und befüllt – z. B. durch erkannte Entitäten oder Nutzerdaten. Ihre Werte können nicht manuell bearbeitet werden und tauchen in der Variablenübersicht nicht auf. Sie können ausschließlich im Flow Builder verwendet werden.
Benutzerdefinierte Variablen werden gezielt an bestimmten Stellen im Flow gesetzt. Sie eignen sich sowohl zur Speicherung als auch zur Verwendung von Werten innerhalb des gesamten Flows – etwa in Bedingungen, Blöcken oder API-Aufrufen.
Variablen-Picker
Variablen sind in Kategorien eingeteilt. Diese Kategorien werden auch im Variablen-Picker angezeigt und gruppieren Variablen nach Zweck und Ursprung:
Konversation
Automatische Variablen: Informationen zur laufenden Konversation
Konversation-ID, Sprache, Kanal-Typ
Kontakt
Automatische Variablen: Daten zum Nutzer
Name, Telefonnummer
System
Automatische Variablen: technische Systemvariablen
ID des AI Agents, aktueller Zeitstempel
Automatische Variablen: Werte aus erkannten Entitäten basierend auf der letzten Nutzereingabe
IBAN, Datum, Rechnungsnummer
Benutzerdefiniert
Kontakt
Konversation
Manuelle Variablen: Speicherung beliebiger Werte, flexibel im gesamten Flow nutzbar. Unterteilt in die Subkategorien Konversation und Kontakt
Kundennummer, gewähltes Produkt, Kundenanliegen
Automatische Variablen: Daten aus externen Quellen bzw. integrierten App-Modulen
Versanddienstleister → Abfrage Sendestatus → Sendestatus
Besonderheit bei App-Modulen: Für jedes App-Modul gibt es im Variablen-Picker eine eigene Kategorie, unter der die zugehörigen Variablen übersichtlich gruppiert sind.
Darstellung von Variablen im Flow Builder
Je nach Herkunft einer Variable gibt es zwei Darstellungstypen für Variablennamen im Flow Builder:
Feste Kategorien (z. B. System, Benutzerdefiniert):
Name der Variable (Kategorie)App-Module:
Name der App → Name des App-Moduls → Name der Variable
Zusätzlich sind Variablen farblich gekennzeichnet:
Blau = beschreibbar (benutzerdefinierte Variablen), z. B. Zusammenfassung (Benutzerdefiniert - Konversation)
Grau mit Schloss-Symbol = schreibgeschützt, z. B. Konversation-Id (Konversation) oder Aktueller Zeitstempel (System)
Was kann man mit Variablen machen?
Werte zuweisen
Die manuelle Zuweisung von Werten ist ausschließlich bei benutzerdefinierten Variablen möglich. Variablen aus den Kategorien Kontakt, Konversation, System oder Entitäten werden automatisch befüllt und können nicht manuell überschrieben werden.
Standardwert festlegen
Für eine benutzerdefinierte Variable kann ein Standardwert hinterlegt werden. Dieser ist von Beginn an in der Variable gespeichert und bleibt bestehen, solange er nicht aktiv überschrieben wird.
Der Standardwert kann entweder direkt bei der Erstellung der Variable festgelegt werden, oder nachträglich bei der Bearbeitung angepasst werden.
Werte im Flow Builder zuweisen
Öffne den Block, in dem einer Variable ein Wert zugewiesen werden soll (z. B. nach der Erkennung der Entität IBAN durch eine Benutzereingabe).
Füge ein Element vom Typ Variable Wert zuweisen hinzu.
Klicke auf „Variable auswählen", um den Variablen-Picker zu öffnen.
Wähle die Variable aus, in der der Wert gespeichert werden soll. Da nur benutzerdefinierte Variablen manuell befüllt werden können, zeigt der Variablen-Picker in diesem Kontext ausschließlich Variablen dieser Kategorie an.
Trage im Feld „Folgenden Wert zuweisen" den gewünschten Wert ein oder füge über den Variablen-Picker einen bestehenden Wert ein (z. B. aus einer anderen Variable oder einer Entität). Es kann sowohl ein statischer Text als auch ein Variablenwert verwendet werden – auch eine Kombination ist möglich.
Verwendung im Flow Builder
Variablen sind zentrale Bausteine im Flow Builder. Sie lassen sich über den Variablen-Picker in nahezu jedem Eingabe-Textfeld verwenden, um Inhalte dynamisch zu gestalten, Entscheidungen zu treffen oder externe Systeme anzusprechen.
Ausgabe an Nutzer
Verwende Variablen in Nachrichten, um personalisierte Antworten zu erzeugen:
Hallo Vorname (Benutzerdefiniert - Kontakt), darf ich die Telefonnummer: Telefonnummer (Kontakt) notieren?Der aktuelle Bestellstatus ist:
Versanddienstleister → Abfrage Sendestatus → Sendestatus
Vergleiche in Bedingungen
Nutze Variablen, um logische Entscheidungen im Flow zu treffen:
Wenn
Angerufene Rufnummer (Konversation)– gleich (==) –0123456789Wenn
Anzahl Artikel (Benutzerdefiniert - Konversation)– größer als (>) –3
App-Module
Übergib Variablenwerte an externe Module oder API-Aufrufe:
Die Trackingnummer als Parameter eines Versanddienstleister-App-Moduls
Name und Produktwahl im Body eines E-Mail-App-Moduls
Zwischenspeicher für Nutzerinteraktionen
Speichere Antworten von Nutzern dauerhaft in Variablen, um sie später weiterzuverarbeiten:
Der erkannte Wert der Entität
IBAN (Entität)wird in der benutzerdefinierten VariableIBAN (Benutzerdefiniert - Kontakt)gespeichert, um ihn im weiteren Verlauf flexibel nutzen zu können.
Verwaltung – Erstellung, Bearbeitung und Löschen
Die folgenden Funktionen beziehen sich ausschließlich auf benutzerdefinierte Variablen. Automatisch befüllte Variablen (z. B. aus den Kategorien Kontakt, Konversation, System oder Entitäten) können nicht bearbeitet oder gelöscht werden.
Variable erstellen
Klicke oben rechts in der Variablenübersicht auf den Button „Variable erstellen".
Beim Erstellen einer Variable sind folgende Einstellungen vorzunehmen:
1. Namen festlegen
Der gewählte Name ist später im Variablen-Picker sowie im Flow Builder sichtbar – z. B. bei Bedingungen oder Aktionen. Wähle einen aussagekräftigen und eindeutigen Namen, damit die Verwendung im Flow nachvollziehbar bleibt.
2. Speicherort wählen (Subkategorie)
Legt fest, ob die Variable einer Konversation oder einem Kontakt zugeordnet wird.
Konversation: Die Variable gilt nur für die aktuelle Konversation. Nach dem Ende einer Unterhaltung wird der Wert nicht weiter gespeichert.
Kontakt: Die Variable ist dem Kontakt dauerhaft zugeordnet. Ihr Wert bleibt über mehrere Konversationen hinweg erhalten und steht beim nächsten Kontakt wieder zur Verfügung.
Die Subkategorie einer benutzerdefinierten Variable wird beim Erstellen festgelegt und kann nachträglich nicht geändert werden. Um die Subkategorie zu wechseln, muss eine neue Variable angelegt werden.
3. Datentyp auswählen
Beim Erstellen stehen vier Datentypen zur Auswahl:
(.*)Text#Zahl<>Boolescher Wert (WAHR/FALSCH){}Objekt
In den meisten Fällen eignet sich der Datentyp „Text", da er besonders flexibel einsetzbar ist.
4. Standardwert festlegen (optional)
Dieser Wert wird verwendet, wenn der Variable im Flow Builder noch kein Wert zugewiesen wurde. Das ist besonders praktisch für Initialwerte oder Fallbacks.
Variable bearbeiten
Variablen können jederzeit über die Variablenübersicht bearbeitet werden. Klicke dazu auf das Stift-Symbol am rechten Ende der entsprechenden Zeile.
Im Dialog „Variable bearbeiten" können folgende Einstellungen angepasst werden:
Name ändern: Eine Änderung des Variablennamens wirkt sich automatisch auf alle Verwendungsstellen im Flow aus. So bleibt der Flow konsistent, ohne dass manuelle Anpassungen nötig sind.
Standardwert anpassen: Der optionale Standardwert kann jederzeit geändert werden.
Der Datentyp einer Variable sowie deren Subkategorie kann nachträglich nicht geändert werden. Es muss eine neue Variable angelegt werden.
Variable löschen
Variablen können über die Variablenübersicht gelöscht werden. Klicke dazu auf das Mülleimer-Symbol am rechten Ende der entsprechenden Zeile.
Beim Löschen einer Variable wird diese an allen Stellen aus dem Flow entfernt. Prüfe daher vor dem Löschen, an welchen Stellen im Flow die Variable verwendet wird – z. B. in Bedingungen und App-Modulen.
Das Löschen einer Variable kann zu Logikfehlern führen, insbesondere wenn sie zuvor in Bedingungen verwendet wurde. Wird eine Variable z. B. in einer Bedingung abgefragt (Anzahl Artikel (Benutzerdefiniert - Konversation) – gleich (==) – "42") und später gelöscht, bleibt die Bedingung bestehen – aber ohne gültige Vergleichsgrundlage. Das kann dazu führen, dass:
Bedingungen immer „falsch" auswerten und bestimmte Pfade nicht mehr erreichbar sind,
unerwartete Flow-Verzweigungen auftreten oder
wichtige Aktionen nicht mehr ausgeführt werden.
Überprüfe nach dem Löschen den Flow zusätzlich auf mögliche Logikfehler und leere Felder. Gelöschte Variablen werden im Flow rot hinterlegt und wie folgt dargestellt: Variable nicht vorhanden.
Beispiele
Werte von Entitäten in Variablen speichern (Beispiel: IBAN)
Wenn die IBAN eines Nutzers als Entität erkannt wurde und dieser Wert dauerhaft gespeichert werden soll, ist folgendes zu beachten: Entitätswerte werden nach jeder Benutzereingabe zurückgesetzt. Der Wert muss daher explizit und unmittelbar in einer Variable gespeichert werden, um im weiteren Verlauf verfügbar zu bleiben.
Schritte zum Speichern einer Entität in einer Variable:
Öffne den Block, in dem die Variable befüllt werden soll – hier: nach der Erkennung der Entität IBAN durch eine Benutzereingabe.
Füge ein Element vom Typ Variable Wert zuweisen hinzu.
Klicke auf „Variable auswählen", um den Variablen-Picker zu öffnen.
Wähle die Variable
IBAN (Benutzerdefiniert - Kontakt)aus.Öffne im Feld „Folgenden Wert zuweisen" erneut den Variablen-Picker.
Wähle unter der Kategorie Entitäten die Entität
IBAN (Entität)aus.
Die erkannte IBAN ist nun dauerhaft in der Variable IBAN (Benutzerdefiniert - Kontakt) gespeichert und steht im weiteren Flow-Verlauf zur Verfügung.
Best Practices
Wähle in den meisten Fällen den Datentyp „Text" für benutzerdefinierte Variablen. Er ist besonders flexibel und universell einsetzbar. Da:
Universell nutzbar: Es lassen sich damit die unterschiedlichsten Werte speichern – z. B. Texte, Zahlen, IDs oder Codes.
Kompatibel mit Bedingungen: Auch wenn eine Zahl als Text gespeichert wird, erkennt das System bei Vergleichen automatisch den richtigen Typ.
Beispiel: Wird der Wert
42als Text in der VariableAnzahl Artikel (Benutzerdefiniert - Konversation)gespeichert, können trotzdem Bedingungen mit numerischen Vergleichsoperatoren verwendet werden:Anzahl Artikel (Benutzerdefiniert - Konversation) – gleich (==) – "42"Anzahl Artikel (Benutzerdefiniert - Konversation) – größer gleich (>=) – "20"Das System interpretiert den Variablenwert korrekt als Zahl. Operatoren wiegleich (==),größer gleich (>=)undkleiner gleich (<=)funktionieren problemlos.
Speicherort bewusst wählen
Überlege vor dem Erstellen einer benutzerdefinierten Variable genau, ob der Wert nur für die aktuelle Konversation relevant ist oder auch in zukünftigen Unterhaltungen mit demselben Kontakt zur Verfügung stehen soll. Da die Subkategorie nachträglich nicht geändert werden kann, lohnt sich diese Entscheidung im Voraus.
Für flüchtige Werte wie Zwischenergebnisse oder Gesprächskontext → Konversation
Für dauerhafte Nutzerdaten wie Kundennummer, Produktvorlieben oder Kontakthistorie → Kontakt
Last updated