Razumevanje podatkovnih tipov za spremenljivke
Preden se poglobimo v praktične vidike uporabe spremenljivk, se seznanimo z različnimi tipi podatkov, ki so na voljo v Botpressu.
- Vrvica: Nizi se uporabljajo za shranjevanje besedila, ki je lahko sestavljeno iz črk, številk ali posebnih znakov. Običajno se uporabljajo za shranjevanje uporabniških imen ali sporočil, ki jih ustvari AI.
- Boolean: Logične vrednosti lahko vsebujejo samo dve vrednosti – resnično ali napačno. Idealne so za shranjevanje binarnih informacij, na primer o tem, ali je uporabnik stranka, ki se vrača, ali če želi uporabnik vprašati kaj drugega.
- številka: Kot že ime pove, se številske spremenljivke uporabljajo za shranjevanje številskih vrednosti, ki so lahko cela števila ali števila z decimalnimi mesti. Uporabni so za shranjevanje telefonskih številk, območnih kod in drugih številskih podatkov.
- Datum: Datumske spremenljivke uporabljajo obliko datuma/časa ISO 8601. Predstavlja en sam datum ali datum in uro.
- predmet: Objektna spremenljivka je zbirka parov ključ-vrednost, ki so podobni slovarjem ali zemljevidom. Dragoceni so za shranjevanje kompleksnih podatkovnih struktur, kot so uporabniški profili ali rezultati klica API.
- niz: Nizi se uporabljajo za shranjevanje zbirk podobnih spremenljivk. Lahko držijo nize ali predmete, zaradi česar so vsestranski za različne primere uporabe, kot je shranjevanje uporabnikovih preteklih sporočil ali zagotavljanje možnosti, med katerimi lahko uporabnik izbira.
- Enum: To je spremenljivka z omejenim naborom vnaprej določenih izbir. Primerni so za scenarije, kot je shranjevanje dni v tednu ali razpoložljivih elementov na meniju s hrano.
- vzorec: Spremenljivke vzorcev uporabljajo regularne izraze (Regex) za shranjevanje posebnih vzorcev, ki jih je mogoče uporabiti za ujemanje določenih besed ali številk. Priročni so za shranjevanje številk računov ali številk letov.
Razumevanje obsegov spremenljivk
V Botpress so vključene različne vrste spremenljivk, ki se razlikujejo glede na to, kje so lahko dostopne v toku vašega chatbota. Raziščimo različne obsege spremenljivk, začenši od najbolj omejenih do najširših:
Spremenljivke poteka dela
Te spremenljivke so definirane in uporabljene znotraj enega ali istega poteka dela. Odlični so za tokove za enkratno uporabo, kot je shranjevanje izhodov nalog AI, uporabniških odgovorov na vprašanja ali organiziranje podatkov iz klicev API-ja.
Za ustvarjanje spremenljivke poteka dela lahko sledite tem korakom:
Korak 1. V meniju »Raziskovalec« izberite ustrezen potek dela.
2. korak Dvoklik na prazno območje v urejevalniku poteka dela odpre ploščo Inšpektor.
3. korak Določite ime spremenljivke, izberite podatkovni tip spremenljivke in kliknite gumb »Dodaj«, da ustvarite spremenljivko.
Svoji spremenljivki lahko dodate privzeto (začetno) vrednost v razdelku »Dodatne nastavitve«.
Vhodne in izhodne spremenljivke poteka dela
Za izmenjavo informacij imajo lahko delovni tokovi vhodne in izhodne spremenljivke. Vhodi se uporabljajo za prejemanje informacij iz zunanjih virov ali drugih delovnih tokov, medtem ko izhodi zagotavljajo informacije zunanjim virom ali drugim delovnim tokovom. To omogoča bolj prilagodljivo komunikacijo in izmenjavo podatkov znotraj bota.
Za označevanje vhodne spremenljivke lahko sledite tem korakom:
Korak 1. Ustvarite spremenljivko znotraj poteka dela.
2. korak Izberite spremenljivko tako, da kliknete vnosno vozlišče poteka dela na plošči Inšpektor.
Za označevanje izhodne spremenljivke lahko sledite tem korakom:
Korak 1. Ustvarite spremenljivko znotraj poteka dela.
2. korak Izberite spremenljivko tako, da kliknete izhodno vozlišče poteka dela na plošči inšpektorja.
Spremenljivke seje
Vsi tokovi lahko dostopajo do teh spremenljivk, vendar samo za en pogovor. Idealne so za shranjevanje podatkov, ki se uporabljajo med pogovorom, kot so zgodovina klepeta, zbrani predmeti v virtualnem nakupovalnem vozičku ali začasni podatki iz klicev API-ja.
Če želite ustvariti spremenljivko seje, lahko napišete naslednjo kodo:
session.variablename = 'Zdravo družba!' ;Za uporabo vaše spremenljivke v besedilni kartici jo moramo zapreti v zavite oklepaje, npr. {{session.variablename}} .
Uporabniške spremenljivke
Uporabniške spremenljivke sledijo uporabniku med pogovori, kar omogoča, da podatki ostanejo v več interakcijah s chatbotom. Popolne so za shranjevanje informacij, ki ostanejo pomembne za uporabnika skozi čas, kot so osebni podatki, oznake iz preteklih pogovorov ali jezikovne nastavitve.
Če želite ustvariti uporabniško spremenljivko:
Korak 1. Odprite »Nastavitve Chatbota« z ikono Botpress, ki se nahaja v zgornjem levem kotu.
2. korak Na zavihkih izberite »Spremenljivke«.
3. korak Definirajte uporabniško spremenljivko tako, da jo poimenujete in določite vrsto podatkov.
@user.variablename ali {{user.variablename}} je mogoče uporabiti za sklicevanje na spremenljivko »Uporabnik« na besedilni kartici.
Botovske spremenljivke
Vsi uporabniki v chatbotu imajo dostop do teh spremenljivk v vseh pogovorih. Pogosto se uporabljajo za shranjevanje informacij in konfiguracije razvijalca, kot je shranjevanje končnih točk za klice API-ja, številke različice bota ali njegovega imena.
Za ustvarjanje spremenljivke Bot sledite tem korakom:
Korak 1. Izberite »Nastavitve Chatbota« s klikom na ikono Botpress v zgornjem levem kotu.
2. korak Na zavihkih izberite »Spremenljivke«.
3. korak Določite ime in vrsto podatkov spremenljivke bota.
Tako kot uporabniške spremenljivke lahko @bot.variablename ali bot.variablename uporabite za sklicevanje na spremenljivke bota na karticah.
Konfiguracijske spremenljivke
So posebna vrsta spremenljivke varnega bota. Upravljate jih lahko na nadzorni plošči v oblaku in vam ni treba odpreti bota. Konfiguracijske spremenljivke so idealne za shranjevanje občutljivih informacij, kot so žetoni API, zasebni naslovi IP ali poverilnice baze podatkov.
Če želite ustvariti konfiguracijsko spremenljivko:
Korak 1. Odprite »Nastavitve Chatbota« z ikono Botpress, ki se nahaja v zgornjem levem kotu.
2. korak Kliknite zavihek »Spremenljivke«.
3. korak Dodajte konfiguracijsko spremenljivko ter navedite njeno ime in vrednost.
Za dostop do konfiguracijskih spremenljivk v kodi lahko uporabite »env.key«, kjer »key« predstavlja ime konfiguracijske spremenljivke, ki jo želite pridobiti.
Uporaba spremenljivk v kodi
Zavit oklepaj »{{ }}« ali simbol @ ni potreben pri uporabi spremenljivk v kodi. Sintaksa za dostop do spremenljivk v kodi sledi vzorcu 'variabletype.variablename'. Na primer:
Koda:
- workflow.phoneNumber
- session.userAcctId
- user.firstName
- bot.endpoint
- env.apiKey
Spremenljivkam je mogoče dodeliti vrednosti ali jih posodobiti v kodi. Vendar je ključnega pomena zagotoviti, da se dodeljena vrednost ujema s podatkovnim tipom spremenljivke, da se izognete napakam.
Zaključek
Spremenljivke so gradniki dinamičnih in personaliziranih interakcij v Botpressu. Z uporabo različnih vrst podatkov in razumevanjem spremenljivih obsegov lahko razvijalci ustvarijo klepetalne robote z zmogljivimi zmogljivostmi. Ne glede na to, ali morate shraniti uporabniške informacije, povezovanje z API-ji ali posredovanje podatkov med delovnimi tokovi in spremenljivkami v Botpressu zagotavlja potrebno prilagodljivost in nadzor.