Pochopenie typov údajov pre premenné
Skôr než sa ponoríme do praktických aspektov používania premenných, oboznámme sa s rôznymi dostupnými typmi údajov v Botpresse.
- Reťazec: Reťazce sa používajú na ukladanie textu, ktorý môže pozostávať z písmen, číslic alebo špeciálnych znakov. Bežne sa používajú na ukladanie mien používateľov alebo správ generovaných AI.
- Boolean: Boolovské hodnoty môžu obsahovať iba dve hodnoty – true alebo false. Sú ideálne na ukladanie binárnych informácií, napríklad či je používateľ vracajúci sa zákazník alebo či sa chce spýtať na niečo iné.
- číslo: Ako už názov napovedá, číselné premenné sa používajú na ukladanie číselných hodnôt, ktoré môžu byť buď celé čísla alebo čísla s desatinnými miestami. Sú užitočné na ukladanie telefónnych čísel, smerových čísel a iných číselných údajov.
- Dátum: Premenné dátumu používajú formát dátumu a času ISO 8601. Predstavuje buď jeden dátum alebo dátum a čas.
- objekt: Objektová premenná je kolekcia párov kľúč – hodnota, ktoré sú podobné slovníkom alebo mapám. Sú cenné na ukladanie zložitých dátových štruktúr, ako sú užívateľské profily alebo výsledky volania API.
- Pole: Polia sa používajú na ukladanie kolekcií podobných premenných. Môžu obsahovať reťazce alebo objekty, vďaka čomu sú všestranné pre rôzne prípady použitia, ako je ukladanie minulých správ používateľa alebo poskytovanie možností, z ktorých si môže používateľ vybrať.
- Enum: Toto je premenná s obmedzeným súborom preddefinovaných možností. Sú vhodné pre scenáre, ako je ukladanie dní v týždni alebo dostupných položiek v jedálnom lístku.
- vzor: Premenné vzorov využívajú regulárne výrazy (Regex) na ukladanie špeciálnych vzorov, ktoré možno použiť na priradenie konkrétnych slov alebo čísel. Sú praktické na ukladanie čísel účtov alebo čísiel letov.
Pochopenie variabilných rozsahov
Botpress obsahuje rôzne typy premenných a líšia sa v závislosti od toho, kde môžu byť dostupné v toku vášho chatbota. Poďme preskúmať rôzne rozsahy premenných, počnúc od najobmedzenejších po najširšie:
Premenné pracovného toku
Tieto premenné sú definované a používané v rámci jedného alebo toho istého pracovného postupu. Sú vynikajúce pre toky na jedno použitie, ako je ukladanie výstupov úloh AI, odpovedí používateľov na otázky alebo organizovanie údajov z volaní API.
Pri vytváraní premennej pracovného toku môžete postupovať podľa týchto krokov:
Krok 1. V ponuke „Prieskumník“ vyberte príslušný pracovný postup.
Krok 2. Dvojitým kliknutím na prázdnu oblasť v editore pracovného toku sa otvorí panel Inšpektor.
Krok 3. Zadajte názov premennej, vyberte typ údajov premennej a kliknutím na tlačidlo „Pridať“ vytvorte premennú.
V sekcii Ďalšie nastavenia môžete do premennej pridať predvolenú (počiatočnú) hodnotu.
Vstupné a výstupné premenné pracovného toku
Na výmenu informácií môžu mať pracovné toky vstupné a výstupné premenné. Vstupy sa používajú na prijímanie informácií z externých zdrojov alebo iných pracovných tokov, zatiaľ čo výstupy poskytujú informácie do externých zdrojov alebo iných pracovných tokov. To umožňuje flexibilnejšiu komunikáciu a výmenu údajov v rámci robota.
Na označenie vstupnej premennej je možné použiť tieto kroky:
Krok 1. Vytvorte premennú v rámci pracovného postupu.
Krok 2. Vyberte premennú kliknutím na vstupný uzol pracovného postupu na paneli Inšpektor.
Na označenie výstupnej premennej je možné vykonať tieto kroky:
Krok 1. Vytvorte premennú v rámci pracovného postupu.
Krok 2. Vyberte premennú kliknutím na výstupný uzol pracovného postupu na paneli Inšpektor.
Premenné relácie
Všetky toky majú prístup k týmto premenným, ale iba v jednej konverzácii. Sú ideálne na ukladanie údajov, ktoré sa používajú počas konverzácie, ako je história chatu, zhromaždené položky vo virtuálnom nákupnom košíku alebo dočasné údaje z volaní API.
Ak chcete vytvoriť premennú relácie, môžete napísať nasledujúci kód:
session.variablename = 'Ahojte chalani!' ;Ak chcete použiť premennú v textovej karte, musíme ju uzavrieť do zložených zátvoriek, napr. {{session.variablename}} .
Používateľské premenné
Používateľské premenné sledujú používateľa medzi konverzáciami, čo umožňuje, aby údaje pretrvávali počas viacerých interakcií s chatbotom. Sú ideálne na ukladanie informácií, ktoré zostávajú pre používateľa relevantné v priebehu času, ako sú osobné údaje, značky z minulých konverzácií alebo jazykové preferencie.
Ak chcete vytvoriť používateľskú premennú:
Krok 1. Otvorte „Nastavenia chatbota“ pomocou ikony Botpress umiestnenej v ľavom hornom rohu.
Krok 2. Na kartách vyberte „Premenné“.
Krok 3. Definujte používateľskú premennú jej pomenovaním a uvedením typu údajov.
Na odkazovanie na premennú „Používateľ“ na textovej karte možno použiť buď @user.názov premennej alebo {{user.názov premennej}}.
Premenné robota
Všetci používatelia v chatbote majú prístup k týmto premenným vo všetkých konverzáciách. Často sa používajú na ukladanie informácií o vývojároch a konfigurácie, ako je ukladanie koncových bodov pre volania API, číslo verzie robota alebo jeho názov.
Pri vytváraní premennej robota postupujte podľa týchto krokov:
Krok 1. Vyberte „Nastavenia chatbota“ kliknutím na ikonu Botpress v ľavom hornom rohu.
Krok 2. Na kartách vyberte „Premenné“.
Krok 3. Zadajte názov a typ údajov premennej robota.
Podobne ako používateľské premenné, aj @bot.variablename alebo bot.variablename možno použiť na odkazovanie na premenné robota na kartách.
Konfiguračné premenné
Sú špeciálnym typom premennej zabezpečeného robota. Môžete ich spravovať z Cloud Dashboard a nie je potrebné otvárať robota. Konfiguračné premenné sú ideálne na ukladanie citlivých informácií, ako sú tokeny API, súkromné adresy IP alebo poverenia databázy.
Ak chcete vytvoriť konfiguračnú premennú:
Krok 1. Otvorte „Nastavenia chatbota“ pomocou ikony Botpress umiestnenej v ľavom hornom rohu.
Krok 2. Kliknite na kartu „Premenné“.
Krok 3. Pridajte konfiguračnú premennú a zadajte jej názov a hodnotu.
Na prístup ku konfiguračným premenným v kóde môžete použiť „env.key“, kde „key“ predstavuje názov konfiguračnej premennej, ktorá sa má získať.
Používanie premenných v kóde
Zložené zátvorky „{{ }}“ alebo symbol @ nie sú potrebné pri použití premenných v kóde. Syntax pre prístup k premenným v kóde sa riadi vzorom „variabletype.variablename“. Napríklad:
kód:
- workflow.phoneNumber
- session.userAcctId
- user.firstName
- bot.koncový bod
- env.apiKey
Premenným je možné priradiť hodnoty alebo ich aktualizovať v kóde. Je však dôležité zabezpečiť, aby sa priradená hodnota zhodovala s typom údajov premennej, aby sa predišlo chybám.
Záver
Premenné sú stavebnými kameňmi dynamických a personalizovaných interakcií v Botpresse. Použitím rôznych typov údajov a pochopením premenných rozsahov môžu vývojári vytvárať chatboty s výkonnými schopnosťami. Či už potrebujete ukladať informácie o používateľovi, prepojenie s API alebo odovzdávanie údajov medzi pracovnými tokmi a premennými v Botpresse poskytuje potrebnú flexibilitu a kontrolu.