Wie richte ich den Schritt Variablen setzen ein?

Wofür ist er da?

„Variablen setzen“ schreibt einen Wert in eine oder mehrere Variablen. Geben Sie den Namen einer vorhandenen Variable an, ändert sich ihr Wert. In späteren Schritten nutzen Sie den Wert als {name}.

Besucher sehen diesen Schritt nicht, und der Avatar sagt nichts; der Agent läuft weiter, ohne auf den Besucher zu warten.

Um ihn hinzuzufügen, klicken Sie im Tab „Editor“ auf „Schritt hinzufügen“ und dann in der Kategorie „Logik“ auf „Variablen setzen“; der Schritt wird in der Mitte der Arbeitsfläche hinzugefügt. Seine Einstellungen liegen im Tab „Inhalt“ des Schrittpanels, das sich rechts öffnet, wenn Sie auf den Schritt klicken.

Dieser Schritt hat keinen „Text auf dem Bildschirm“; stattdessen gibt es unten im Panel eine „Schrittnotiz“. Die Notiz ist nur für Sie: Besucher sehen sie nicht, und sie wird weder gesprochen noch übersetzt.

In Werten nutzen Sie Variablen aus früheren Schritten wie {city}. Für ein Feld in einer Antwort fügen Sie den Feldnamen nach einem Punkt an: {order.status}. Der Knopf „Variable einfügen“ in den Feldern listet die an dieser Stelle nutzbaren Variablen auf. Eine noch nicht gefüllte Variable zählt als leerer Text.

Den Schritt einrichten

1. Tippen Sie den Namen der Variable in das erste Feld unter „Zuweisungen“. Eine neue Zuweisung schlägt einen Namen vor, den der Agent noch nicht nutzt; Sie können ihn ändern.
2. Wählen Sie in der Liste daneben den Werttyp und tragen Sie darunter den Wert ein.
3. Für eine weitere Variable klicken Sie auf „Zuweisung hinzufügen“; entfernen Sie überzählige mit dem Kreuz in der Zeile („Zuweisung löschen“).

Werttypen

• „Text“: der getippte Text, der Variablen enthalten kann ({first_name} {last_name}). Bleibt er leer, wird die Variable geleert.
• „Berechnung“: Zahlen, Variablen, + − × ÷ (oder * und /) und Klammern, z. B. {total} * 1.2. Multiplikation und Division kommen zuerst. Das Ergebnis ist eine Zahl mit höchstens zwei Nachkommastellen (12.5).
• „Datum“: addiert eine Zeitspanne zu einem Startdatum; die Einheit ist Tage, Wochen, Monate oder Jahre. Ist das Startfeld leer (es zeigt „Heute“), wird das heutige Datum des Besuchers genutzt; ein negativer Betrag geht zurück in der Zeit. Das Ergebnis sieht aus wie 05.10.2026. Ein Datum jenseits des Monatsendes rückt auf den letzten Tag des Monats: 1 Monat nach dem 31. Januar ergibt den 28. (oder 29.) Februar.
• „Listenzusammenfassung“: macht aus einer Liste einen einzelnen Wert. Die Operation ist „Anzahl“, „Summe“, „Durchschnitt“, „Kleinster“, „Größter“ oder „Verbinden“; Verbinden schreibt die Werte durch Kommas getrennt nebeneinander. Für alles außer Anzahl tragen Sie im Feld daneben das zu nutzende Feld des Eintrags ein (z. B. price); ohne Feld wird der Eintrag selbst genutzt. Bei einer leeren Liste sind Anzahl und Summe 0 und die anderen leer.

Zuweisungen laufen der Reihe nach; eine spätere kann den Wert einer früheren nutzen. Ein nicht berechenbarer Wert (eine Variable, die keine Zahl ist, Division durch null, ein Start, der kein Datum ist) leert die Variable, damit der Agent nicht mit einem alten oder falschen Wert weiterläuft.

Beispiel

Eine Event-Anmeldung hat drei Zuweisungen: total („Berechnung“) {guests} * 25; total_with_tax („Berechnung“) {total} * 1.2; due_date („Datum“, leerer Start, 7 Tage). Ein Schritt Nachricht kann dann sagen: „Ihre Summe beträgt {total_with_tax}; bitte zahlen Sie bis {due_date}.“

Worauf Sie achten sollten

Der Editor warnt, wenn: es keine Zuweisungen gibt, der Name einer Zuweisung ungültig ist, ein Wert „Berechnung“ oder „Listenzusammenfassung“ leer ist oder eine Berechnung einen Tippfehler hat.

Variablennamen dürfen nur die Buchstaben a–z, Ziffern und Unterstriche (_) enthalten; Akzentbuchstaben und Leerzeichen fallen beim Tippen weg. „system“ ist für Systemvariablen reserviert, wählen Sie also einen anderen Namen.

Probleme verhindern das Speichern nicht: Der Agent wird gespeichert, aber der unvollständige Schritt funktioniert im Gespräch nicht wie erwartet. Beheben Sie die markierten Schritte und testen Sie den Agenten dann mit „Vorschau“. Wie Sie markierte Schritte finden, steht unter der Flow-Editor.