A változók adattípusainak megértése
Mielőtt belemerülnénk a változók használatának gyakorlati vonatkozásaiba, ismerkedjünk meg a Botpress különböző elérhető adattípusaival.
- Húr: A karakterláncok a szöveg tárolására szolgálnak, amely betűkből, számokból vagy speciális karakterekből állhat. Általában a felhasználónevek vagy a mesterséges intelligencia által generált üzenetek tárolására szolgálnak.
- Logikai érték: A logikai értékek csak két értéket tartalmazhatnak – igazat vagy hamisat. Ideálisak a bináris információk tárolására, például arra, hogy a felhasználó visszatérő vásárló-e, vagy ha a felhasználó mást szeretne kérdezni.
- Szám: Ahogy a neve is sugallja, a számváltozók a numerikus értékek tárolására szolgálnak, amelyek lehetnek egészek vagy tizedesjegyekkel kiegészített számok. Hasznosak a telefonszámok, körzetszámok és egyéb számadatok tárolására.
- Dátum: A Dátum változók az ISO 8601 dátum/idő formátumot használják. Egyetlen dátumot vagy dátumot és időt jelent.
- Tárgy: Az objektumváltozó kulcs-érték párok gyűjteménye, amelyek hasonlóak a szótárokhoz vagy a térképekhez. Értékesek az összetett adatstruktúrák, például a felhasználói profilok vagy az API-hívások eredményeinek tárolására.
- Sor: A tömbök a hasonló változók gyűjteményének tárolására szolgálnak. Tartalmazhatják a karakterláncokat vagy objektumokat, így sokoldalúan használhatók különféle felhasználási esetekben, mint például a felhasználó múltbeli üzeneteinek tárolása vagy választási lehetőségek biztosítása a felhasználó számára.
- Név: Ez egy változó előre meghatározott választási lehetőségek korlátozott készletével. Olyan forgatókönyvekre alkalmasak, mint a hét napjainak vagy az ételmenü elérhető tételeinek tárolása.
- Minta: A mintaváltozók a reguláris kifejezéseket (Regex) használják a speciális minták tárolására, amelyek felhasználhatók bizonyos szavak vagy számok egyeztetésére. Praktikusak a számlaszámok vagy a járatszámok tárolására.
A változó hatóköreinek megértése
A Botpress különféle típusú változókat tartalmaz, és attól függően változnak, hogy hol érhetők el a chatbot folyamatában. Vizsgáljuk meg a különböző változók hatóköreit, kezdve a legkorlátozottabbtól a legtágabbig:
Munkafolyamat-változók
Ezeket a változókat egyetlen vagy ugyanazon munkafolyamatban határozzák meg és használják. Kiválóan alkalmasak olyan egyszer használatos folyamatokhoz, mint például az AI-feladatok kimeneteinek tárolása, a felhasználói kérdésekre adott válaszok, vagy az API-hívásokból származó adatok rendszerezése.
Munkafolyamat-változó létrehozásához a következő lépéseket lehet követni:
1. lépés. Válassza ki a megfelelő munkafolyamatot az „Explorer” menüben.
2. lépés. Ha duplán kattint egy üres területre a munkafolyamat-szerkesztőben, megnyílik a Felügyelő panel.
3. lépés Adja meg a változó nevét, válassza ki a változó adattípusát, és kattintson a „Hozzáadás” gombra a változó létrehozásához.
A „További beállítások” részben hozzáadhat egy alapértelmezett (kezdeti) értéket a változóhoz.
Bemeneti és kimeneti munkafolyamat-változók
Az információcseréhez a munkafolyamatok bemeneti és kimeneti változókkal rendelkezhetnek. A bemenetek a külső forrásokból vagy más munkafolyamatokból származó információk fogadására szolgálnak, míg a kimenetek a külső források vagy más munkafolyamatok számára nyújtanak információt. Ez rugalmasabb kommunikációt és adatcserét tesz lehetővé a boton belül.
Az alábbi lépések követhetők egy bemeneti változó megjelöléséhez:
1. lépés. Hozza létre a változót a munkafolyamatban.
2. lépés. Válassza ki a változót a munkafolyamat beviteli csomópontjára kattintva a Felügyelő panelen.
Az alábbi lépések követhetők a kimeneti változó megjelöléséhez:
1. lépés. Hozza létre a változót a munkafolyamatban.
2. lépés. Válassza ki a változót a munkafolyamat kilépési csomópontjára kattintva a Felügyelő panelen.
Munkamenet-változók
Minden folyamat hozzáférhet ezekhez a változókhoz, de csak egyetlen beszélgetéshez. Ideálisak a beszélgetés során felhasznált adatok, például a csevegési előzmények, a virtuális bevásárlókosárban összegyűjtött tételek vagy az API-hívásokból származó ideiglenes adatok tárolására.
Munkamenetváltozó létrehozásához írja be a következő kódot:
session.variablename = 'Helló srácok!' ;Ahhoz, hogy a változóját szöveges kártyában használjuk, a zárójelbe kell zárnunk, pl. {{session.variablename}} .
Felhasználói változók
A felhasználói változók követik a felhasználót a beszélgetések között, ami lehetővé teszi az adatok fennmaradását a chatbottal folytatott többszöri interakciók során. Tökéletesek olyan információk tárolására, amelyek a felhasználó számára idővel relevánsak maradnak, például személyes adatok, korábbi beszélgetések címkéi vagy nyelvi beállítások.
Felhasználói változó létrehozása:
1. lépés. Nyissa meg a „Chatbot beállításait” a bal felső sarokban található Botpress ikonról.
2. lépés. Válassza a „Változók” lehetőséget a lapokon.
3. lépés Határozza meg a felhasználói változót annak elnevezésével és az adattípus megadásával.
A @felhasználó.változónév vagy a {{felhasználó.változónév}} használható a szövegkártyán lévő „Felhasználó” változóra való hivatkozásra.
Bot változók
A chatbot minden felhasználója hozzáfér ezekhez a változókhoz az összes beszélgetés során. Gyakran használják a fejlesztői információk és konfigurációk tárolására, például az API-hívások végpontjainak, a bot verziószámának vagy nevének tárolására.
Bot-változó létrehozásához kövesse az alábbi lépéseket:
1. lépés. A bal felső sarokban található Botpress ikonra kattintva válassza ki a „Chatbot beállítások” lehetőséget.
2. lépés. Válassza a „Változók” lehetőséget a lapokon.
3. lépés Adja meg a robotváltozó nevét és adattípusát.
A felhasználói változókhoz hasonlóan a @bot.variablename vagy a bot.variablename is használható a kártyákon lévő botváltozókra való hivatkozásra.
Konfigurációs változók
Ezek a biztonságos bot-változók speciális típusai. A Cloud Dashboardról kezelheti őket, és nincs szükség a bot megnyitására. A konfigurációs változók ideálisak érzékeny információk, például API-tokenek, privát IP-címek vagy adatbázis-hitelesítő adatok tárolására.
Konfigurációs változó létrehozása:
1. lépés. Nyissa meg a „Chatbot beállításait” a bal felső sarokban található Botpress ikonról.
2. lépés. Kattintson a „Változók” fülre.
3. lépés Adjon hozzá egy konfigurációs változót, és adja meg a nevét és értékét.
A kódban található konfigurációs változók eléréséhez használhatja az „env.key”-t, ahol a „kulcs” a lekérendő konfigurációs változó nevét jelenti.
Változók használata a kódban
A göndör zárójelek „{{ }}” vagy @ szimbólum nem szükséges, ha változókat használ a kódban. A kódban lévő változókhoz való hozzáférés szintaxisa a „változótípus.változónév” mintát követi. Például:
Kód:
- munkafolyamat.phoneNumber
- session.userAcctId
- user.firstName
- bot.végpont
- env.apiKey
A változók értékekkel rendelhetők vagy frissíthetők a kódban. A hibák elkerülése érdekében azonban elengedhetetlen annak biztosítása, hogy a hozzárendelt érték megegyezzen a változó adattípusával.
Következtetés
A változók a dinamikus és személyre szabott interakciók építőkövei a Botpressben. A különféle adattípusok használatával és a változó hatókörök megértésével a fejlesztők hatékony képességekkel rendelkező chatbotokat hozhatnak létre. Függetlenül attól, hogy tárolnia kell a felhasználói információkat, az API-kkal való kapcsolódás vagy az adatok átadása a Botpress munkafolyamatai és változói között biztosítja a szükséges rugalmasságot és vezérlést.