Wie richte ich den Schritt Liste bearbeiten ein?

Wofür ist er da?

„Liste bearbeiten“ bearbeitet eine Liste und schreibt das Ergebnis in eine neue Variable. Die Liste stammt meist aus der Antwort eines Tool-Aufrufs oder einer Integrationsaktion; auch eine Mehrfachauswahl-Antwort ist eine Liste.

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 „Liste bearbeiten“; 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. Schreiben Sie bei „Liste“ den Pfad zur Liste selbst, etwa {answer.items}; die ganze Antwort ist keine Liste. Steht die Liste in der Antwort eines Tool-Aufrufs, klicken Sie auf „Beispieldaten abrufen“, um das Tool einmal aufzurufen: Sie wählen eine der „Listen in der Antwort“ und sehen die „Felder der ersten Zeile“.
2. Schalten Sie die gewünschten Operationen ein (siehe unten).
3. Tragen Sie den „Variablenname“ ein, in den das Ergebnis geschrieben wird. {list} ergibt die ganze Liste, {list.1.field} ein Feld des ersten Eintrags.

Operationen

Die Operationen laufen immer in dieser Reihenfolge, damit Ergebnisse wie „die 5 günstigsten“ stimmen:

• „Filtern“: Nur Einträge, die die Regeln erfüllen, bleiben. Die Regeln funktionieren wie im Schritt Bedingung; schreiben Sie das Feld des Eintrags als {item.field} ({item}, wenn der Eintrag ein einfacher Wert ist). Ohne Regeln wird nichts gefiltert.
• „Sortieren“: Tippen Sie im geöffneten Feld das Feld ein, nach dem sortiert wird (z. B. price), und wählen Sie „Aufsteigend“ oder „Absteigend“. Zahlen werden als Zahlen sortiert, Daten als Daten und alles andere alphabetisch; Einträge mit leerem Wert kommen ans Ende.
• „Duplikate entfernen“: Tippen Sie im geöffneten Feld das zu vergleichende Feld ein; von Einträgen mit demselben Wert bleibt nur der erste. Da dies nach dem Sortieren läuft, bleibt der oberste. Ohne Feld wird der ganze Eintrag verglichen.
• „Erste N Einträge behalten“: Es bleiben nur so viele Einträge wie die eingegebene Zahl, von oben in der Liste.

Das Ergebnis nutzen

Das Ergebnis können Sie in späteren Schritten nutzen: es in einem Schritt Auswahl mit „Optionsquelle“ › „Aus einer Variable“ als Optionen zeigen, mit einem Schritt Schleife dieselben Schritte für jeden Eintrag ausführen oder es mit der „Listenzusammenfassung“ von Variablen setzen zählen oder addieren. Ist das Ergebnis sehr lang (etwa 16.000 Zeichen), fallen Einträge am Ende weg.

Beispiel

Ein Tool-Aufruf schreibt die verfügbaren Terminzeiten in {answer}. In Liste bearbeiten: „Liste“ {answer.slots}; „Filtern“ {item.seats} · „Zahl“ · „ist größer als“ · 0; „Sortieren“ nach dem Feld start, „Aufsteigend“; „Erste N Einträge behalten“ 5; „Variablenname“ next_slots. Ein Schritt Auswahl mit der Quelle „Aus einer Variable“ bietet dann die fünf frühesten Zeiten als Optionen an.

Worauf Sie achten sollten

Der Editor warnt, wenn: keine Liste gewählt ist, der Variablenname ungültig ist oder eine Filterregel nicht auf das Feld des Eintrags schaut (eine solche Regel liefert für jeden Eintrag dasselbe Ergebnis). Zeigt der geschriebene Pfad nicht auf eine Liste, erscheint bei den Beispieldaten „Dieser Pfad zeigt nicht auf eine Liste; das Ergebnis bleibt leer.“ Zum Schritt Tool-Aufruf siehe Schritte Integrationsaktion und Tool-Aufruf.

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.