Înțelegerea tipurilor de date pentru variabile
Înainte de a ne aprofunda în aspectele practice ale utilizării variabilelor, să ne familiarizăm cu diferitele tipuri de date disponibile în Botpress.
- Şir: Șirurile sunt folosite pentru a stoca textul care poate consta din litere, cifre sau caractere speciale. Ele sunt utilizate în mod obișnuit pentru a stoca numele de utilizator sau mesajele generate de AI.
- Boolean: Booleenii pot conține doar două valori - adevărat sau fals. Sunt ideale pentru stocarea informațiilor binare, cum ar fi dacă un utilizator este un client care revine sau dacă utilizatorul dorește să întrebe altceva.
- Număr: După cum sugerează și numele, variabilele numerice sunt folosite pentru a stoca valorile numerice care pot fi fie numere întregi, fie numere cu zecimale. Sunt utile pentru stocarea numerelor de telefon, a prefixelor și a altor date numerice.
- Data: Variabilele Data utilizează formatul ISO 8601 dată/ora. Reprezintă fie o singură dată, fie o dată și oră.
- Obiect: O variabilă obiect este o colecție de perechi cheie-valoare care sunt similare cu dicționarele sau hărțile. Acestea sunt valoroase pentru stocarea structurilor complexe de date, cum ar fi profilurile utilizatorului sau rezultatele unui apel API.
- Matrice: Matricele sunt folosite pentru a stoca colecții de variabile similare. Ele pot ține șirurile sau obiectele, făcându-le versatile pentru diverse cazuri de utilizare, cum ar fi stocarea mesajelor anterioare ale unui utilizator sau oferirea de opțiuni dintre care utilizatorul poate alege.
- Enum: Aceasta este o variabilă cu un set limitat de opțiuni predefinite. Sunt potrivite pentru scenarii precum stocarea zilelor săptămânii sau a articolelor disponibile într-un meniu alimentar.
- Model: Variabilele de tipar utilizează expresiile regulate (Regex) pentru a stoca modelele speciale care pot fi folosite pentru a potrivi anumite cuvinte sau numere. Sunt utile pentru stocarea numerelor de cont sau a numerelor de zbor.
Înțelegerea domeniilor variabile
Diverse tipuri de variabile sunt incluse în Botpress și variază în funcție de locul în care pot fi accesibile în fluxul chatbot-ului tău. Să explorăm diferitele domenii variabile, pornind de la cel mai limitat la cel mai larg:
Variabilele fluxului de lucru
Aceste variabile sunt definite și utilizate într-un singur flux de lucru sau același. Sunt excelente pentru fluxuri de unică folosință, cum ar fi stocarea rezultatelor sarcinilor AI, răspunsurile utilizatorilor la întrebări sau organizarea datelor din apelurile API.
Acești pași pot fi urmați pentru a crea o variabilă de flux de lucru:
Pasul 1. Selectați fluxul de lucru corespunzător în meniul „Explorer”.
Pasul 2. Făcând dublu clic pe o zonă goală din editorul fluxului de lucru, se deschide panoul Inspector.
Pasul 3. Specificați numele variabilei, alegeți tipul de date al variabilei și faceți clic pe butonul „Adăugați” pentru a crea variabila.
Puteți adăuga o valoare implicită (inițială) variabilei dvs. din secțiunea „Setări suplimentare”.
Variabilele fluxului de lucru de intrare și ieșire
Pentru a face schimb de informații, fluxurile de lucru pot avea variabile de intrare și de ieșire. Intrările sunt folosite pentru a primi o informație de la sursele externe sau din alte fluxuri de lucru, în timp ce ieșirile oferă o informație către sursele externe sau alte fluxuri de lucru. Acest lucru permite o comunicare mai flexibilă și un schimb de date în cadrul botului.
Acești pași pot fi urmați pentru marcarea unei variabile de intrare:
Pasul 1. Creați variabila în interiorul fluxului de lucru.
Pasul 2. Selectați variabila făcând clic pe nodul de intrare al fluxului de lucru din panoul Inspector.
Acești pași pot fi urmați pentru marcarea unei variabile de ieșire:
Pasul 1. Creați variabila în interiorul fluxului de lucru.
Pasul 2. Selectați variabila făcând clic pe nodul de ieșire al fluxului de lucru din panoul Inspector.
Variabile de sesiune
Toate fluxurile pot accesa aceste variabile, dar numai pentru o singură conversație. Ele sunt ideale pentru stocarea datelor care sunt utilizate pe parcursul unei conversații, cum ar fi istoricul chatului, articolele colectate într-un coș de cumpărături virtual sau datele temporare din apelurile API.
Pentru a crea o variabilă de sesiune, puteți scrie următorul cod:
session.variablename = 'Buna baieti!' ;Pentru a utiliza variabila într-un card text, trebuie să o închidem între paranteze, de exemplu, {{session.variablename}} .
Variabile utilizator
Variabilele utilizator urmăresc un utilizator între conversații, ceea ce permite datelor să persistă în mai multe interacțiuni cu chatbot-ul. Sunt perfecte pentru stocarea unei informații care rămân relevante pentru un utilizator în timp, cum ar fi detaliile personale, etichetele din conversațiile anterioare sau preferințele de limbă.
Pentru a crea o variabilă utilizator:
Pasul 1. Deschideți „Setări Chatbot” din pictograma Botpress situată în colțul din stânga sus.
Pasul 2. Selectați „Variabile” din file.
Pasul 3. Definiți variabila utilizator denumindu-i-o și specificând tipul de date.
Fie @user.variablename sau {{user.variablename}} pot fi folosite pentru a face referire la variabila „Utilizator” din un card text.
Variabile bot
Toți utilizatorii din chatbot au acces la aceste variabile în toate conversațiile. Ele sunt utilizate frecvent pentru a stoca informațiile și configurația dezvoltatorului, cum ar fi stocarea punctelor finale pentru apelurile API, numărul versiunii botului sau numele acestuia.
Urmați acești pași pentru a crea o variabilă Bot:
Pasul 1. Selectați „Setări Chatbot” făcând clic pe pictograma Botpress din colțul din stânga sus.
Pasul 2. Selectați „Variabile” din file.
Pasul 3. Specificați numele și tipul de date ale variabilei bot.
La fel ca variabilele utilizator, @bot.variablename sau bot.variablename pot fi folosite pentru a se referi la variabilele bot din carduri.
Variabile de configurare
Sunt un tip special de variabilă bot securizat. Le puteți gestiona din Cloud Dashboard și nu este nevoie să deschideți botul. Variabilele de configurare sunt ideale pentru stocarea informațiilor sensibile, cum ar fi jetoanele API, adresele IP private sau acreditările bazei de date.
Pentru a crea o variabilă de configurare:
Pasul 1. Deschideți „Setări Chatbot” din pictograma Botpress situată în colțul din stânga sus.
Pasul 2. Faceți clic pe fila „Variabile”.
Pasul 3. Adăugați o variabilă de configurare și furnizați numele și valoarea acesteia.
Pentru a accesa variabilele de configurare din cod, puteți folosi „env.key” unde „key” reprezintă numele variabilei de configurare care trebuie preluată.
Utilizarea variabilelor în cod
Parantezele „{{ }}” sau simbolul @ nu sunt necesare atunci când se utilizează variabile în cod. Sintaxa pentru accesarea variabilelor din cod urmează modelul „variabletype.variablename”. De exemplu:
Cod:
- workflow.phoneNumber
- session.userAcctId
- user.firstName
- bot.punct final
- env.apiKey
Variabilele pot fi atribuite cu valori sau actualizate în cod. Dar este esențial să ne asigurăm că valoarea atribuită se potrivește cu tipul de date al variabilei pentru a evita erorile.
Concluzie
Variabilele sunt elementele de bază ale interacțiunilor dinamice și personalizate în Botpress. Prin utilizarea diferitelor tipuri de date și înțelegerea domeniilor variabile, dezvoltatorii pot crea chatboți cu capabilități puternice. Indiferent dacă trebuie să stocați informațiile despre utilizator, conectarea la API-uri sau trecerea datelor între fluxurile de lucru și variabile în Botpress oferă flexibilitatea și controlul necesare.