Porozumění datovým typům pro proměnné
Než se ponoříme do praktických aspektů používání proměnných, seznamme se s různými dostupnými datovými typy v Botpressu.
- Tětiva: Řetězce se používají k uložení textu, který se může skládat z písmen, číslic nebo speciálních znaků. Běžně se používají k ukládání uživatelských jmen nebo zpráv generovaných AI.
- Boolean: Booleovské hodnoty mohou obsahovat pouze dvě hodnoty – true nebo false. Jsou ideální pro ukládání binárních informací, například zda je uživatel vracejícím se zákazníkem nebo se chce na něco jiného zeptat.
- Číslo: Jak název napovídá, číselné proměnné se používají k ukládání číselných hodnot, které mohou být buď celá čísla, nebo čísla s desetinnými místy. Jsou užitečné pro ukládání telefonních čísel, směrových čísel a dalších číselných údajů.
- Datum: Proměnné Date používají formát data a času ISO 8601. Představuje buď jedno datum, nebo datum a čas.
- Objekt: Objektová proměnná je kolekce párů klíč-hodnota, které jsou podobné slovníkům nebo mapám. Jsou cenné pro ukládání složitých datových struktur, jako jsou uživatelské profily nebo výsledky volání API.
- Pole: Pole se používají k ukládání kolekcí podobných proměnných. Mohou obsahovat řetězce nebo objekty, díky čemuž jsou univerzální pro různé případy použití, jako je ukládání minulých zpráv uživatele nebo poskytování možností, ze kterých si může uživatel vybrat.
- Výčet: Toto je proměnná s omezenou sadou předdefinovaných voleb. Jsou vhodné pro scénáře, jako je ukládání dnů v týdnu nebo dostupných položek v jídelním lístku.
- Vzor: Proměnné vzoru využívají regulární výrazy (Regex) k uložení speciálních vzorů, které lze použít ke shodě konkrétních slov nebo čísel. Jsou užitečné pro uložení čísel účtů nebo čísel letů.
Pochopení proměnných rozsahů
Botpress obsahuje různé typy proměnných a liší se v závislosti na tom, kde mohou být dostupné v toku vašeho chatbota. Pojďme prozkoumat různé rozsahy proměnných, počínaje nejomezenějšími po nejširší:
Proměnné pracovního postupu
Tyto proměnné jsou definovány a používány v rámci jednoho nebo stejného pracovního postupu. Jsou vynikající pro toky na jedno použití, jako je ukládání výstupů úloh AI, uživatelských odpovědí na otázky nebo organizace dat z volání API.
Při vytváření proměnné pracovního postupu lze postupovat podle těchto kroků:
Krok 1. V nabídce „Explorer“ vyberte příslušný pracovní postup.
Krok 2. Poklepáním na prázdnou oblast v editoru pracovního postupu se otevře panel Inspektor.
Krok 3 Zadejte název proměnné, vyberte datový typ proměnné a kliknutím na tlačítko „Přidat“ vytvořte proměnnou.
V sekci „Další nastavení“ můžete do proměnné přidat výchozí (počáteční) hodnotu.
Vstupní a výstupní proměnné pracovního postupu
Pro výměnu informací mohou mít pracovní postupy vstupní a výstupní proměnné. Vstupy se používají k přijímání informací z externích zdrojů nebo jiných pracovních toků, zatímco výstupy poskytují informace externím zdrojům nebo jiným pracovním tokům. To umožňuje flexibilnější komunikaci a výměnu dat v rámci robota.
Pro označení vstupní proměnné lze provést tyto kroky:
Krok 1. Vytvořte proměnnou uvnitř pracovního postupu.
Krok 2. Vyberte proměnnou kliknutím na vstupní uzel pracovního postupu na panelu Inspektor.
Pro označení výstupní proměnné lze provést tyto kroky:
Krok 1. Vytvořte proměnnou uvnitř pracovního postupu.
Krok 2. Vyberte proměnnou kliknutím na výstupní uzel pracovního postupu na panelu Inspektor.
Proměnné relace
Všechny toky mají k těmto proměnným přístup, ale pouze pro jednu konverzaci. Jsou ideální pro ukládání dat, která se používají během konverzace, jako je historie chatu, shromážděné položky ve virtuálním nákupním košíku nebo dočasná data z volání API.
Chcete-li vytvořit proměnnou relace, můžete napsat následující kód:
session.variablename = 'Ahoj hoši!' ;Pro použití vaší proměnné v textové kartě ji musíme uzavřít do složených závorek, např. {{session.variablename}} .
Uživatelské proměnné
Uživatelské proměnné sledují uživatele mezi konverzacemi, což umožňuje, aby data přetrvávala během více interakcí s chatbotem. Jsou ideální pro ukládání informací, které zůstávají pro uživatele relevantní v průběhu času, jako jsou osobní údaje, značky z minulých konverzací nebo jazykové preference.
Chcete-li vytvořit uživatelskou proměnnou:
Krok 1. Otevřete „Nastavení chatbota“ pomocí ikony Botpress umístěné v levém horním rohu.
Krok 2. Na kartách vyberte „Proměnné“.
Krok 3 Definujte uživatelskou proměnnou tak, že ji pojmenujete a uvedete typ dat.
K odkazování na proměnnou „Uživatel“ na textové kartě lze použít buď @user.variablename, nebo {{user.variablename}}.
Proměnné robota
Všichni uživatelé v chatbotu mají přístup k těmto proměnným ve všech konverzacích. Často se používají k ukládání informací o vývojáři a konfiguraci, jako je ukládání koncových bodů pro volání API, číslo verze robota nebo jeho název.
Chcete-li vytvořit proměnnou robota, postupujte takto:
Krok 1. Vyberte „Nastavení chatbota“ kliknutím na ikonu Botpress v levém horním rohu.
Krok 2. Na kartách vyberte „Proměnné“.
Krok 3 Zadejte název a datový typ proměnné robota.
Stejně jako uživatelské proměnné lze @bot.variablename nebo bot.variablename použít k odkazování na proměnné robota na kartách.
Konfigurační proměnné
Jsou speciálním typem zabezpečené proměnné bota. Můžete je spravovat z Cloud Dashboard a není třeba otevírat robota. Konfigurační proměnné jsou ideální pro ukládání citlivých informací, jako jsou tokeny API, soukromé IP adresy nebo přihlašovací údaje k databázi.
Chcete-li vytvořit konfigurační proměnnou:
Krok 1. Otevřete „Nastavení chatbota“ pomocí ikony Botpress umístěné v levém horním rohu.
Krok 2. Klikněte na kartu „Proměnné“.
Krok 3 Přidejte konfigurační proměnnou a zadejte její název a hodnotu.
Pro přístup ke konfiguračním proměnným v kódu můžete použít „env.key“, kde „key“ představuje název konfigurační proměnné, která má být načtena.
Použití proměnných v kódu
Při použití proměnných v kódu nejsou složené závorky „{{ }}“ nebo symbol @ nutné. Syntaxe pro přístup k proměnným v kódu se řídí vzorem „variabletype.variablename“. Například:
Kód:
- workflow.phoneNumber
- session.userAcctId
- user.firstName
- bot.koncový bod
- env.apiKey
Proměnným lze přiřadit hodnoty nebo je aktualizovat v kódu. Je však důležité zajistit, aby přiřazená hodnota odpovídala datovému typu proměnné, aby se předešlo chybám.
Závěr
Proměnné jsou stavebními kameny dynamických a personalizovaných interakcí v Botpressu. Pomocí různých datových typů a pochopení proměnných rozsahů mohou vývojáři vytvářet chatboty s výkonnými schopnostmi. Ať už potřebujete ukládat informace o uživateli, připojovat se k rozhraním API nebo předávat data mezi pracovními postupy a proměnnými v Botpressu, poskytuje potřebnou flexibilitu a kontrolu.