Kintamųjų duomenų tipų supratimas
Prieš pasinerdami į praktinius kintamųjų naudojimo aspektus, susipažinkime su skirtingais prieinamais Botpress duomenų tipais.
- Eilutė: Stygos naudojamos tekstui, kurį gali sudaryti raidės, skaičiai arba specialieji simboliai, saugoti. Jie dažniausiai naudojami vartotojų vardams arba AI generuotiems pranešimams saugoti.
- Būlio: Būlio reikšmės gali turėti tik dvi reikšmes – true arba false. Jie idealiai tinka dvejetainei informacijai saugoti, pvz., ar vartotojas yra sugrįžtantis klientas, ar vartotojas nori ko nors paklausti.
- Numeris: Kaip rodo pavadinimas, skaičių kintamieji naudojami skaitinėms reikšmėms, kurios gali būti sveikieji skaičiai arba skaičiai po kablelio, saugoti. Jie naudingi telefonų numeriams, vietovės kodams ir kitiems skaitmeniniams duomenims saugoti.
- Data: Datos kintamieji naudoja ISO 8601 datos ir laiko formatą. Tai reiškia vieną datą arba datą ir laiką.
- Objektas: Objekto kintamasis yra raktų ir reikšmių porų, panašių į žodynus ar žemėlapius, rinkinys. Jie yra vertingi saugojant sudėtingas duomenų struktūras, tokias kaip vartotojo profiliai arba API skambučio rezultatai.
- Masyvas: Masyvai naudojami panašių kintamųjų kolekcijoms saugoti. Jie gali turėti eilutes arba objektus, todėl jie yra universalūs įvairiems naudojimo atvejams, pavyzdžiui, saugoti ankstesnius vartotojo pranešimus arba suteikiant vartotojui pasirinkimo parinktis.
- Enum: Tai kintamasis su ribotu iš anksto nustatytų pasirinkimų rinkiniu. Jie tinka tokiems scenarijams kaip savaitės dienų ar turimų elementų saugojimas maisto meniu.
- Šablonas: Šablonų kintamieji naudoja reguliariąsias išraiškas (Regex), kad saugotų specialius šablonus, kurie gali būti naudojami konkretiems žodžiams ar skaičiams suderinti. Jie yra patogūs norint išsaugoti sąskaitų arba skrydžių numerius.
Kintamųjų apimčių supratimas
Į „Botpress“ įtraukti įvairių tipų kintamieji ir jie skiriasi priklausomai nuo to, kur juos galima pasiekti jūsų pokalbių roboto sraute. Išnagrinėkime įvairias kintamųjų sritis, pradedant nuo pačių ribotiausių ir baigiant plačiausiu:
Darbo eigos kintamieji
Šie kintamieji yra apibrėžti ir naudojami vienoje arba toje pačioje darbo eigoje. Jie puikiai tinka vienkartiniams srautams, pvz., AI užduočių išvestims saugoti, vartotojų atsakymams į klausimus arba API iškvietimų duomenims tvarkyti.
Norėdami sukurti darbo eigos kintamąjį, galite atlikti šiuos veiksmus:
1 žingsnis. Meniu „Explorer“ pasirinkite tinkamą darbo eigą.
2 žingsnis. Dukart spustelėjus tuščią sritį darbo eigos rengyklėje, atidaromas skydelis Inspektorius.
3 veiksmas. Nurodykite kintamojo pavadinimą, pasirinkite kintamojo duomenų tipą ir spustelėkite mygtuką „Pridėti“, kad sukurtumėte kintamąjį.
Skiltyje „Papildomi nustatymai“ galite pridėti numatytąją (pradinę) kintamojo reikšmę.
Įvesties ir išvesties darbo eigos kintamieji
Norint keistis informacija, darbo eigos gali turėti įvesties ir išvesties kintamuosius. Įvestys naudojamos informacijai gauti iš išorinių šaltinių ar kitų darbo eigų, o išvestis suteikia informaciją išoriniams šaltiniams arba kitoms darbo eigoms. Tai leidžia lanksčiau bendrauti ir keistis duomenimis robote.
Norėdami pažymėti įvesties kintamąjį, galite atlikti šiuos veiksmus:
1 žingsnis. Sukurkite kintamąjį darbo eigos viduje.
2 žingsnis. Pasirinkite kintamąjį spustelėdami darbo eigos įvesties mazgą skydelyje Inspektorius.
Norėdami pažymėti išvesties kintamąjį, galite atlikti šiuos veiksmus:
1 žingsnis. Sukurkite kintamąjį darbo eigos viduje.
2 žingsnis. Pasirinkite kintamąjį spustelėdami darbo eigos išėjimo mazgą skydelyje Inspektorius.
Seanso kintamieji
Visi srautai gali pasiekti šiuos kintamuosius, bet tik vienam pokalbiui. Jie idealiai tinka saugoti duomenis, kurie naudojami pokalbio metu, pvz., pokalbių istoriją, surinktus elementus virtualiame pirkinių krepšelyje arba laikinus duomenis iš API skambučių.
Norėdami sukurti seanso kintamąjį, galite parašyti šį kodą:
sesija.kintamojo pavadinimas = 'Sveiki bičiuliai!' ;Norėdami naudoti kintamąjį teksto kortelėje, turime jį uždaryti skliausteliuose, pvz., {{session.variablename}} .
Vartotojo kintamieji
Vartotojo kintamieji seka vartotoją tarp pokalbių, todėl duomenys gali išlikti per kelias sąveikas su pokalbių robotu. Jie puikiai tinka informacijai, kuri laikui bėgant išlieka svarbi vartotojui, saugoti, pvz., asmeninės informacijos, ankstesnių pokalbių žymų ar kalbos nuostatų.
Norėdami sukurti vartotojo kintamąjį:
1 žingsnis. Viršutiniame kairiajame kampe esančioje Botpress piktogramoje atidarykite „Chatbot Settings“.
2 žingsnis. Iš skirtukų pasirinkite „Kintamieji“.
3 veiksmas. Apibrėžkite naudotojo kintamąjį pavadindami jį ir nurodydami duomenų tipą.
@user.variablename arba {{user.variablename}} galima naudoti norint nurodyti teksto kortelėje esantį kintamąjį „Vartotojas“.
Boto kintamieji
Visi pokalbių roboto naudotojai turi prieigą prie šių kintamųjų visuose pokalbiuose. Jie dažnai naudojami kūrėjo informacijai ir konfigūracijai saugoti, pvz., API skambučių galutiniams taškams, roboto versijos numeriui arba jo pavadinimui saugoti.
Norėdami sukurti Bot kintamąjį, atlikite šiuos veiksmus:
1 žingsnis. Viršutiniame kairiajame kampe spustelėkite „Botpress“ piktogramą ir pasirinkite „Chatbot Settings“.
2 žingsnis. Iš skirtukų pasirinkite „Kintamieji“.
3 veiksmas. Nurodykite roboto kintamojo pavadinimą ir duomenų tipą.
Kaip ir naudotojo kintamieji, @bot.variablename arba bot.variablename gali būti naudojami kortelėse esantiems roboto kintamiesiems nurodyti.
Konfigūracijos kintamieji
Jie yra specialus saugaus roboto kintamojo tipas. Galite juos valdyti naudodami „Cloud Dashboard“ ir nereikia atidaryti roboto. Konfigūracijos kintamieji idealiai tinka saugoti slaptą informaciją, pvz., API prieigos raktus, privačius IP adresus arba duomenų bazės kredencialus.
Norėdami sukurti konfigūracijos kintamąjį:
1 žingsnis. Viršutiniame kairiajame kampe esančioje Botpress piktogramoje atidarykite „Chatbot Settings“.
2 žingsnis. Spustelėkite skirtuką „Kintamieji“.
3 veiksmas. Pridėkite konfigūracijos kintamąjį ir pateikite jo pavadinimą bei reikšmę.
Norėdami pasiekti konfigūracijos kintamuosius kode, galite naudoti „env.key“, kur „key“ reiškia konfigūracijos kintamojo pavadinimą, kurį reikia gauti.
Kintamųjų naudojimas kode
Garbanotieji skliaustai „{{ }}“ arba simbolis @ nebūtini, kai kode naudojami kintamieji. Kode esančių kintamųjų prieigos sintaksė atitinka šabloną „kintamojo tipas.kintamojo pavadinimas“. Pavyzdžiui:
Kodas:
- darbo eiga.phoneNumber
- session.userAcctId
- user.firstName
- bot.galinis taškas
- env.apiKey
Kintamiesiems gali būti priskirtos reikšmės arba jie gali būti atnaujinti kode. Tačiau labai svarbu užtikrinti, kad priskirta reikšmė atitiktų kintamojo duomenų tipą, kad būtų išvengta klaidų.
Išvada
Kintamieji yra dinamiškos ir individualizuotos sąveikos sistemoje „Botpress“ pagrindiniai elementai. Naudodami įvairius duomenų tipus ir suprasdami kintamąsias apimtis, kūrėjai gali sukurti pokalbių robotus su galingomis galimybėmis. Nesvarbu, ar jums reikia saugoti vartotojo informaciją, prisijungti prie API, ar perduoti duomenis tarp darbo eigos ir kintamųjų „Botpress“, suteikia reikiamo lankstumo ir valdymo.