Zrozumienie typów danych dla zmiennych
Zanim zagłębimy się w praktyczne aspekty wykorzystania zmiennych, zapoznajmy się z różnymi typami danych dostępnymi w Botpressie.
- Strunowy: Ciągi służą do przechowywania tekstu, który może składać się z liter, cyfr lub znaków specjalnych. Są powszechnie używane do przechowywania nazw użytkowników lub wiadomości generowanych przez sztuczną inteligencję.
- Wartość logiczna: Wartości logiczne mogą przechowywać tylko dwie wartości – prawdę lub fałsz. Idealnie nadają się do przechowywania informacji binarnych, np. czy użytkownik jest powracającym klientem lub czy chce zapytać o coś innego.
- Numer: Jak sama nazwa wskazuje, zmienne liczbowe służą do przechowywania wartości numerycznych, które mogą być liczbami całkowitymi lub liczbami z miejscami dziesiętnymi. Są przydatne do przechowywania numerów telefonów, numerów kierunkowych i innych danych liczbowych.
- Data: Zmienne daty korzystają z formatu daty/godziny ISO 8601. Reprezentuje pojedynczą datę lub datę i godzinę.
- Obiekt: Zmienna obiektowa to zbiór par klucz-wartość, które są podobne do słowników lub map. Są cenne do przechowywania złożonych struktur danych, takich jak profile użytkowników lub wyniki wywołania API.
- Szyk: Tablice służą do przechowywania kolekcji podobnych zmiennych. Mogą przechowywać ciągi znaków lub obiekty, co czyni je uniwersalnymi do różnych zastosowań, takich jak przechowywanie wcześniejszych wiadomości użytkownika lub zapewnianie użytkownikowi opcji do wyboru.
- Wyliczenie: Jest to zmienna posiadająca ograniczony zestaw predefiniowanych opcji. Nadają się do scenariuszy takich jak przechowywanie dni tygodnia lub dostępnych pozycji w menu żywności.
- Wzór: Zmienne wzorca wykorzystują wyrażenia regularne (Regex) do przechowywania specjalnych wzorców, których można użyć do dopasowania określonych słów lub liczb. Przydają się do przechowywania numerów kont lub numerów lotów.
Zrozumienie zakresów zmiennych
Botpress zawiera różne typy zmiennych, które różnią się w zależności od tego, gdzie są dostępne w przepływie chatbota. Przyjrzyjmy się różnym zakresom zmiennych, zaczynając od najbardziej ograniczonego do najszerszego:
Zmienne przepływu pracy
Te zmienne są definiowane i używane w ramach jednego lub tego samego przepływu pracy. Doskonale nadają się do jednorazowych przepływów, takich jak przechowywanie wyników zadań AI, odpowiedzi użytkowników na pytania lub organizowanie danych z wywołań API.
Aby utworzyć zmienną przepływu pracy, można wykonać następujące kroki:
Krok 1. Wybierz odpowiedni przepływ pracy w menu „Eksplorator”.
Krok 2. Dwukrotne kliknięcie pustego obszaru w edytorze przepływu pracy otwiera panel Inspektora.
Krok 3. Podaj nazwę zmiennej, wybierz typ danych zmiennej i kliknij przycisk „Dodaj”, aby utworzyć zmienną.
Możesz dodać domyślną (początkową) wartość do swojej zmiennej w sekcji „Dodatkowe ustawienia”.
Zmienne wejściowe i wyjściowe przepływu pracy
Aby wymieniać informacje, przepływy pracy mogą mieć zmienne wejściowe i wyjściowe. Wejścia służą do otrzymywania informacji ze źródeł zewnętrznych lub innych przepływów pracy, natomiast dane wyjściowe dostarczają informacji do źródeł zewnętrznych lub innych przepływów pracy. Pozwala to na bardziej elastyczną komunikację i wymianę danych w obrębie bota.
Aby zaznaczyć zmienną wejściową, można wykonać następujące kroki:
Krok 1. Utwórz zmienną wewnątrz przepływu pracy.
Krok 2. Wybierz zmienną, klikając węzeł wejściowy przepływu pracy w panelu Inspektor.
Aby zaznaczyć zmienną wyjściową, można wykonać następujące kroki:
Krok 1. Utwórz zmienną wewnątrz przepływu pracy.
Krok 2. Wybierz zmienną, klikając węzeł wyjściowy przepływu pracy w panelu Inspektor.
Zmienne sesji
Wszystkie przepływy mają dostęp do tych zmiennych, ale tylko w ramach jednej konwersacji. Idealnie nadają się do przechowywania danych wykorzystywanych podczas rozmowy, takich jak historia czatów, zebrane przedmioty w wirtualnym koszyku lub tymczasowe dane z wywołań API.
Aby utworzyć zmienną sesji, możesz napisać następujący kod:
nazwa_sesji.zmiennej = 'Cześć chłopaki!' ;Aby użyć zmiennej na karcie tekstowej, musimy zamknąć ją w nawiasach klamrowych, np. {{nazwa_zmiennej sesji}} .
Zmienne użytkownika
Zmienne użytkownika podążają za użytkownikiem pomiędzy rozmowami, co pozwala na zachowanie danych podczas wielu interakcji z chatbotem. Doskonale nadają się do przechowywania informacji, które z biegiem czasu pozostają istotne dla użytkownika, takich jak dane osobowe, znaczniki z poprzednich rozmów lub preferencje językowe.
Aby utworzyć zmienną użytkownika:
Krok 1. Otwórz „Ustawienia Chatbota” za pomocą ikony Botpress znajdującej się w lewym górnym rogu.
Krok 2. Z zakładek wybierz „Zmienne”.
Krok 3. Zdefiniuj zmienną użytkownika, nadając jej nazwę i określając typ danych.
W odniesieniu do zmiennej „Użytkownik” na karcie tekstowej można użyć @user.variablename lub {{user.variablename}}.
Zmienne bota
Wszyscy użytkownicy chatbota mają dostęp do tych zmiennych we wszystkich rozmowach. Często są używane do przechowywania informacji i konfiguracji programisty, np. przechowywania punktów końcowych dla wywołań API, numeru wersji bota lub jego nazwy.
Wykonaj poniższe kroki, aby utworzyć zmienną bota:
Krok 1. Wybierz „Ustawienia Chatbota”, klikając ikonę Botpress w lewym górnym rogu.
Krok 2. Z zakładek wybierz „Zmienne”.
Krok 3. Określ nazwę i typ danych zmiennej bota.
Podobnie jak zmienne użytkownika, @bot.nazwazmiennej lub bot.nazwazmiennej mogą służyć do odwoływania się do zmiennych bota na kartach.
Zmienne konfiguracyjne
Są specjalnym typem bezpiecznej zmiennej bota. Możesz nimi zarządzać z poziomu Cloud Dashboard i nie ma potrzeby otwierania bota. Zmienne konfiguracyjne idealnie nadają się do przechowywania poufnych informacji, takich jak tokeny API, prywatne adresy IP lub poświadczenia bazy danych.
Aby utworzyć zmienną konfiguracyjną:
Krok 1. Otwórz „Ustawienia Chatbota” za pomocą ikony Botpress znajdującej się w lewym górnym rogu.
Krok 2. Kliknij zakładkę „Zmienne”.
Krok 3. Dodaj zmienną konfiguracyjną i podaj jej nazwę oraz wartość.
Aby uzyskać dostęp do zmiennych konfiguracyjnych w kodzie, możesz użyć „env.key”, gdzie „key” oznacza nazwę zmiennej konfiguracyjnej, która ma zostać pobrana.
Używanie zmiennych w kodzie
Nawiasy klamrowe „{{ }}” lub symbol @ nie są konieczne, jeśli w kodzie używane są zmienne. Składnia dostępu do zmiennych w kodzie jest zgodna ze wzorcem „typ_zmiennej.nazwa_zmiennej”. Na przykład:
Kod:
- przepływ pracy.numer telefonu
- session.userAcctId
- użytkownik.imię
- bot.punkt końcowy
- env.apiKey
Zmiennym można przypisać wartości lub zaktualizować je w kodzie. Aby uniknąć błędów, ważne jest jednak, aby przypisana wartość była zgodna z typem danych zmiennej.
Wniosek
Zmienne są elementami składowymi dynamicznych i spersonalizowanych interakcji w Botpress. Korzystając z różnych typów danych i rozumiejąc zakresy zmiennych, programiści mogą tworzyć chatboty o potężnych możliwościach. Niezależnie od tego, czy potrzebujesz przechowywać informacje o użytkowniku, łączyć się z interfejsami API, czy przekazywać dane pomiędzy przepływami pracy i zmiennymi w Botpress, zapewnij niezbędną elastyczność i kontrolę.