Forstå datatyper for variabler
Før vi dykker ned i de praktiske aspekter ved at bruge variablerne, lad os gøre os bekendt med de forskellige tilgængelige datatyper i Botpress.
- Snor: Strenge bruges til at gemme teksten, som kan bestå af bogstaver, tal eller specialtegn. De bruges almindeligvis til at gemme brugernavne eller AI-genererede meddelelser.
- Boolean: Booleans kan kun indeholde to værdier - sand eller falsk. De er ideelle til at gemme de binære oplysninger, såsom om en bruger er en tilbagevendende kunde, eller hvis brugeren vil spørge om noget andet.
- Nummer: Som navnet antyder, bruges talvariablerne til at gemme de numeriske værdier, som enten kan være heltal eller tal med decimaler. De er nyttige til at gemme telefonnumre, områdenumre og andre numeriske data.
- Dato: Datovariablerne bruger ISO 8601 dato/tidsformat. Det repræsenterer enten en enkelt dato eller en dato og et klokkeslæt.
- Objekt: En objektvariabel er en samling af nøgleværdi-par, der ligner ordbøgerne eller kortene. De er værdifulde til lagring af komplekse datastrukturer såsom brugerprofiler eller resultaterne af et API-kald.
- Array: Arrays bruges til at gemme samlinger af lignende variabler. De kan holde strengene eller objekterne, hvilket gør dem alsidige til forskellige brugstilfælde, såsom at gemme en brugers tidligere beskeder eller give brugeren mulighed for at vælge imellem.
- Enum: Dette er en variabel med et begrænset sæt foruddefinerede valg. De er velegnede til scenarier som lagring af ugedagene eller de tilgængelige varer på en madmenu.
- Mønster: Mønstervariablene bruger regulære udtryk (Regex) til at gemme de specielle mønstre, som kan bruges til at matche specifikke ord eller tal. De er praktiske til at gemme kontonumre eller flynumre.
Forstå de variable omfang
Forskellige typer variabler er inkluderet i Botpress, og de varierer afhængigt af, hvor de kan være tilgængelige i din chatbots flow. Lad os udforske de forskellige variable omfang, startende fra det mest begrænsede til det bredeste:
Workflow-variabler
Disse variabler defineres og bruges inden for en enkelt eller samme workflow. De er fremragende til engangsflows, såsom lagring af AI-opgaveoutput, brugersvar på spørgsmål eller organisering af data fra API-kaldene.
Disse trin kan følges for at oprette en workflowvariabel:
Trin 1. Vælg den relevante arbejdsgang i menuen 'Explorer'.
Trin 2. Dobbeltklik på et tomt område i workflow-editoren åbner Inspektør-panelet.
Trin 3. Angiv variabelnavnet, vælg variablens datatype, og klik på knappen 'Tilføj' for at oprette variablen.
Du kan tilføje en standardværdi (indledende) til din variabel fra afsnittet 'Yderligere indstillinger'.
Input- og output-workflowvariabler
For at udveksle en information kan arbejdsgange have input- og outputvariabler. Input bruges til at modtage en information fra de eksterne kilder eller andre arbejdsgange, mens output giver en information til de eksterne kilder eller andre arbejdsgange. Dette giver mulighed for mere fleksibel kommunikation og dataudveksling i botten.
Disse trin kan følges for at markere en inputvariabel:
Trin 1. Opret variablen inde i arbejdsgangen.
Trin 2. Vælg variablen ved at klikke på arbejdsgangens indgangsknude i Inspektør-panelet.
Disse trin kan følges for at markere en outputvariabel:
Trin 1. Opret variablen inde i arbejdsgangen.
Trin 2. Vælg variablen ved at klikke på arbejdsgangens exit-node i Inspektør-panelet.
Sessionsvariabler
Alle flows kan få adgang til disse variabler, men kun for en enkelt samtale. De er ideelle til at gemme de data, der bruges gennem en samtale, såsom chathistorik, indsamlede varer i en virtuel indkøbskurv eller midlertidige data fra API-kald.
For at oprette en sessionsvariabel kan du skrive følgende kode:
session.variablename = 'Hej gutter!' ;For at bruge din variabel i et tekstkort skal vi lukke den i de krøllede parenteser, f.eks. {{session.variablename}} .
Brugervariabler
Brugervariablerne følger en bruger mellem samtaler, hvilket gør det muligt for dataene at fortsætte på tværs af flere interaktioner med chatbotten. De er perfekte til at gemme en information, der forbliver relevant for en bruger over tid, såsom personlige detaljer, tags fra tidligere samtaler eller sprogpræferencer.
Sådan opretter du en brugervariabel:
Trin 1. Åbn 'Chatbot-indstillinger' fra Botpress-ikonet i øverste venstre hjørne.
Trin 2. Vælg 'Variabler' fra fanerne.
Trin 3. Definer brugervariablen ved at navngive den og angive datatypen.
Enten @user.variablename eller {{user.variablename}} kan bruges til at henvise til 'Bruger'-variablen i et tekstkort.
Botvariabler
Alle brugere i chatbotten har adgang til disse variabler på tværs af alle samtaler. De bruges ofte til at gemme udviklerinformation og konfiguration, såsom lagring af slutpunkter for API-kaldene, botens versionsnummer eller dens navn.
Følg disse trin for at oprette en bot-variabel:
Trin 1. Vælg 'Chatbot-indstillinger' ved at klikke på Botpress-ikonet i øverste venstre hjørne.
Trin 2. Vælg 'Variabler' fra fanerne.
Trin 3. Angiv navnet og datatypen for bot-variablen.
Ligesom brugervariabler kan @bot.variablename eller bot.variablename bruges til at henvise til botvariabler på kortene.
Konfigurationsvariabler
De er en speciel type sikker bot-variabel. Du kan administrere dem fra Cloud Dashboard, og der er ingen grund til at åbne botten. Konfigurationsvariablerne er ideelle til lagring af følsomme oplysninger som API-tokens, private IP-adresser eller databaselegitimationsoplysninger.
Sådan oprettes en konfigurationsvariabel:
Trin 1. Åbn 'Chatbot-indstillinger' fra Botpress-ikonet i øverste venstre hjørne.
Trin 2. Klik på fanen 'Variabler'.
Trin 3. Tilføj en konfigurationsvariabel og angiv dens navn og værdi.
For at få adgang til konfigurationsvariablerne i koden kan du bruge 'env.key', hvor 'key' repræsenterer det konfigurationsvariabelnavn, der skal hentes.
Brug af variabler i koden
De krøllede parenteser '{{ }}' eller @-symbolet er ikke nødvendige, når du bruger variabler i koden. Syntaksen for at få adgang til variablerne i koden følger 'variabletype.variablename'-mønsteret. For eksempel:
Kode:
- workflow.phoneNumber
- session.userAcctId
- bruger.fornavn
- bot.endepunkt
- env.apiKey
Variablerne kan tildeles værdier eller opdateres i koden. Men det er afgørende at sikre, at den tildelte værdi matcher variablens datatype for at undgå fejl.
Konklusion
Variablerne er byggestenene i dynamiske og personaliserede interaktioner i Botpress. Ved at bruge de forskellige datatyper og forstå de variable omfang, kan udviklerne skabe chatbots med kraftfulde muligheder. Uanset om du skal gemme brugeroplysningerne, oprette forbindelse til API'er eller overføre data mellem arbejdsgange og variabler i Botpress, giver det den nødvendige fleksibilitet og kontrol.