Comprensió dels tipus de dades per a variables
Abans d'endinsar-nos en els aspectes pràctics de l'ús de les variables, familiaritzem-nos amb els diferents tipus de dades disponibles a Botpress.
- Cadena: Les cadenes s'utilitzen per emmagatzemar el text que pot consistir en lletres, números o caràcters especials. S'utilitzen habitualment per emmagatzemar els noms d'usuari o missatges generats per IA.
- Booleà: Els booleans només poden contenir dos valors: vertader o fals. Són ideals per emmagatzemar la informació binària, com ara si un usuari és un client recurrent o si l'usuari vol preguntar alguna cosa més.
- Número: Com el seu nom indica, les variables numèriques s'utilitzen per emmagatzemar els valors numèrics que poden ser nombres enters o nombres amb decimals. Són útils per emmagatzemar els números de telèfon, els codis d'àrea i altres dades numèriques.
- Data: Les variables de data utilitzen el format de data/hora ISO 8601. Representa una sola data o una data i hora.
- Objecte: Una variable d'objecte és una col·lecció de parells clau-valor que són similars als diccionaris o mapes. Són valuosos per emmagatzemar les estructures de dades complexes, com ara els perfils d'usuari o els resultats d'una trucada a l'API.
- Matriu: Les matrius s'utilitzen per emmagatzemar les col·leccions de variables similars. Poden subjectar les cadenes o els objectes, fent-los versàtils per a diversos casos d'ús, com ara emmagatzemar els missatges anteriors d'un usuari o oferir les opcions que l'usuari pugui triar.
- Enumeració: Aquesta és una variable amb un conjunt limitat d'opcions predefinides. Són adequats per a escenaris com emmagatzemar els dies de la setmana o els articles disponibles en un menú d'aliments.
- Patró: Les variables de patrons utilitzen les expressions regulars (Regex) per emmagatzemar els patrons especials que es poden utilitzar per fer coincidir paraules o números específics. Són útils per emmagatzemar els números de compte o de vol.
Comprensió dels àmbits variables
A Botpress s'inclouen diversos tipus de variables i varien en funció d'on es pot accedir al flux del vostre chatbot. Explorem els diferents àmbits variables, començant pel més limitat al més ampli:
Variables de flux de treball
Aquestes variables es defineixen i s'utilitzen dins d'un únic o mateix flux de treball. Són excel·lents per a fluxos d'un sol ús, com ara emmagatzemar els resultats de les tasques d'IA, les respostes dels usuaris a les preguntes o l'organització de les dades de les trucades de l'API.
Es poden seguir aquests passos per crear una variable de flux de treball:
Pas 1. Seleccioneu el flux de treball adequat al menú 'Explorador'.
Pas 2. Si feu doble clic a una àrea buida de l'editor de flux de treball, s'obre el tauler Inspector.
Pas 3. Especifiqueu el nom de la variable, trieu el tipus de dades de la variable i feu clic al botó 'Afegeix' per crear la variable.
Podeu afegir un valor predeterminat (inicial) a la vostra variable des de la secció 'Configuració addicional'.
Variables de flux de treball d'entrada i sortida
Per intercanviar informació, els fluxos de treball poden tenir variables d'entrada i de sortida. Les entrades s'utilitzen per rebre informació de les fonts externes o altres fluxos de treball, mentre que les sortides proporcionen informació a les fonts externes o altres fluxos de treball. Això permet una comunicació i un intercanvi de dades més flexibles dins del bot.
Es poden seguir aquests passos per marcar una variable d'entrada:
Pas 1. Creeu la variable dins del flux de treball.
Pas 2. Seleccioneu la variable fent clic al node d'entrada del flux de treball al tauler Inspector.
Es poden seguir aquests passos per marcar una variable de sortida:
Pas 1. Creeu la variable dins del flux de treball.
Pas 2. Seleccioneu la variable fent clic al node de sortida del flux de treball al tauler Inspector.
Variables de sessió
Tots els fluxos poden accedir a aquestes variables, però només per a una conversa. Són ideals per emmagatzemar les dades que s'utilitzen al llarg d'una conversa, com ara l'historial de xat, els articles recollits en un carretó de la compra virtual o les dades temporals de les trucades de l'API.
Per crear una variable de sessió, podeu escriure el codi següent:
session.nom_variable = 'Hola nois!' ;Per utilitzar la vostra variable en una targeta de text, hem de tancar-la entre claudàtors, per exemple, {{session.variablename}} .
Variables d'usuari
Les variables d'usuari segueixen un usuari entre converses, cosa que permet que les dades persisteixin en múltiples interaccions amb el chatbot. Són perfectes per emmagatzemar una informació que segueix sent rellevant per a un usuari al llarg del temps, com ara dades personals, etiquetes de converses anteriors o preferències d'idioma.
Per crear una variable d'usuari:
Pas 1. Obriu la 'Configuració de Chatbot' des de la icona de Botpress situada a l'extrem superior esquerre.
Pas 2. Seleccioneu 'Variables' a les pestanyes.
Pas 3. Defineix la variable d'usuari anomenant-la i especificant el tipus de dades.
Es pot utilitzar @user.variablename o {{user.variablename}} per fer referència a la variable 'Usuari' en una targeta de text.
Variables del bot
Tots els usuaris del chatbot tenen accés a aquestes variables en totes les converses. S'utilitzen sovint per emmagatzemar la informació i la configuració del desenvolupador, com ara l'emmagatzematge de punts finals per a les trucades de l'API, el número de versió del bot o el seu nom.
Seguiu aquests passos per crear una variable Bot:
Pas 1. Seleccioneu 'Configuració de Chatbot' fent clic a la icona de Botpress a l'extrem superior esquerre.
Pas 2. Seleccioneu 'Variables' a les pestanyes.
Pas 3. Especifiqueu el nom i el tipus de dades de la variable bot.
Igual que les variables d'usuari, @bot.variablename o bot.variablename es poden utilitzar per fer referència a variables de bot a les targetes.
Variables de configuració
Són un tipus especial de variable de bot segura. Podeu gestionar-los des del tauler de control del núvol i no cal obrir el bot. Les variables de configuració són ideals per emmagatzemar informació sensible, com ara testimonis d'API, adreces IP privades o credencials de base de dades.
Per crear una variable de configuració:
Pas 1. Obriu la 'Configuració de Chatbot' des de la icona de Botpress situada a l'extrem superior esquerre.
Pas 2. Feu clic a la pestanya 'Variables'.
Pas 3. Afegiu una variable de configuració i proporcioneu-ne el nom i el valor.
Per accedir a les variables de configuració del codi, podeu utilitzar 'env.key' on 'key' representa el nom de la variable de configuració que cal recuperar.
Ús de variables al codi
Els claudàtors '{{ }}' o el símbol @ no són necessaris quan s'utilitzen variables al codi. La sintaxi per accedir a les variables del codi segueix el patró 'variabletype.variablename'. Per exemple:
Codi:
- workflow.phoneNumber
- session.userAcctId
- nom.usuari
- bot.punt final
- env.apiKey
Les variables es poden assignar amb valors o actualitzar-se al codi. Però és crucial assegurar-se que el valor assignat coincideix amb el tipus de dades de la variable per evitar errors.
Conclusió
Les variables són els components bàsics de les interaccions dinàmiques i personalitzades a Botpress. Mitjançant l'ús dels diferents tipus de dades i la comprensió dels àmbits variables, els desenvolupadors poden crear chatbots amb potents capacitats. Tant si necessiteu emmagatzemar la informació de l'usuari, connectar-vos amb API o passar les dades entre fluxos de treball i variables a Botpress proporcionen la flexibilitat i el control necessaris.