Muutujate andmetüüpide mõistmine
Enne kui sukeldume muutujate kasutamise praktilistesse aspektidesse, tutvume Botpressi erinevate saadaolevate andmetüüpidega.
- String: Stringe kasutatakse teksti salvestamiseks, mis võib koosneda tähtedest, numbritest või erimärkidest. Neid kasutatakse tavaliselt kasutajanimede või AI-ga loodud sõnumite salvestamiseks.
- Boolean: Booleanidel võib olla ainult kaks väärtust – tõene või väär. Need sobivad ideaalselt binaarse teabe salvestamiseks, näiteks selle kohta, kas kasutaja on naasev klient või kui kasutaja soovib midagi muud küsida.
- Number: Nagu nimigi ütleb, kasutatakse numbrimuutujaid arvväärtuste salvestamiseks, mis võivad olla kas täisarvud või kümnendkohtadega numbrid. Need on kasulikud telefoninumbrite, suunakoodide ja muude arvandmete salvestamiseks.
- Kuupäev: Kuupäeva muutujad kasutavad ISO 8601 kuupäeva/kellaaja vormingut. See tähistab kas ühte kuupäeva või kuupäeva ja kellaaega.
- Objekt: Objekti muutuja on võtme-väärtuste paaride kogum, mis on sarnased sõnaraamatute või kaartidega. Need on väärtuslikud keerukate andmestruktuuride, näiteks kasutajaprofiilide või API-kõne tulemuste salvestamiseks.
- Massiiv: Massiive kasutatakse sarnaste muutujate kogude salvestamiseks. Need võivad hoida stringe või objekte, muutes need mitmekülgseks erinevateks kasutusjuhtudeks, näiteks kasutaja varasemate sõnumite salvestamiseks või valikuvõimaluste pakkumiseks, mille vahel kasutaja saab valida.
- Nimekiri: See on muutuja, millel on piiratud hulk eelmääratletud valikuid. Need sobivad stsenaariumide jaoks, nagu nädalapäevade või toidumenüüs saadaolevate üksuste salvestamine.
- Muster: Mustrimuutujad kasutavad regulaaravaldisi (Regex), et salvestada spetsiaalsed mustrid, mida saab kasutada konkreetsete sõnade või numbrite sobitamiseks. Need on mugavad kontonumbrite või lennunumbrite salvestamiseks.
Muutujate ulatuse mõistmine
Botpress sisaldab erinevat tüüpi muutujaid ja need varieeruvad olenevalt sellest, kus need teie vestlusroboti voos on juurdepääsetavad. Uurime erinevaid muutujate ulatuseid, alustades kõige piiratumast kuni kõige laiemani:
Töövoo muutujad
Need muutujad on määratletud ja neid kasutatakse ühes või samas töövoos. Need sobivad suurepäraselt ühekordseks kasutamiseks mõeldud voogude jaoks, nagu AI ülesannete väljundite salvestamine, kasutajate küsimustele vastused või API-kõnede andmete korraldamine.
Töövoo muutuja loomiseks saab järgida järgmisi samme.
Samm 1. Valige menüüst „Explorer” sobiv töövoog.
2. samm. Topeltklõps töövoo redaktoris tühjal alal avab paneeli Inspektor.
3. samm. Määrake muutuja nimi, valige muutuja andmetüüp ja klõpsake muutuja loomiseks nuppu 'Lisa'.
Saate lisada muutujale vaikeväärtuse (alg-) väärtuse jaotises „Lisaseaded”.
Sisend ja väljund töövoo muutujad
Teabe vahetamiseks võivad töövoogudel olla sisend- ja väljundmuutujad. Sisendeid kasutatakse teabe vastuvõtmiseks välistest allikatest või muudest töövoogudest, väljundid aga annavad teavet välistele allikatele või muudele töövoogudele. See võimaldab paindlikumat suhtlust ja andmevahetust robotis.
Sisendmuutuja märkimiseks võib järgida järgmisi samme:
Samm 1. Looge muutuja töövoo sees.
2. samm. Valige muutuja, klõpsates paneelil Inspektor töövoo sisestussõlme.
Väljundmuutuja märkimiseks võib järgida järgmisi samme:
Samm 1. Looge muutuja töövoo sees.
2. samm. Valige muutuja, klõpsates paneelil Inspektor töövoo väljumissõlme.
Seansi muutujad
Kõigil voogudel on juurdepääs neile muutujatele, kuid ainult ühe vestluse jaoks. Need sobivad ideaalselt vestluse ajal kasutatavate andmete, näiteks vestluste ajaloo, virtuaalsesse ostukorvi kogutud üksuste või API-kõnede ajutiste andmete salvestamiseks.
Seansimuutuja loomiseks võite kirjutada järgmise koodi:
seanss.muutujanimi = 'Tere kutid!' ;Muutuja kasutamiseks tekstikaardil peame selle sulgema sulgudes, nt {{session.variablename}} .
Kasutaja muutujad
Kasutaja muutujad jälgivad kasutajat vestluste vahel, mis võimaldab andmetel püsida mitme vestlusbotiga suhtlemise ajal. Need sobivad suurepäraselt sellise teabe salvestamiseks, mis jääb kasutaja jaoks aja jooksul asjakohaseks (nt isiklikud andmed, sildid varasematest vestlustest või keele-eelistused).
Kasutajamuutuja loomiseks tehke järgmist.
Samm 1. Avage vasakus ülanurgas Botpressi ikoonil „Chatbot Settings”.
2. samm. Valige vahekaartidelt 'Muutujad'.
3. samm. Määratlege kasutaja muutuja, pannes sellele nime ja määrates andmetüübi.
Kas @kasutaja.muutujanimi või {{kasutaja.muutujanimi}} saab kasutada tekstikaardil muutujale „Kasutaja” viitamiseks.
Boti muutujad
Kõigil vestlusroti kasutajatel on juurdepääs nendele muutujatele kõigis vestlustes. Neid kasutatakse sageli arendajateabe ja konfiguratsiooni salvestamiseks, näiteks API-kõnede lõpp-punktide, roboti versiooninumbri või selle nime salvestamiseks.
Boti muutuja loomiseks järgige neid samme.
Samm 1. Valige 'Chatbot Settings', klõpsates vasakus ülanurgas Botpressi ikooni.
2. samm. Valige vahekaartidelt 'Muutujad'.
3. samm. Määrake roboti muutuja nimi ja andmetüüp.
Sarnaselt kasutaja muutujatele saab @bot.muutujanimi või bot.muutujanimi kasutada kaartidel olevatele roboti muutujatele viitamiseks.
Konfiguratsioonimuutujad
Need on spetsiaalset tüüpi turvalise roboti muutujad. Saate neid hallata pilve armatuurlaualt ja robotit pole vaja avada. Konfiguratsioonimuutujad sobivad ideaalselt tundliku teabe, nagu API-märgid, privaatsed IP-aadressid või andmebaasi mandaadid, salvestamiseks.
Konfiguratsioonimuutuja loomiseks tehke järgmist.
Samm 1. Avage vasakus ülanurgas Botpressi ikoonil „Chatbot Settings”.
2. samm. Klõpsake vahekaarti 'Muutujad'.
3. samm. Lisage konfiguratsioonimuutuja ning sisestage selle nimi ja väärtus.
Koodis olevatele konfiguratsioonimuutujatele juurdepääsemiseks võite kasutada faili env.key, kus 'võti' tähistab hankitava konfiguratsioonimuutuja nime.
Muutujate kasutamine koodis
Koodis muutujate kasutamisel ei ole lokkis sulud “{{ }}” või @ sümbol vajalik. Koodi muutujatele juurdepääsu süntaks järgib mustrit muutujatüüp.muutujanimi. Näiteks:
Kood:
- töövoog.phoneNumber
- session.userAcctId
- kasutaja.eesnimi
- bot.otspunkt
- env.apiKey
Muutujatele saab määrata väärtusi või neid koodis värskendada. Kuid vigade vältimiseks on ülioluline tagada, et määratud väärtus vastaks muutuja andmetüübile.
Järeldus
Muutujad on Botpressi dünaamilise ja isikupärastatud suhtluse ehitusplokid. Kasutades erinevaid andmetüüpe ja mõistes muutujate ulatust, saavad arendajad luua võimsate võimalustega vestlusroboteid. Kas teil on vaja kasutajateavet salvestada, API-dega ühenduse loomine või andmete edastamine töövoogude ja muutujate vahel Botpressis pakuvad vajalikku paindlikkust ja kontrolli.