Muuttujien tietotyyppien ymmärtäminen
Ennen kuin sukeltaamme muuttujien käytön käytännön näkökohtiin, tutustutaan Botpressin eri tietotyyppeihin.
- Merkkijono: Merkkijonoja käytetään tallentamaan tekstiä, joka voi koostua kirjaimista, numeroista tai erikoismerkeistä. Niitä käytetään yleisesti käyttäjänimien tai tekoälyn luomien viestien tallentamiseen.
- Boolen arvo: Booleanilla voi olla vain kaksi arvoa – tosi tai epätosi. Ne sopivat ihanteellisesti binääritietojen tallentamiseen, kuten onko käyttäjä palaava asiakas vai haluaako käyttäjä kysyä jotain muuta.
- Määrä: Kuten nimestä voi päätellä, numeromuuttujia käytetään tallentamaan numeeriset arvot, jotka voivat olla joko kokonaislukuja tai numeroita desimaalipaikoilla. Ne ovat hyödyllisiä puhelinnumeroiden, suuntanumeroiden ja muiden numeeristen tietojen tallentamiseen.
- Päivämäärä: Päivämäärä-muuttujat käyttävät ISO 8601 päivämäärä/aika -muotoa. Se edustaa joko yhtä päivämäärää tai päivämäärää ja aikaa.
- Esine: Objektimuuttuja on kokoelma avainarvopareja, jotka ovat samanlaisia kuin sanakirjat tai kartat. Ne ovat arvokkaita monimutkaisten tietorakenteiden, kuten käyttäjäprofiilien tai API-kutsun tulosten, tallentamiseen.
- Taulukko: Tauluja käytetään samanlaisten muuttujien kokoelmien tallentamiseen. Ne voivat sisältää merkkijonoja tai esineitä, mikä tekee niistä monipuolisia erilaisiin käyttötapauksiin, kuten käyttäjän aiempien viestien tallentamiseen tai vaihtoehtojen tarjoamiseen, joista käyttäjä voi valita.
- Enum: Tämä on muuttuja, jossa on rajoitettu joukko ennalta määritettyjä valintoja. Ne sopivat tilanteisiin, kuten viikonpäivien tai ruokalistan saatavilla olevien kohteiden tallentamiseen.
- Kuvio: Kuviomuuttujat käyttävät säännöllisiä lausekkeita (Regex) tallentamaan erityisiä kuvioita, joita voidaan käyttää täsmäämään tiettyjä sanoja tai numeroita. Ne ovat käteviä tilinumeroiden tai lentonumeroiden tallentamiseen.
Muuttuvien laajuuksien ymmärtäminen
Botpress sisältää erityyppisiä muuttujia, ja ne vaihtelevat sen mukaan, missä ne ovat käytettävissä chatbotin kulussa. Tutkitaan erilaisia muuttujien laajuuksia, alkaen rajoitetuimmista laajimpiin:
Työnkulun muuttujat
Nämä muuttujat määritellään ja niitä käytetään yhdessä tai samassa työnkulussa. Ne soveltuvat erinomaisesti kertakäyttöisiin tietovirtoihin, kuten tekoälytehtävän tulosteiden tallentamiseen, käyttäjien kysymyksiin tai sovellusliittymäkutsujen tietojen järjestämiseen.
Voit luoda työnkulkumuuttujan seuraavasti:
Vaihe 1. Valitse sopiva työnkulku 'Explorer'-valikosta.
Vaihe 2. Kaksoisnapsauttamalla tyhjää aluetta työnkulkueditorissa avautuu Asetukset-paneeli.
Vaihe 3. Määritä muuttujan nimi, valitse muuttujan tietotyyppi ja napsauta 'Lisää' -painiketta muuttujan luomiseksi.
Voit lisätä oletusarvon (alku) muuttujaasi 'Lisäasetukset'-osiosta.
Input ja Output työnkulun muuttujat
Tietojen vaihtamiseksi työnkulkuissa voi olla syöttö- ja tulosmuuttujia. Tuloksia käytetään tiedon vastaanottamiseen ulkoisista lähteistä tai muista työnkuluista, kun taas lähdöt tarjoavat tietoja ulkoisille lähteille tai muille työnkulkuille. Tämä mahdollistaa joustavamman viestinnän ja tiedonvaihdon botin sisällä.
Voit merkitä syötemuuttujan seuraavasti:
Vaihe 1. Luo muuttuja työnkulun sisällä.
Vaihe 2. Valitse muuttuja napsauttamalla työnkulun syöttösolmua Tarkastaja-paneelissa.
Voit merkitä tulosmuuttujan seuraavasti:
Vaihe 1. Luo muuttuja työnkulun sisällä.
Vaihe 2. Valitse muuttuja napsauttamalla työnkulun poistumissolmua Tarkastaja-paneelissa.
Istunnon muuttujat
Näihin muuttujiin on pääsy kaikilla virroilla, mutta vain yhtä keskustelua varten. Ne sopivat ihanteellisesti keskustelun aikana käytettyjen tietojen, kuten keskusteluhistorian, virtuaaliseen ostoskoriin kerättyjen kohteiden tai API-kutsujen väliaikaisten tietojen tallentamiseen.
Voit luoda istuntomuuttujan kirjoittamalla seuraavan koodin:
istunto.muuttujannimi = 'Hei kaverit!' ;Jos haluat käyttää muuttujaasi tekstikortissa, se on suljettava kiharahakasulkeisiin, esim. {{istunto.muuttujannimi}} .
Käyttäjän muuttujat
Käyttäjämuuttujat seuraavat käyttäjää keskustelujen välillä, mikä mahdollistaa tietojen säilymisen useissa keskustelubotin kanssa tapahtuvissa vuorovaikutuksissa. Ne sopivat täydellisesti sellaisten tietojen tallentamiseen, jotka pysyvät ajan mittaan käyttäjän kannalta merkityksellisinä, kuten henkilökohtaisia tietoja, aiempien keskustelujen tunnisteita tai kieliasetuksia.
Käyttäjämuuttujan luominen:
Vaihe 1. Avaa 'Chatbotin asetukset' vasemmassa yläkulmassa olevasta Botpress-kuvakkeesta.
Vaihe 2. Valitse välilehdistä 'Muuttujat'.
Vaihe 3. Määritä käyttäjämuuttuja nimeämällä se ja määrittämällä tietotyyppi.
Joko @user.variablename tai {{user.variablename}} voidaan käyttää viittaamaan 'Käyttäjä'-muuttujaan tekstikortissa.
Botin muuttujat
Kaikilla chatbotin käyttäjillä on pääsy näihin muuttujiin kaikissa keskusteluissa. Niitä käytetään usein tallentamaan kehittäjän tietoja ja määrityksiä, kuten API-kutsujen päätepisteiden, botin versionumeron tai sen nimen tallentamiseen.
Luo Bot-muuttuja seuraavasti:
Vaihe 1. Valitse 'Chatbot-asetukset' napsauttamalla Botpress-kuvaketta vasemmassa yläkulmassa.
Vaihe 2. Valitse välilehdistä 'Muuttujat'.
Vaihe 3. Määritä bot-muuttujan nimi ja tietotyyppi.
Kuten käyttäjämuuttujat, @bot.muuttujannimi tai bot.muuttujannimi voidaan käyttää viittaamaan korteissa oleviin bot-muuttujiin.
Konfigurointimuuttujat
Ne ovat erityinen suojattu bot-muuttuja. Voit hallita niitä Cloud Dashboardista, eikä bottia tarvitse avata. Määritysmuuttujat ovat ihanteellisia arkaluonteisten tietojen, kuten API-tunnisteiden, yksityisten IP-osoitteiden tai tietokannan valtuustietojen, tallentamiseen.
Määritysmuuttujan luominen:
Vaihe 1. Avaa 'Chatbotin asetukset' vasemmassa yläkulmassa olevasta Botpress-kuvakkeesta.
Vaihe 2. Napsauta 'Muuttujat' -välilehteä.
Vaihe 3. Lisää konfiguraatiomuuttuja ja anna sen nimi ja arvo.
Päästäksesi koodin konfigurointimuuttujiin, voit käyttää 'env.key' -koodia, jossa 'avain' edustaa noudettavan konfiguraatiomuuttujan nimeä.
Muuttujien käyttäminen koodissa
Hakasulkeet “{{ }}” tai @-symboli eivät ole välttämättömiä, kun koodissa käytetään muuttujia. Koodissa olevien muuttujien käytön syntaksi noudattaa 'muuttujatyyppi.muuttujannimi' -mallia. Esimerkiksi:
Koodi:
- workflow.phoneNumber
- session.userAcctId
- user.firstName
- bot.endpoint
- env.apiKey
Muuttujat voidaan määrittää arvoilla tai päivittää koodissa. Mutta virheiden välttämiseksi on erittäin tärkeää varmistaa, että määritetty arvo vastaa muuttujan tietotyyppiä.
Johtopäätös
Muuttujat ovat Botpressin dynaamisten ja henkilökohtaisten vuorovaikutusten rakennuspalikoita. Käyttämällä erilaisia tietotyyppejä ja ymmärtämällä muuttujien laajuutta, kehittäjät voivat luoda chatbotteja, joilla on tehokkaita ominaisuuksia. Tarvittavan joustavuuden ja hallinnan tarjoavat sitten käyttäjätietojen tallentamisen, sovellusliittymien muodostamisen tai tiedon siirtämisen työnkulkujen ja muuttujien välillä Botpressissa.