Forstå datatyper for variabler
Før vi dykker inn i de praktiske aspektene ved bruk av variablene, la oss gjøre oss kjent med de forskjellige tilgjengelige datatypene i Botpress.
- streng: Strenger brukes til å lagre teksten som kan bestå av bokstaver, tall eller spesialtegn. De brukes ofte til å lagre brukernavn eller AI-genererte meldinger.
- Boolsk: Boolsk kan bare inneholde to verdier – sann eller usann. De er ideelle for å lagre den binære informasjonen, for eksempel om en bruker er en returnerende kunde eller om brukeren ønsker å spørre om noe annet.
- Antall: Som navnet antyder, brukes tallvariablene til å lagre de numeriske verdiene som kan være enten heltall eller tall med desimaler. De er nyttige for å lagre telefonnumre, retningsnumre og andre numeriske data.
- Dato: Datovariablene bruker ISO 8601 dato/klokkeslett-format. Den representerer enten en enkelt dato eller en dato og klokkeslett.
- Gjenstand: En objektvariabel er en samling nøkkelverdi-par som ligner på ordbøkene eller kartene. De er verdifulle for lagring av komplekse datastrukturer som brukerprofiler eller resultatene av et API-kall.
- Matrise: Arrayene brukes til å lagre samlinger av lignende variabler. De kan holde strengene eller objektene, noe som gjør dem allsidige for ulike brukstilfeller, for eksempel å lagre en brukers tidligere meldinger eller gi brukeren valgmuligheter.
- Enum: Dette er en variabel med et begrenset sett med forhåndsdefinerte valg. De er egnet for scenarier som å lagre ukedagene eller de tilgjengelige elementene på en matmeny.
- Mønster: Mønstervariablene bruker Regular Expressions (Regex) for å lagre de spesielle mønstrene som kan brukes til å matche spesifikke ord eller tall. De er nyttige for lagring av kontonumre eller flynummer.
Forstå de variable omfangene
Ulike typer variabler er inkludert i Botpress, og de varierer avhengig av hvor de kan være tilgjengelige i chatbotens flyt. La oss utforske de forskjellige variabelomfangene, fra det mest begrensede til det bredeste:
Arbeidsflytvariabler
Disse variablene er definert og brukt innenfor en enkelt eller samme arbeidsflyt. De er utmerket for engangsflyter som lagring av AI-oppgaveutdata, brukersvar på spørsmål eller organisering av data fra API-kallene.
Disse trinnene kan følges for å lage en arbeidsflytvariabel:
Trinn 1. Velg riktig arbeidsflyt i 'Utforsker'-menyen.
Steg 2. Dobbeltklikk på et tomt område i arbeidsflytredigeringsprogrammet åpner Inspektør-panelet.
Trinn 3. Spesifiser variabelnavnet, velg variabelens datatype, og klikk på 'Legg til'-knappen for å lage variabelen.
Du kan legge til en standard (initiell) verdi til variabelen din fra delen 'Ytterligere innstillinger'.
Input og Output Workflow Variables
For å utveksle informasjon kan arbeidsflyter ha inn- og utdatavariabler. Inndata brukes til å motta informasjon fra eksterne kilder eller andre arbeidsflyter, mens utdata gir informasjon til eksterne kilder eller andre arbeidsflyter. Dette gir mulighet for mer fleksibel kommunikasjon og datautveksling i boten.
Disse trinnene kan følges for å merke en inngangsvariabel:
Trinn 1. Lag variabelen inne i arbeidsflyten.
Steg 2. Velg variabelen ved å klikke på arbeidsflytens inngangsnode i Inspektør-panelet.
Disse trinnene kan følges for å merke en utdatavariabel:
Trinn 1. Lag variabelen inne i arbeidsflyten.
Steg 2. Velg variabelen ved å klikke på arbeidsflytens utgangsnode i Inspektør-panelet.
Sesjonsvariabler
Alle flyter har tilgang til disse variablene, men bare for én enkelt samtale. De er ideelle for å lagre dataene som brukes gjennom en samtale, for eksempel chathistorikk, innsamlede varer i en virtuell handlekurv eller midlertidige data fra API-anrop.
For å lage en øktvariabel kan du skrive følgende kode:
session.variablename = 'Hei folkens!' ;For å bruke variabelen din i et tekstkort, må vi lukke den i de krøllede parentesene, f.eks. {{session.variablename}} .
Brukervariabler
Brukervariablene følger en bruker mellom samtaler, noe som gjør at dataene kan vedvare på tvers av flere interaksjoner med chatboten. De er perfekte for å lagre informasjon som forblir relevant for en bruker over tid, for eksempel personlige detaljer, tagger fra tidligere samtaler eller språkpreferanser.
Slik oppretter du en brukervariabel:
Trinn 1. Åpne «Chatbot-innstillinger» fra Botpress-ikonet øverst til venstre.
Steg 2. Velg 'Variabler' fra fanene.
Trinn 3. Definer brukervariabelen ved å gi den et navn og spesifisere datatypen.
Enten @user.variablename eller {{user.variablename}} kan brukes for å referere til «Bruker»-variabelen i et tekstkort.
Bot-variabler
Alle brukere i chatboten har tilgang til disse variablene på tvers av alle samtaler. De brukes ofte til å lagre utviklerinformasjon og konfigurasjon, for eksempel lagring av endepunkter for API-kall, botens versjonsnummer eller navnet.
Følg disse trinnene for å lage en bot-variabel:
Trinn 1. Velg 'Chatbot-innstillinger' ved å klikke på Botpress-ikonet øverst til venstre.
Steg 2. Velg 'Variabler' fra fanene.
Trinn 3. Angi navnet og datatypen til bot-variabelen.
I likhet med brukervariabler kan @bot.variablename eller bot.variablename brukes til å referere til robotvariabler på kortene.
Konfigurasjonsvariabler
De er en spesiell type sikker bot-variabel. Du kan administrere dem fra Cloud Dashboard, og det er ikke nødvendig å åpne boten. Konfigurasjonsvariablene er ideelle for lagring av sensitiv informasjon som API-tokens, private IP-adresser eller databaselegitimasjon.
Slik oppretter du en konfigurasjonsvariabel:
Trinn 1. Åpne «Chatbot-innstillinger» fra Botpress-ikonet øverst til venstre.
Steg 2. Klikk på 'Variabler'-fanen.
Trinn 3. Legg til en konfigurasjonsvariabel og oppgi navnet og verdien.
For å få tilgang til konfigurasjonsvariablene i koden, kan du bruke 'env.key' hvor 'key' representerer konfigurasjonsvariabelnavnet som skal hentes.
Bruke variabler i koden
De krøllede parentesene «{{ }}» eller @-symbolet er ikke nødvendig når du bruker variabler i koden. Syntaksen for tilgang til variablene i koden følger 'variabletype.variablename'-mønsteret. For eksempel:
Kode:
- workflow.phoneNumber
- session.userAcctId
- bruker.fornavn
- bot.endepunkt
- env.apiKey
Variablene kan tildeles verdier eller oppdateres i koden. Men det er avgjørende å sikre at den tilordnede verdien samsvarer med variabelens datatype for å unngå feil.
Konklusjon
Variablene er byggesteinene for dynamiske og personaliserte interaksjoner i Botpress. Ved å bruke de ulike datatypene og forstå de variable omfangene, kan utviklerne lage chatbots med kraftige muligheter. Enten du trenger å lagre brukerinformasjonen, koble til APIer eller sende data mellom arbeidsflyter og variabler i Botpress gir den nødvendige fleksibiliteten og kontrollen.