Datentypen für Variablen verstehen
Bevor wir uns mit den praktischen Aspekten der Verwendung der Variablen befassen, machen wir uns mit den verschiedenen verfügbaren Datentypen in Botpress vertraut.
- Zeichenfolge: Zum Speichern des Textes werden Zeichenfolgen verwendet, die aus Buchstaben, Zahlen oder Sonderzeichen bestehen können. Sie werden häufig zum Speichern von Benutzernamen oder von KI generierten Nachrichten verwendet.
- Boolescher Wert: Boolesche Werte können nur zwei Werte enthalten – wahr oder falsch. Sie eignen sich ideal zum Speichern binärer Informationen, z. B. ob ein Benutzer ein wiederkehrender Kunde ist oder ob der Benutzer etwas anderes fragen möchte.
- Nummer: Wie der Name schon sagt, werden die Zahlenvariablen zum Speichern numerischer Werte verwendet, bei denen es sich entweder um Ganzzahlen oder Zahlen mit Dezimalstellen handeln kann. Sie eignen sich zum Speichern von Telefonnummern, Ortsvorwahlen und anderen numerischen Daten.
- Datum: Die Datumsvariablen verwenden das ISO 8601-Datums-/Uhrzeitformat. Es stellt entweder ein einzelnes Datum oder ein Datum und eine Uhrzeit dar.
- Objekt: Eine Objektvariable ist eine Sammlung von Schlüssel-Wert-Paaren, die den Wörterbüchern oder Karten ähneln. Sie sind wertvoll für die Speicherung komplexer Datenstrukturen wie Benutzerprofile oder Ergebnisse eines API-Aufrufs.
- Array: Die Arrays werden zum Speichern der Sammlungen ähnlicher Variablen verwendet. Sie können Zeichenfolgen oder Objekte enthalten, was sie für verschiedene Anwendungsfälle vielseitig macht, z. B. zum Speichern früherer Nachrichten eines Benutzers oder zum Bereitstellen von Optionen, aus denen der Benutzer auswählen kann.
- Aufzählung: Dies ist eine Variable mit einer begrenzten Anzahl vordefinierter Auswahlmöglichkeiten. Sie eignen sich für Szenarien wie die Speicherung der Wochentage oder der verfügbaren Artikel auf einer Speisekarte.
- Muster: Die Mustervariablen nutzen reguläre Ausdrücke (Regex), um die speziellen Muster zu speichern, die zum Zuordnen bestimmter Wörter oder Zahlen verwendet werden können. Sie sind praktisch zum Speichern der Kontonummern oder Flugnummern.
Die variablen Bereiche verstehen
In Botpress sind verschiedene Arten von Variablen enthalten, die je nachdem, wo im Fluss Ihres Chatbots auf sie zugegriffen werden kann, variieren. Lassen Sie uns die verschiedenen Variablenbereiche untersuchen, beginnend mit den begrenztesten bis hin zu den umfassendsten:
Workflow-Variablen
Diese Variablen werden innerhalb eines oder desselben Workflows definiert und verwendet. Sie eignen sich hervorragend für einmalige Abläufe wie das Speichern der KI-Aufgabenausgaben, Benutzerantworten auf Fragen oder das Organisieren der Daten aus den API-Aufrufen.
Die folgenden Schritte können zum Erstellen einer Workflow-Variablen befolgt werden:
Schritt 1. Wählen Sie im Menü „Explorer“ den entsprechenden Workflow aus.
Schritt 2. Durch Doppelklicken auf einen leeren Bereich im Workflow-Editor wird das Inspektorfenster geöffnet.
Schritt 3. Geben Sie den Variablennamen an, wählen Sie den Datentyp der Variablen aus und klicken Sie auf die Schaltfläche „Hinzufügen“, um die Variable zu erstellen.
Sie können Ihrer Variablen im Abschnitt „Zusätzliche Einstellungen“ einen Standardwert (Anfangswert) hinzufügen.
Eingabe- und Ausgabe-Workflow-Variablen
Um Informationen auszutauschen, können Workflows Eingabe- und Ausgabevariablen haben. Eingaben werden verwendet, um Informationen von externen Quellen oder anderen Arbeitsabläufen zu erhalten, während Ausgaben Informationen für externe Quellen oder andere Arbeitsabläufe bereitstellen. Dies ermöglicht eine flexiblere Kommunikation und einen flexibleren Datenaustausch innerhalb des Bots.
Zum Markieren einer Eingabevariablen können folgende Schritte befolgt werden:
Schritt 1. Erstellen Sie die Variable innerhalb des Workflows.
Schritt 2. Wählen Sie die Variable aus, indem Sie im Inspektorfenster auf den Eingangsknoten des Workflows klicken.
Zum Markieren einer Ausgabevariablen können folgende Schritte befolgt werden:
Schritt 1. Erstellen Sie die Variable innerhalb des Workflows.
Schritt 2. Wählen Sie die Variable aus, indem Sie im Inspektorfenster auf den Ausgangsknoten des Workflows klicken.
Sitzungsvariablen
Alle Flows können auf diese Variablen zugreifen, jedoch nur für eine einzelne Konversation. Sie eignen sich ideal zum Speichern der Daten, die während einer Konversation verwendet werden, wie z. B. Chat-Verlauf, gesammelte Artikel in einem virtuellen Warenkorb oder temporäre Daten aus API-Aufrufen.
Um eine Sitzungsvariable zu erstellen, können Sie den folgenden Code schreiben:
session.variablename = 'Hallo Leute!' ;Um Ihre Variable in einer Textkarte verwenden zu können, müssen wir sie in die geschweiften Klammern schließen, z. B. {{session.variablename}} .
Benutzervariablen
Die Benutzervariablen folgen einem Benutzer zwischen Gesprächen, wodurch die Daten über mehrere Interaktionen mit dem Chatbot hinweg bestehen bleiben. Sie eignen sich perfekt zum Speichern von Informationen, die für einen Benutzer über einen längeren Zeitraum hinweg relevant bleiben, wie z. B. persönliche Daten, Tags aus vergangenen Gesprächen oder Spracheinstellungen.
So erstellen Sie eine Benutzervariable:
Schritt 1. Öffnen Sie die „Chatbot-Einstellungen“ über das Botpress-Symbol in der oberen linken Ecke.
Schritt 2. Wählen Sie auf den Registerkarten „Variablen“ aus.
Schritt 3. Definieren Sie die Benutzervariable, indem Sie sie benennen und den Datentyp angeben.
Entweder @user.variablename oder {{user.variablename}} kann verwendet werden, um auf die Variable „Benutzer“ in einer Textkarte zu verweisen.
Bot-Variablen
Alle Benutzer im Chatbot haben über alle Konversationen hinweg Zugriff auf diese Variablen. Sie werden häufig zum Speichern von Entwicklerinformationen und -konfigurationen verwendet, z. B. zum Speichern von Endpunkten für die API-Aufrufe, der Versionsnummer des Bots oder seines Namens.
Befolgen Sie diese Schritte, um eine Bot-Variable zu erstellen:
Schritt 1. Wählen Sie die „Chatbot-Einstellungen“ aus, indem Sie oben links auf das Botpress-Symbol klicken.
Schritt 2. Wählen Sie auf den Registerkarten „Variablen“ aus.
Schritt 3. Geben Sie den Namen und den Datentyp der Bot-Variablen an.
Wie Benutzervariablen können @bot.variablename oder bot.variablename verwendet werden, um auf Bot-Variablen in den Karten zu verweisen.
Konfigurationsvariablen
Sie sind eine besondere Art sicherer Bot-Variablen. Sie können sie über das Cloud-Dashboard verwalten und müssen den Bot nicht öffnen. Die Konfigurationsvariablen eignen sich ideal zum Speichern vertraulicher Informationen wie API-Tokens, privater IP-Adressen oder Datenbankanmeldeinformationen.
So erstellen Sie eine Konfigurationsvariable:
Schritt 1. Öffnen Sie die „Chatbot-Einstellungen“ über das Botpress-Symbol in der oberen linken Ecke.
Schritt 2. Klicken Sie auf die Registerkarte „Variablen“.
Schritt 3. Fügen Sie eine Konfigurationsvariable hinzu und geben Sie deren Namen und Wert an.
Um auf die Konfigurationsvariablen im Code zuzugreifen, können Sie „env.key“ verwenden, wobei „key“ den Namen der abzurufenden Konfigurationsvariablen darstellt.
Verwendung von Variablen im Code
Die geschweiften Klammern „{{ }}“ oder das @-Symbol sind bei der Verwendung von Variablen im Code nicht erforderlich. Die Syntax für den Zugriff auf die Variablen im Code folgt dem Muster „variabletype.variablename“. Zum Beispiel:
Code:
- Workflow.phoneNumber
- session.userAcctId
- Benutzer.Vorname
- bot.endpoint
- env.apiKey
Den Variablen können Werte zugewiesen oder im Code aktualisiert werden. Es ist jedoch wichtig sicherzustellen, dass der zugewiesene Wert mit dem Datentyp der Variablen übereinstimmt, um Fehler zu vermeiden.
Abschluss
Die Variablen sind die Bausteine dynamischer und personalisierter Interaktionen in Botpress. Durch die Verwendung der verschiedenen Datentypen und das Verständnis der variablen Bereiche können die Entwickler Chatbots mit leistungsstarken Funktionen erstellen. Unabhängig davon, ob Sie Benutzerinformationen speichern, eine Verbindung zu APIs herstellen oder Daten zwischen Arbeitsabläufen und Variablen weitergeben möchten, bietet Botpress die erforderliche Flexibilität und Kontrolle.