Dialogflow CX: tworzenie wirtualnego agenta do obsługi sprzedaży detalicznej

1. Zanim zaczniesz

Z tego modułu dowiesz się, jak utworzyć czatbota dla sprzedawców detalicznych za pomocą Dialogflow CX, czyli platformy konwersacyjnej AI (CAIP) do tworzenia konwersacyjnych interfejsów. Dialogflow CX może wdrażać wirtualnych agentów, takich jak chatboty, boty głosowe i bramy telefoniczne, a także obsługiwać wiele kanałów w ponad 50 językach.

Z tego ćwiczenia w Codelabs dowiesz się, jak utworzyć chatbota do witryny sprzedawcy detalicznego. Fikcyjna firma, dla której tworzymy czatbota, to G-Records. G-Records to wytwórnia płyt rockowych z siedzibą w Kalifornii. Wytwórnia ma podpisane kontrakty z 4 zespołami rockowymi: Alice Googler, G's N' Roses, The Goo Fighters i The Google Dolls. G-Records sprzedaje gadżety zespołów wszystkim fanom rocka.

Po ukończeniu tego samouczka możesz użyć czatbota, aby zamówić koszulki lub muzykę albo zapytać o swoje zamówienie.

Czego się nauczysz

Poznasz zalety Dialogflow CX w porównaniu z Dialogflow ES. Obejmuje ona te pojęcia:

• Jak utworzyć wirtualnego agenta Dialogflow CX w Google Cloud
• Dowiedz się, jak tworzyć przepływy
• Dowiedz się, jak tworzyć obiekty
• Dowiedz się, jak tworzyć intencje
• Dowiedz się, jak tworzyć strony i strony przejściowe za pomocą funkcji obsługi stanu.
• Dowiedz się, jak przechodzić między stronami za pomocą tras opartych na intencjach
• Dowiedz się, jak przechodzić między stronami z parametrami i trasami warunkowymi
• Dowiedz się, jak zwracać odpowiedzi warunkowe za pomocą funkcji systemowych
• Dowiedz się, jak tworzyć wiadomości zastępcze
• Dowiedz się, jak korzystać z symulatora
• Dowiedz się, jak tworzyć elementy testowania i określać pokrycie testami

Ostateczny projekt agenta Dialogflow CX będzie wyglądać tak:

Uwaga: w tym module będziemy tworzyć prawdziwego wirtualnego agenta. Pokażemy Ci projekt rozmowy (prototyp/schemat blokowy) drzewa dialogowego. Tego typu prototypy tworzą zwykle projektanci interfejsów konwersacyjnych. Opiera się na danych (analityka konwersacji, najczęstsze pytania). Prześlemy Ci też diagram UML, który pokazuje relacje między podmiotami (np. wykonawcami lub typami produktów). Zazwyczaj te informacje pochodzą z bazy danych, w której przechowujesz dane wejściowe użytkownika. Ten moduł rozpoczniesz od utworzenia części wielokrotnego użytku. (Przepływy, encje i intencje). Następnie skonfigurujesz przepływy, tworząc strony, przejścia i realizacje. Miłej zabawy!

Czego potrzebujesz

• Aby utworzyć agenta Dialogflow CX, musisz mieć tożsamość Google lub adres Gmail.
• Dostęp do Google Cloud.

Uwaga: każdy nowy klient Dialogflow CX otrzyma środki w wysokości 600 USD na bezpłatny okres próbny Dialogflow CX. Środki te są aktywowane automatycznie przy pierwszym użyciu Dialogflow CX i wygasają po 12 miesiącach. Jest to rozszerzenie bezpłatnego okresu próbnego Google Cloud, które dotyczy tylko Dialogflow. Więcej informacji o cenach znajdziesz w omówieniu cen.

2. Konfiguracja środowiska

Tworzenie projektu Google Cloud

Dialogflow CX działa w Google Cloud, więc musisz utworzyć projekt Google Cloud. Projekt porządkuje wszystkie zasoby Google Cloud. Składa się z zestawu współpracowników, włączonych interfejsów API (i innych zasobów), narzędzi do monitorowania, informacji o płatnościach oraz kontroli uwierzytelniania i dostępu.

Otwórz konsolę Google Cloud

Podczas tworzenia nowego projektu musisz wpisać nazwę projektu. Musisz połączyć je z istniejącym kontem rozliczeniowym i organizacją.

Konto rozliczeniowe określa, kto płaci za dany zestaw zasobów, i może być powiązane z co najmniej jednym projektem. Wykorzystanie projektu jest rozliczane na połączonym koncie rozliczeniowym. W większości przypadków płatności konfiguruje się podczas tworzenia projektu. Więcej informacji znajdziesz w dokumentacji dotyczącej rozliczeń. Sprawdź, czy w projekcie Cloud włączone są płatności.

Włączanie interfejsu Dialogflow API

Aby korzystać z Dialogflow, musisz włączyć interfejs Dialogflow API w swoim projekcie.

1. Włącz interfejs Dialogflow API
2. Wybierz projekt, w którym chcesz włączyć interfejs API, i kliknij Dalej.
3. Zwiń menu Interfejsy API i usługi i kliknij Utwórz dane logowania.
4. Kliknij Dane aplikacji.
5. Odpowiedz Nie, nie używam ich, ponieważ na razie nie korzystasz z Kubernetes Engine, App Engine ani Cloud Functions.
6. Kliknij przycisk Gotowe.

Tworzenie nowego agenta Dialogflow CX

Aby utworzyć nowego agenta Dialogflow CX, najpierw otwórz konsolę Dialogflow CX:

Konsola Dialogflow CX

1. Wybierz utworzony wcześniej projekt Google Cloud.
2. Kliknij Utwórz agenta.

Wypełnij formularz podstawowych ustawień agenta:

• Możesz wybrać dowolną wyświetlaną nazwę.
• Jako lokalizację wybierz us-central1.
• Wybierz preferowaną strefę czasową.
• Wybierz en – angielski jako język domyślny.

Uwaga: w Dialogflow CX możesz utworzyć kilka agentów w ramach jednego projektu. Podczas konfigurowania agenta w Dialogflow CX musisz wyraźnie powiązać go z lokalizacją.

Kliknij Utwórz.

Wszystko gotowe. Możemy wreszcie rozpocząć modelowanie agenta wirtualnego.

3. Przepływy

Złożone dialogi często obejmują wiele tematów rozmowy. W przypadku czatbota, który tworzymy dla G-Records do sprzedaży gadżetów zespołu, będziemy mieć dialogi dotyczące katalogu produktów, płatności, stanu zamówienia i pytań związanych z obsługą klienta. Możemy podzielić te tematy rozmowy na ścieżki.

Przepływy umożliwiają zespołom pracę nad poszczególnymi ścieżkami rozmowy. Warto uprościć proces, aby łatwo mieścił się na ekranie i był bardziej modułowy.

Przepływy to nowa koncepcja w Dialogflow CX. Dialogflow Essentials ma koncepcję Mega Agentów, którzy są w pewien sposób podobni do przepływów. Jednak z Flows będziesz korzystać znacznie częściej.

W dalszej części tego laboratorium użyjemy procedur obsługi stanu, które mogą zakończyć przepływ (dzięki czemu nastąpi powrót do następnego lub poprzedniego przepływu), lub możesz zakończyć całą sesję agenta.

Zacznijmy tworzyć przepływy.

Tworzenie przepływów

1. W Dialogflow CX kliknij ikonę + > Utwórz przepływ.
2. Wpisz nazwę: Catalog i naciśnij Enter.

Twój pierwszy przepływ Katalog został utworzony. Teraz utwórz pozostałe przepływy:

• Order Process
• My Order
• Customer Care

W dalszej części tego modułu skonfigurujemy moduły obsługi stanu strony, dzięki czemu wizualizacja będzie wyglądać tak:

Symulator

Po prawej stronie konsoli Dialogflow CX możesz przetestować wirtualnego agenta za pomocą wbudowanego symulatora. Możesz przetestować rozmowę od początku lub od konkretnego przepływu.

1. W prawym górnym rogu ekranu kliknij przycisk Test Agent (Testuj agenta).
2. W polu „Porozmawiaj z agentem” wpisz: Hello Wirtualny agent odpowie domyślnym tekstem powitalnym: Dzień dobry! W czym mogę pomóc?

Zmodyfikujmy ten domyślny tekst powitalny.

Domyślny proces rozpoczęcia

Zacznijmy od utworzenia trasy intencji, która zostanie uruchomiona po powitaniu wirtualnego agenta.

1. Na pasku bocznym po lewej stronie Tworzenie > Przepływy kliknij Domyślny przepływ początkowy i wybierz węzeł drzewa Start.

Otworzy się strona Start. Automatycznie wybrana została strona Start w sekcji paska bocznego Tworzenie > Strony.

2. W sekcji Start > Routes (Rozpocznij > Trasy) kliknij Default Welcome Intent (Domyślna intencja powitalna).

Intencja określa zamiar użytkownika w jednej turze rozmowy. W Dialogflow CX intencje mogą być częścią modułu obsługi stanu, który kieruje do następnej aktywnej strony lub realizacji.

3. Usuń wszystkie wpisy Odpowiedź agenta i dodaj ten nowy tekst:

Welcome, I am the virtual agent of G-Records, a fictional rock label. You can order artists merchandise, ask questions about your order or shipping, and I can tell you more which artists are currently signed with us. How can I help?

Aby usprawnić rozmowę, potrzebujemy też przycisków szybkiej odpowiedzi lub sugestii.

4. Kliknij Add dialogue option > Custom payload (Dodaj opcję dialogu > Niestandardowy ładunek) i użyj poniższego fragmentu kodu.
5. Użyj poniższego fragmentu kodu jako niestandardowego ładunku i kliknij Zapisz.

Więcej informacji o niestandardowych ładunkach znajdziesz w dokumentacji.

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "Which artists?"
            },
            {
              "text": "Which products?"
            },
            {
              "text": "About my order..."
            }
          ]
        }
      ]
    ]
  }

5. Przetestuj intencję powitalną w symulatorze.

Pewnie zastanawiasz się, dlaczego nie widzisz żadnych treści multimedialnych. Dzieje się tak, ponieważ szczegółowe treści, takie jak sugestie, zależą od integracji. Poniższe kroki wymagają konta rozliczeniowego, ale możesz je pominąć, jeśli go nie masz.

6. Na pasku bocznym po lewej stronie kliknij Zarządzaj > Integracje.
7. Wybierz Dialogflow Messenger i kliknij Połącz.
8. W wyskakującym okienku kliknij Włącz.

Pojawi się kolejne okienko, tym razem z kodem JavaScript do integracji, który możesz wkleić w swojej witrynie, aby zintegrować z nią komponent Dialogflow Messenger. Nie mamy jeszcze witryny, więc przetestujemy wirtualnego agenta bezpośrednio w narzędziu.

9. Kliknij link Wypróbuj.
10. Kliknij ikonę chatbota w prawym dolnym rogu, aby otworzyć okno czatu. Aby rozpocząć rozmowę, wpisz Hello.

Obecnie, gdy klikniesz sugestie, agent wirtualny nie zrozumie, co masz na myśli. Dzieje się tak, ponieważ nasz wirtualny agent nie przełącza się jeszcze między stanami. Możemy to zrobić w Dialogflow CX za pomocą stron. Kontynuujmy moduł. Najpierw utworzymy jednostki i intencje.

4. Typy encji

Typy encji służą do kontrolowania sposobu wyodrębniania danych z danych wejściowych użytkownika. Typy encji Dialogflow CX są bardzo podobne do typów encji Dialogflow ES. Dialogflow udostępnia wstępnie zdefiniowane encje systemowe, które mogą dopasowywać wiele typowych rodzajów danych. Istnieją na przykład encje systemowe do dopasowywania dat, godzin, kolorów, adresów e-mail itp. Możesz też tworzyć własne obiekty niestandardowe, aby dopasowywać dane niestandardowe.

Zacznijmy od przygotowania wszystkich niestandardowych elementów, zanim zaprojektujemy strony w przepływie. Utworzymy te jednostki:

Tworzenie jednostek

Utwórzmy podmiot Wykonawca.

1. Kliknij Zarządzaj > Typy jednostek.
2. Kliknij + Utwórz.

• Wyświetlana nazwa: Artist
• Podmioty:
• The Google Dolls (synonim: Google Dolls)
• The Goo Fighters (synonim: Goo Fighters)
• G's N' Roses (synonim: Gs and Roses)
• Alice Googler
• Kliknij Opcje zaawansowane i zaznacz Dopasowywanie rozmyte. (Jeśli wpiszesz nazwę zespołu z błędem, może ona nadal pasować do właściwego podmiotu).
• W sekcji Opcje zaawansowane zaznacz też Redaguj w logu. (Jeśli wpiszesz nazwę zespołu z błędem, zostanie ona poprawiona w logu).

3. Kliknij Zapisz.

Potrzebujemy też elementu dla produktu:

4. Kliknij Zarządzaj > Typy jednostek.
5. Kliknij + Utwórz.

• Wyświetlana nazwa: Merch
• Podmioty:
• T-shirt
• Longsleeve (synonim: Longsleeve shirt)
• Tour Movie
• Digital Album (z synonimem: MP3 Album, MP3)
• CD (synonimy: Disc, Physical CD)

6. Kliknij Zapisz.

Potrzebny będzie też podmiot dla albumu:

7. Kliknij Zarządzaj > Typy jednostek.
8. Kliknij + Utwórz.

• Wyświetlana nazwa: Album
• Podmioty:
• Live
• Greatest Hits (synonim: Hits)

9. Kliknij Zapisz.

Będziemy też potrzebować jednostki dla rozmiarów odzieży:

10. Kliknij Zarządzaj > Typy jednostek.
11. Kliknij + Utwórz.

• Wyświetlana nazwa: ShirtSize
• Podmioty:
• XS (synonim: Extra Small)
• S (synonim: Small)
• M (synonim: Medium)
• L (synonim: Large)
• XL (synonim: Extra Large)
• 2XL (synonim: Extra Extra Large)
• 3XL

12. Kliknij Zapisz.

oraz jednostkę dla numerów zamówień, które zwykle składają się z 4 znaków alfanumerycznych i 3 cyfr. (np. ABCD123)

13. Kliknij Zarządzaj > Typy jednostek.
14. Kliknij + Utwórz.

• Wyświetlana nazwa: OrderNumber
• Encje wyrażeń regularnych
• Jednostka: [A-Z]{4}[0-9]{3}

15. Kliknij Zapisz.

Konfiguracja jednostki powinna wyglądać podobnie do tej poniżej:

@Wykonawca:

@Merch:

@Album:

@ShirtSize:

@OrderNumber:

Po przygotowaniu encji niestandardowych możemy przygotować intencje. Kontynuujmy moduł.

5. Intencje

Intencja określa zamiar użytkownika w ramach jednej tury rozmowy. W Dialogflow CX zostały one znacznie uproszczone i nie są już elementem składowym sterowania rozmową. Dialogflow CX używa intencji tylko do dopasowywania wypowiedzi użytkowników. W Dialogflow ES wszystko musiało być powiązane z intencją (parametry, zdarzenia, realizacja itp.). Intencje w Dialogflow CX zawierają tylko frazy treningowe, dlatego można ich używać wielokrotnie. Nie kontroluje już rozmowy. Proces tworzenia intencji będzie prosty:

W wypowiedziach szkoleniowych w intencjach można używać encji do wyodrębniania „zmiennych” danych wejściowych. Dlatego warto z wyprzedzeniem tworzyć typy encji, co zrobiliśmy na poprzedniej stronie instrukcji.

Tworzenie intencji

Zacznijmy od przygotowania wszystkich intencji, zanim zaprojektujemy strony w procesie.

1. Kliknij Zarządzaj > Intencje.
2. Kliknij + Utwórz.

Użyj tych informacji:

• Wyświetlana nazwa redirect.artists.overview
• Tekst reklamy Artists overview: The bands supported by the label

Uwaga: zalecamy stosowanie następującej konwencji nazewnictwa stron i intencji: wszystkie znaki pisane małymi literami, zamiast spacji używaj kropek (.). Intencje używają tych prefiksów: redirect w przypadku intencji, które używają NLU do pobierania strony, confirm/decline w przypadku intencji, które potwierdzają lub odrzucają wybory (frazy szkoleniowe „tak” lub „nie”), oraz supp w przypadku pytań dodatkowych, które mogą pojawić się w dowolnym momencie procesu.

Przewiń w dół i utwórz te frazy treningowe:

• Which bands are signed?
• Which bands
• Which artists
• Which artists are part of the record label
• Who is part of the label
• From which bands can I buy merchandise
• Band merchandise
• Which music do you have?
• I would like to know who are signed to the label
• Who are supported by the label
• From who can I buy shirts
• What music can I order
• Can I get an overview of all the artists

4. Kliknij Zapisz.

Uwaga: intencje można też tworzyć bezpośrednio na stronie w sekcji Trasy.

5. Teraz utwórzmy pozostałe intencje. Użyj własnej wyobraźni, aby wymyślić więcej fraz treningowych. Zalecamy, aby każdy zamiar miał co najmniej 10 fraz treningowych, które obejmują różne sposoby wywoływania tego zamiaru przez użytkownika. Na potrzeby tego modułu mniejsza liczba też powinna wystarczyć.

Kilka rzeczy, na które warto zwrócić uwagę:

• Pamiętaj, że podczas wpisywania frazy treningowej Dialogflow CX automatycznie dodaje adnotacje do encji. Jeśli tak się nie stanie, być może musisz zaktualizować encję (dodając synonim) lub ręcznie dodać adnotacje do frazy treningowej.
• Krótsze frazy treningowe: system NLU Dialogflow może też działać z krótszymi frazami treningowymi. Podajemy tu kilka przykładów.
• Przetrenowanie: zbyt duża liczba wyrażeń treningowych dla intencji może spowodować przetrenowanie i mniej pożądany wynik. Sprawdzoną metodą jest stosowanie testów iteracyjnych i przyrostowych oraz dodawanie wyrażeń na potrzeby trenowania w przypadku, gdy nie ma dopasowanego zamiaru.

Wyświetlana nazwa	Przykłady wypowiedzi
redirect.product.overview	"Which products do you sell?", "What merchandise items do you have?", "What are you selling?", "What are the items?", "Which products?" "What merchandise?", "Please tell me what you have"
confirm.artists.overview	"Yeah, let me buy merchandise", "Yes, I want to purchase something", "Yes, I would like to order merchandise from Alice Googler" (Uwaga: Alice Googler powinna być rozpoznawana jako @Artist!), "Ok, let's buy stuff."
redirect.price	"How much does a t-shirt cost?", "What's the price for the tour movie?", "The album is how much?", "I want to know the price of a longsleeve shirt", "What's the price difference?", "What does each product costs?", "What does it cost?", "What is the price?"
redirect.product	"Tour movie", "I am interested in a t-shirt", "Can I buy a digital album?", "I want the CD", "I want to buy something", "Can I purchase a record?", "I want to buy a t-shirt size M of The Google Dolls", "Can I purchase the Alice Googler digital album?"
redirect.product.of.artist	"Yeah, let's shop", "Give me merch of Alice Googler", "Shirts of The Google Dolls that would be nice.", "Yes", "I want The Goo Fighters stuff", "Yes, I want to order merchandise", "Yep, give me items of G's N' Roses", "Go for it", "Anything Alice Googler", "I am a G's N' Roses fan!", "Google Dolls", "Yes of The Google Dolls"
redirect.shirts	"Shirts", "I want to buy shirts", "I am interested in shirts", "I want a shirt", "Shirts of G's N' Roses please", "Give me shirts of the Google Dolls", "I want to buy shirts of Alice Googler"
redirect.music	"Music", "I want to buy music", "I am interested in music", "Give me music of the Goo Fighters", "Music of Goo Fighters please", "Interested in buying the Alice Googler album", "Purchase Alice Googler music"
redirect.album	"Hits", "Live Album", "I want the Greatest Hits Digital Album", "Give me the Greatest Hits CD", "Hits on MP3"
redirect.shirt.size	"XS", "I have M", "I want Large", "My size is 3XL", "Extra Large is the size"
redirect.my.order	"About my order", "I have a question about my order", "My order is ABCD123, I have a question about my order."
status	redirect.my.order.status
redirect.my.order.canceled	"I want to cancel my order", "I want to cancel order ABCD123", "Please cancel order ABCD123", "Undo my order", "Stop my order", "Cancel"
redirect.shipping.info	"How long will it take?", "How long is shipping?", "How long does shipping take?", "When will I receive it?"
redirect.refund.info	"I want a refund.", "Can I get a refund", "I want to return the CD", "I want to return my t-shirt"
redirect.swapping.info	"I want to swap my item", "Can I change my t-shirt for a larger size?", "Can I change my product?", "I want to swap the CD"
redirect.order.process	"I want to buy a t-shirt of the Google Dolls, size S", "Let me buy the digital CD of Alice Googler", "Get me the tour movie of G's N' Roses", "Buy a longsleeve shirt of The Goo Fighters", "Purchase the Alice Googler t-shirt", "Please order me the Google Dolls CD"
confirm.proceed.order	"Yes", "Yes, please continue", "Yes order", "I want to order", "Yeah", "Yep", "I confirm", "Agree", "Go ahead", "Order", "Buy it", "Purchase", "Okay"
decline.proceed.order	"No", "I rather not", "I don't want it anymore", "Don't order", "Stop", "Not anymore", "Nope", "Go back", "Reset", "Decline", "I don't need it"
redirect.home	"Go back", "Home", "Help", "What else can I ask", "Restart", "Can you tell me what I can order?", "What questions can I ask", "I need help", "Advice please", "Hi", "Hello", "Good day!"
redirect.end	"No that's it, goodbye", "Bye", "Cheers", "End", "That's it", "No more questions", "Exit", "Have a good day", "End Call", "Close"

Gdy mamy już przygotowane elementy wielokrotnego użytku (ścieżki, elementy i intencje), możemy je połączyć, tworząc strony i procedury obsługi stanu.

6. Strony i procedury obsługi stanu

Rozmowę w Dialogflow CX (sesję) można opisać i wizualizować jako automat skończony. Weźmy na przykład automat do sprzedaży. Można go modelować jako automat skończony. Ma ona te stany: Oczekiwanie na monety, Wybierz cukierka, Daj cukierka. Po otrzymaniu zestawu danych wejściowych przechodzi między tymi stanami. Na przykład wrzucenie monety powoduje przejście automatu z trybu „Oczekiwanie na monety” do trybu „Wybierz słodycze”. Strony to sposób, w jaki możemy modelować te stany wirtualnego agenta Dialogflow CX.

Gdy użytkownik wchodzi w interakcję z Dialogflow CX w ramach rozmowy, rozmowa przechodzi z jednej strony na drugą. W każdym momencie dokładnie jedna strona jest stroną bieżącą, która jest uważana za aktywną. Aktywny jest też przepływ powiązany z tą stroną.

W przypadku każdego przepływu możesz zdefiniować wiele stron, na których połączone strony mogą prowadzić pełną rozmowę na tematy, do których jest przeznaczony przepływ. Każdy proces ma specjalną stronę początkową. Gdy przepływ staje się aktywny, strona początkowa staje się stroną bieżącą. Po każdej turze rozmowy bieżąca strona pozostanie bez zmian lub przejdzie do innej strony. Ta koncepcja umożliwi Ci tworzenie większych agentów z wieloma stronami i wieloma turami rozmowy.

Strony zawierają realizacje (statyczne okna dialogowe lub wywołania zwrotne), parametry i procedury obsługi stanu. Sterowanie rozmową odbywa się za pomocą modułów obsługi stanu, co umożliwia tworzenie różnych tras przejścia do innej strony Dialogflow CX, w tym warunkowych (do rozgałęziania rozmów).

Stan rozmowy jest kontrolowany przez obsługę przejść między stronami za pomocą 3 rodzajów ścieżek:

• Trasy intencji: kiedy należy dopasować intencję (np. zmienić stronę na podstawie tego, co mówi użytkownik). (Niebieskie linie na schemacie).
• Ścieżki warunkowe: gdy należy sprawdzić warunek (np. zmienić stronę na podstawie określonych parametrów przechowywanych w sesji) (pomarańczowe linie na diagramie).
• Moduły obsługi zdarzeń: kiedy należy obsłużyć określone zdarzenie rezerwowe (np. brak danych wejściowych lub brak dopasowania, aby odróżnić użytkownika od ścieżki intencji lub warunku) (zielone linie na diagramie).

Wypowiedzi w rozmowie (czyli treść lub odpowiedź dla użytkownika) są definiowane przez realizację, która może być statyczna lub dynamiczna:

• Statyczne spełnienie: gdy zostanie podana statyczna odpowiedź spełniająca wymagania.
• Dynamiczne realizowanie: gdy wywoływany jest webhook realizacji w przypadku odpowiedzi dynamicznych.

W przypadku bota do obsługi sprzedaży detalicznej utworzymy trasy intencji i udostępnimy statyczne odpowiedzi dotyczące realizacji, które będą wyświetlane użytkownikowi natychmiast po aktywowaniu strony. Później utworzymy parametry z ścieżkami warunkowymi, aby zebrać informacje potrzebne do złożenia zamówienia na produkty.

Uwaga: w poprzednich krokach utworzyliśmy zwykłe intencje. Dialogflow CX umożliwia też tworzenie grup tras. Grupy ścieżek są przydatne, gdy tworzysz wirtualnego agenta, który ma wiele stron ze wspólnym zestawem ścieżek intencji, zdarzeń lub warunkowych. Aby trasy były wielokrotnego użytku, możesz zdefiniować grupy tras (patrz karta Zarządzaj), czyli zasób dla całego przepływu. Możesz dołączyć grupę tras do ścieżki lub strony. Trasy w tych grupach mogą być wywoływane, gdy strona jest aktywna.

Trasy intencji na stronie

Tworzenie stron w domyślnym przepływie startowym

Oto schemat domyślnego przepływu rozpoczęcia:

Kliknijmy to razem:

1. Kliknij Build > Default Start Flow (Tworzenie > Domyślny przepływ początkowy).
2. Kliknij Strona startowa.
3. Kliknij ikonę + obok pozycji Trasy.
4. Dodaj redirect.artists.overview
5. Przewiń w dół do sekcji Przejście i przejdź do procesu Katalog.
6. Kliknij Zapisz.
7. Powtórz powyższe kroki w przypadku wiersza redirect.product.overview i pozostałych 11 wierszy z tej tabeli:

Strona (w przepływie)	Trasy > Intencja	Trasy > Przejście do
Rozpocznij	Default Welcome Intent	-
Rozpocznij	redirect.artists.overview	Flow: Katalog
Rozpocznij	redirect.product.overview	Flow: Katalog
Rozpocznij	redirect.shirts	Flow: Katalog
Rozpocznij	redirect.music	Flow: Katalog
Rozpocznij	redirect.product	Flow: Katalog
Rozpocznij	redirect.product.of.artist	Flow: Katalog
Rozpocznij	redirect.refund.info	Flow: Customer Care
Rozpocznij	redirect.shipping.info	Flow: Customer Care
Rozpocznij	redirect.swapping.info	Flow: Customer Care
Rozpocznij	redirect.my.order	Flow: Moje zamówienie
Rozpocznij	redirect.my.order.canceled	Flow: Moje zamówienie
Rozpocznij	redirect.my.order.status	Flow: Moje zamówienie
Rozpocznij	redirect.end	Strona: Zakończ sesję

Domyślny przepływ rozpoczynania będzie działać jak menu opcji podczas dzwonienia do centrum obsługi telefonicznej. W tym przypadku wirtualny agent jest jednak trenowany za pomocą języka naturalnego, a frazy treningowe znajdują się w intencjach. Dlatego interakcja jest oparta na rozmowie, a nie na opcjach DTMF, i jest bardziej naturalna i przypominająca rozmowę z człowiekiem.

Uwaga: możesz zauważyć 2 opcje przejścia strony: Zakończ sesję i Zakończ ścieżkę. Zakończ sesję zamyka całą sesję czatu (rozmowę na czacie lub połączenie), a Zakończ przepływ zamyka przepływ i wraca do ostatniego aktywnego przepływu. To ważne pojęcie w Dialogflow CX. Gdy chcesz przejść do innego miejsca, musisz „zamknąć” swoje przepływy, w przeciwnym razie możesz skończyć w zagnieżdżonej rozmowie. Domyślnie Dialogflow CX będzie próbować trzymać się przebiegu rozmowy, dopóki nie dojdzie do jej końca. Jeśli podczas rozmowy przejdziesz do innego procesu, będzie on kontynuowany do końca, a potem nastąpi powrót do ostatniego odwiedzonego procesu i jego kontynuacja do końca. I tak dalej, aż rozmowa na czacie zostanie zakończona za pomocą opcji „Zakończ sesję”. Umożliwia to tworzenie złożonych rozmów z odstępstwami.

Tworzenie stron w przepływie katalogu

Poniższy zapis rozmowy na czacie należy do ścieżki Katalog:

> "Hi"
"Welcome, I am the virtual agent of G-Records, a fictional rock label.
You can order artists merchandise, ask questions about your order or shipping,
and I can tell you more which artists are currently signed with us. How can I help?"
> "Which bands are signed with this record label?"
"The following bands are signed with G-Records:
Alice Googler, G's N' Roses, The Goo Fighters and The Google Dolls.

From which of these artists would you like to order merchandise?"
> "Alice Googler"
"You want to rock with Alice Googler merchandise. Awesome!

We sell shirts, music or the tour movie.

Which merchandise item do you want?"
"(Suggestion chips: [Shirts] [Music] [Tour Movie])"
> "I would like to buy a Shirt"
"Do you want a longsleeve or a t-shirt?"
"(Suggestion chips: [T-shirt, Longsleeve, Price?])"
> "What's the price difference?"
"A t-shirt costs $25 and a longsleeve costs $30.

Do you want a longsleeve or a t-shirt?"
> "A t-shirt",
"What shirt size do you want?"
"(Suggestion chips: [XS, S, M, L, XL, 2XL, 3XL])"
> "M"
"A T-shirt of Alice Googler size: M costs $25. Shall I continue to order?"

Gdy wybierzesz Muzyka lub Film z wycieczki, okno dialogowe będzie wyglądać inaczej:

 > "Music"
"We have a Greatest Hits Album or the Live Album. Which one do you want?"
"(Suggestion chips: [Greatest Hits, Live, Price?])"
> "The Live Album"
"Do you want this album on CD or MP3?"
"(Suggestion chips: [CD, MP3])"
> "What's the price difference?"
"A CD costs $15. The digital album on MP3 costs $10.
Do you want this album on CD or MP3?"
> "Digital Album",
"The Digital Album: Alice Googler - Live costs $10. Shall I continue to order?"

W przypadku filmu z wycieczki dialog będzie wyglądał tak:

 > "Tour Movie"
"The Tour Movie of G's N' Roses costs $25. Shall I continue to order?

Oto schemat blokowy wszystkich stron w przepływie Katalog:

Zwróć uwagę na złożoność tego procesu:

• Mogę pominąć pytanie o artystów i od razu zapytać „Jakie produkty są dostępne?”.
• W przypadku domyślnego przepływu początkowego mogę zapytać: „Chcę kupić koszulkę The Google Dolls” lub „Chcę coś kupić”. Oznacza to, że wirtualny agent zada pytania uzupełniające, aby wypełnić miejsca na te wymagane parametry. Przeniesie Cię bezpośrednio na stronę produktu.
• Okno dialogowe Ceny pochodzi ze strony Ceny, która zostanie ponownie użyta.
• Chociaż okno filmu z wycieczką wygląda na najprostsze, zrobimy z nim coś specjalnego. Ponownie wykorzystamy tę część dialogu, aby użytkownicy mogli też wpisać ją bezpośrednio w przypadku jednego z innych produktów, jeśli od razu podadzą wszystkie informacje:

 > "I want The Goo Fighters longsleeve size S."
"The longsleeve of The Goo Fighters size S costs $30. Shall I continue to order?"

Uwaga: ten przypadek użycia pokazuje, jak potężne jest narzędzie Dialogflow CX. Oczywiście możesz tworzyć agentów handlowych za pomocą Dialogflow ES, ale nie możesz ponownie używać intencji, a utrzymywanie kontekstu i parametrów jest ograniczone, więc musisz rozwiązać ten problem, ręcznie kodując realizacje backendu (co wymaga deweloperów). W Dialogflow CX architekt rozmów może modelować te złożone przepływy jako automat stanowy i ponownie wykorzystywać elementy projektu, takie jak intencje.

Zacznijmy od połączenia stron.

1. Kliknij Build > Catalog (Tworzenie > Katalog).
2. Kliknij Strona startowa.
3. Kliknij ikonę + obok pozycji Trasy.
4. Dodaj redirect.artists.overview
5. Przewiń w dół do sekcji Przejście, kliknij Strona i wybierz + nowa strona.
6. Użyj nazwy strony: Artist Overview i kliknij Zapisz.

Teraz dokończmy resztę procesu:

7. Poprzednie kroki można powtórzyć w przypadku tych stron, intencji i realizacji. Zająć ten stół. Strona to strona, którą wybierzesz w procesie Ścieżki > Przejście do to nowy proces lub strona, którą utworzysz i do której przejdziesz.

Strona (w przepływie)	Trasy > Intencja	Trasy > Przejście do
Początek katalogu	redirect.artists.overview	Informacje o wykonawcy
Początek katalogu	redirect.product	Produkt
Początek katalogu	redirect.product.overview	Omówienie produktu
Początek katalogu	redirect.product.of.artist	Omówienie produktu
Początek katalogu	redirect.shirts	Koszule
Początek katalogu	redirect.music	Muzyka
Początek katalogu	redirect.end	Zakończ sesję
Początek katalogu	redirect.home	Zakończ proces
Informacje o wykonawcy	redirect.product.of.artist	Omówienie produktu

Teraz dodajmy więcej statycznych realizacji.

12. W przepływie Katalog kliknij stronę Przegląd wykonawcy.
13. W sekcji Realizacja zgłoszenia kliknij Edytuj realizację.
14. Użyj tych statycznych odpowiedzi (Agent mówi):

• The following bands are signed with G-Records: Alice Googler, G's N' Roses, The Goo Fighters and The Google Dolls.

15. Kliknij Zapisz.
16. W przepływie Katalog kliknij stronę Przegląd produktów.
17. W sekcji Realizacja zgłoszenia kliknij Edytuj realizację.
18. Użyj tego statycznego sposobu realizacji (Agent mówi):

• We sell shirts, music or the tour movie.

19. Kliknij Zapisz.

Parametry strony

Parametry służą do rejestrowania i odwoływania się do wartości podanych przez użytkownika podczas sesji. Każdy parametr ma nazwę i typ encji. @Artist i @Merch to minimalne parametry, które musimy zebrać, aby złożyć zamówienie na produkty. W przypadku koszulek T-shirt i koszulek z długim rękawem musisz też zebrać @ShirtSize, a jeśli chcesz zamówić muzykę, potrzebujesz też nazwy @Carrier i @Album.

Te parametry należy oznaczyć jako wymagane. Gdy będzie to wymagane, warto podać niestandardowe prompty, aby zapamiętać użytkownika końcowego i udzielić prawidłowych odpowiedzi, dzięki czemu będzie można zebrać te parametry. Dialogflow CX udostępnia kilka mechanizmów, które mogą Ci w tym pomóc.

Możesz na przykład podać niestandardowe statyczne komunikaty dotyczące realizacji zamówienia w sekcji Parametr. Jeśli parametr jest wymagany, wyświetlą się te spełnienia parametru. Te wiadomości z odpowiedzią zostaną dodane do kolejki odpowiedzi. Podczas tury agenta można (a czasami nawet warto) wywołać wiele realizacji, z których każda może wygenerować wiadomość z odpowiedzią. Dialogflow przechowuje te odpowiedzi w kolejce odpowiedzi. Więcej informacji o cyklu życia strony i kolejności dodawania tych realizacji do kolejki odpowiedzi znajdziesz w dokumentacji stron Dialogflow CX.

Tworzenie parametrów na stronie Przegląd wykonawcy

Zdefiniujmy kilka parametrów strony:

1. W przepływie Katalog kliknij stronę Informacje o wykonawcy.
2. W bloku Parametry kliknij +. Dodaj parametr artist:

• Wyświetlana nazwa: artist
• Typ podmiotu: @Artist
• Wymagane: sprawdź
• Usuń z logu: zaznacz

3. Teraz dodamy kilka wiadomości dotyczących realizacji parametrów niestandardowych. Jeśli parametr artist nie został jeszcze zebrany przez wirtualnego agenta, użytkownik otrzyma tę odpowiedź agenta dodaną do kolejki odpowiedzi:

From which of these artists would you like to order merchandise?

4. Dodaj drugą opcję dialogu, która zawiera elementy z sugestiami. Kliknij Dodaj opcję dialogu i użyj tego kodu (w formacie JSON):

{
  "richContent": [
    [
      {
        "options": [
          {
            "text": "The Google Dolls"
          },
          {
            "text": "The Goo Fighters"
          },
          {
            "text": "Alice Googler"
          },
          {
            "text": "G's N' Roses"
          }
        ],
        "type": "chips"
      }
    ]
  ]
}

Możesz obsługiwać różne komunikaty zastępcze w zależności od liczby prób udzielenia odpowiedzi przez użytkownika. Możesz to zrobić za pomocą funkcji obsługi zdarzeń parametrów. Możesz wybrać różne wbudowane moduły obsługi zdarzeń, takie jak Nieprawidłowe parametry, Zbyt długie wypowiedzi, Brak danych wejściowych, Brak danych wejściowych za pierwszym razem, Druga próba lub Brak dopasowania. Różnica między brakiem danych wejściowych a brakiem dopasowania polega na tym, że w przypadku braku danych wejściowych użytkownik nigdy nie podał odpowiedzi, a w przypadku braku dopasowania użytkownik podał odpowiedź, ale Dialogflow CX nie mógł dopasować intencji do strony.

5. Przewiń w dół do sekcji Moduły obsługi zdarzeń ponownego wyświetlania.
6. Kliknij Dodaj procedurę obsługi zdarzeń i wybierz zdarzenie: No-match default
7. Użyj tego statycznego tekstu zdarzenia:

I missed that. Please, specify the artist. You can choose between: Alice Googler, G's N' Roses, The Google Dolls or The Goo Fighters. Which artist do you want to buy merchandise from?

8. Kliknij Zapisz.
9. Kliknij Dodaj procedurę obsługi zdarzeń i wybierz zdarzenie: No-input default
10. Użyj tego statycznego tekstu zdarzenia:

I am sorry, I could understand the artist's name. You can choose between Alice Googler, G's N' Roses, The Google Dolls or The Goo Fighters. Which artist do you want to buy merchandise from?

11. Kliknij Zapisz.

Trasy warunkowe strony

Parametry są bardzo przydatne w połączeniu z trasami warunkowymi stron. Gdy warunek przyjmie wartość true, zostanie wywołana powiązana z nim ścieżka strony. Warunek może brzmieć np. Parametr jest równy określonej wartości, Parametr nie może być pominięty lub Formularz został wypełniony. Więcej informacji o parametrach i warunkach znajdziesz w dokumentacji Dialogflow CX.

W przypadku wirtualnego agenta w branży handlowej musimy zebrać sekwencję parametrów, dlatego musimy utworzyć warunek, aby sprawdzić, czy „formularz” został wypełniony. Formularz to lista parametrów, które powinny być zbierane od użytkownika na stronie. Wirtualny agent prowadzi z użytkownikiem wiele rozmów, aż zbierze wszystkie wymagane parametry formularza, zwane też parametrami strony.

Dialogflow CX automatycznie ustawia wartości parametrów podane przez użytkownika podczas wypełniania formularza. Aby sprawdzić, czy cały formularz na bieżącej stronie jest wypełniony, użyj tego warunku: $page.params.status = "FINAL"

Tworzenie tras warunkowych na stronie Przegląd wykonawcy

Utwórzmy trasę warunkową, która przejdzie do następnej strony, gdy wykonawca będzie znany:

1. Na stronie Przegląd wykonawcy kliknij ikonę + w sekcji Trasy.
2. Przewiń w dół do sekcji Stan.
3. Wybierz Co najmniej jeden (LUB)
4. Następnie napiszemy wyrażenie, które

• Parametr: $page.params.status
• Operator: =
• Wartość: "FINAL"

4. Teraz utworzymy na trasie konkretną statyczną wiadomość o realizacji, która potwierdzi wybór użytkownika. Przewiń w dół do bloku Realizacja i wpisz te wiadomości dotyczące realizacji:

• $session.params.artist, great choice! Rock on!
• You want to rock with $session.params.artist merchandise. Awesome!

5. Gdy warunek jest spełniony, należy przejść na stronę Przegląd produktu. Przewiń w dół do sekcji Przejście i skorzystaj z tej strony: Product Overview
6. Kliknij Zapisz.

Tworzenie tras na stronie Przegląd usługi

Wiesz już, jak tworzyć parametry i trasy warunkowe, więc teraz utwórzmy więcej parametrów dla tych stron:

Omówienie produktu

1. Utwórz parametr artist na stronie Przegląd produktów:

• Wyświetlana nazwa: artist
• Typ podmiotu: @Artist
• Wymagane: sprawdź
• Usuń z logu: zaznacz
• Wypełnienie początkowego prompta: From which of these artists would you like to order merchandise?

{
  "richContent": [
    [
      {
        "options": [
          {
            "text": "The Google Dolls"
          },
          {
            "text": "The Goo Fighters"
          },
          {
            "text": "Alice Googler"
          },
          {
            "text": "G's N' Roses"
          }
        ],
        "type": "chips"
      }
    ]
  ]
}

• Moduł obsługi zdarzeń > No-match default: To buy merchandise you can choose between the following artists: Alice Googler, G's N' Roses, The Google Dolls or The Goo Fighters. Which artist do you want to buy merchandise from?
• Niestandardowy ładunek:

{
  "richContent": [
    [
      {
        "options": [
          {
            "text": "The Google Dolls"
          },
          {
            "text": "The Goo Fighters"
          },
          {
            "text": "Alice Googler"
          },
          {
            "text": "G's N' Roses"
          }
        ],
        "type": "chips"
      }
    ]
  ]
}

• Moduł obsługi zdarzeń > No-input default: To buy merchandise you can choose between the following artists: Alice Googler, G's N' Roses, The Google Dolls or The Goo Fighters. Which artist were you trying to mention?
• Niestandardowy ładunek:

{
  "richContent": [
    [
      {
        "options": [
          {
            "text": "The Google Dolls"
          },
          {
            "text": "The Goo Fighters"
          },
          {
            "text": "Alice Googler"
          },
          {
            "text": "G's N' Roses"
          }
        ],
        "type": "chips"
      }
    ]
  ]
}

2. Utwórz parametr merch:

• Wyświetlana nazwa: merch
• Typ podmiotu: @Merch
• Wymagane: sprawdź
• Usuń z logu: zaznacz
• Realizacja: Which merchandise item do you want?
• Kliknij Dodaj opcję dialogu > Niestandardowy ładunek:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "Shirts"
            },
            {
              "text": "Music"
            },
            {
              "text": "Tour movie"
            }
          ]
        }
      ]
    ]
  }

• Moduł obsługi zdarzeń > No-match default
• Realizacja modułu obsługi zdarzeń: We sell Shirts, Music or the Tour movie. Which of these items do you want?
• Niestandardowy ładunek:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "Shirts"
            },
            {
              "text": "Music"
            },
            {
              "text": "Tour movie"
            }
          ]
        }
      ]
    ]
  }

• Moduł obsługi zdarzeń > No-input default
• Realizacja modułu obsługi zdarzeń: I couldn't understand which merchandise item you wanted to buy. You can choose between: Shirts, Music or the Tour movie. Which item do you want?
• Niestandardowy ładunek:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "Shirts"
            },
            {
              "text": "Music"
            },
            {
              "text": "Tour movie"
            }
          ]
        }
      ]
    ]
  }

3. Utwórz trasę, która będzie przechodzić na stronę Produkt, gdy podany jest parametr artist i element merch.

• Warunek:
• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $session.params.artist != null
• Wyrażenie: $session.params.merch != null
• Realizacja: Alright! $session.params.merch of $session.params.artist, let's go!
• Przejście: strona: Product

Uwaga: tym razem pobieramy parametry z sesji, a nie ze strony. Może to być spowodowane tym, że te parametry zostały podane na innej stronie. W naszym przypadku nazwa wykonawcy została wspomniana w poprzedniej kolejce.

4. Utwórz trasę, która będzie aktywowana, gdy użytkownik powie „Koszule”

• Intencja: redirect.shirts
• Przejście: strona: Shirts

5. Utwórz trasę, która będzie aktywowana, gdy użytkownik powie „Muzyka”.

• Intencja: redirect.music
• Przejście: strona: Music

6. Tworzenie trasy, gdy użytkownik prosi o informacje o cenie

• Intencja: redirect.price
• Przejście: Utwórz nową stronę: Price

Po skonfigurowaniu powyższych ustawień zobaczysz wizualizację podobną do tej na obrazku poniżej. Zwróć uwagę, że trasy intencji są na schemacie oznaczone kolorem niebieskim, a trasy warunkowe – pomarańczowym. Obsługa zdarzeń jest oznaczona na zielono, a gdy na stronę przechodzi kilka typów ścieżek, linia jest szara.

Wiesz już, jak tworzyć przepływy, obiekty, intencje i strony za pomocą procedur obsługi stanu, takich jak trasy intencji i trasy warunkowe oparte na parametrach. W dalszej części tego modułu użyjemy w realizacji warunkowego rozgałęzienia, aby na podstawie danych wejściowych wyświetlać różne dialogi.

Aby sfinalizować pracę nad wirtualnym agentem, możesz użyć tych konfiguracji.

Strona koszul:

1. Na stronie Koszulki utwórz te konfiguracje:

• Wypełnianie pozycji: Do you want a longsleeve or a t-shirt?
• Realizacja zgłoszenia Niestandardowy ładunek:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "T-shirt"
            },
            {
              "text": "Longsleeve"
            },
            {
              "text": "Price?"
            }
          ]
        }
      ]
    ]
  }

2. Utwórz trasę intencji: redirect.price z przejściem na Price stronę.
3. Utwórz ten parametr:

• Parametr: merch – typ podmiotu: @Merch, Required i Redact in log
• Parametr > Obsługa zdarzeń > No-match default
• Parametr > Realizacja modułu obsługi zdarzeń: You can choose between a t-shirt or a longsleeve. Which of these do you want?
• Parametr > Niestandardowy ładunek realizacji obsługi zdarzeń:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "T-shirt"
            },
            {
              "text": "Longsleeve"
            }
          ]
        }
      ]
    ]
  }

• Parametr > Obsługa zdarzeń > No-input default
• Parametr > Realizacja modułu obsługi zdarzeń: I couldn't understand if you want the t-shirt or the longsleeve. Which of these do you want?
• Parametr > Niestandardowy ładunek realizacji obsługi zdarzeń:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "T-shirt"
            },
            {
              "text": "Longsleeve"
            }
          ]
        }
      ]
    ]
  }

4. Kliknij spełnienie warunku i przewiń w dół do sekcji Gotowe ustawienia parametrów. Za każdym razem, gdy strona z koszulami stanie się aktywna, parametr kategorii zostanie ustawiony na koszule:

Parametr	Wartość
category	shirts

5. Dodawanie trasy warunkowej:

• Spełniona co najmniej 1 reguła (LUB)
• Wyrażenie: $session.params.merch = "T-shirt"
• Wyrażenie: $session.params.merch = "Longsleeve"
• Przejście na nową stronę: Shirt Size

Strona z cenami:

Ponieważ komunikaty dotyczące cen będą zależeć od wybranego produktu lub kategorii (muzyka lub koszulki), tę część poprawimy później w laboratorium. Na razie wystarczy wpisać symbol zastępczy.

1. Na stronie Cena utwórz te konfiguracje:

• Wypełnianie pozycji: PRICE TODO

Cenę możesz poprosić w różnych miejscach rozmowy, więc zawsze powinnaś otrzymać odpowiedź i zostać przekierowana z powrotem do poprzedniej części dialogu, aby kontynuować zamówienie. W drzewie dialogowym jest 5 miejsc, w których możesz uzyskać informacje o cenach. (Shirt, Shirt Size, Music, Carrier and also direct via an Intent Route), dlatego będziemy potrzebować kilku tras warunkowych, aby wrócić:

2. Dodawanie trasy warunkowej:

• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $session.params.category = "shirts"
• Wyrażenie: $session.params.merch = "null"
• Przejście na nową stronę: Shirts

3. Dodawanie trasy warunkowej:

• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $session.params.category = "shirts"
• Wyrażenie: $session.params.size = "null"
• Przejście na nową stronę: Shirt Size

4. Dodawanie trasy warunkowej:

• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $session.params.category = "music"
• Wyrażenie: $session.params.album = "null"
• Przejście na nową stronę: Music

5. Dodawanie trasy warunkowej:

• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $session.params.category = "music"
• Wyrażenie: $session.params.merch = "null"
• Przejście na nową stronę: Carrier

6. Dodawanie trasy warunkowej:

• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $session.params.category = "null"
• Przejście na nową stronę: Product Overview

Strona z rozmiarami koszul:

1. Na stronie Rozmiar koszuli utwórz te konfiguracje:

• Wypełnianie pozycji: What shirt size do you want?
• Realizacja zgłoszenia Niestandardowy ładunek:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "XS"
            },
            {
              "text": "S"
            },
            {
              "text": "M"
            },
            {
              "text": "L"
            },
            {
              "text": "XL"
            },
            {
              "text": "2XL"
            },
            {
              "text": "3XL"
            }
          ]
        }
      ]
    ]
  }

2. Utwórz trasę intencji: redirect.price z przejściem na Price stronę.
3. Utwórz ten parametr:

• Parametr: shirtsize – typ encji: @ShirtSize – Required, Redact In Log
• Parametr > Obsługa zdarzeń > No-match default
• Parametr > Realizacja modułu obsługi zdarzeń: Please tell me the shirt size, such as XL.
• Parametr > Niestandardowy ładunek realizacji obsługi zdarzeń:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "XS"
            },
            {
              "text": "S"
            },
            {
              "text": "M"
            },
            {
              "text": "L"
            },
            {
              "text": "XL"
            },
            {
              "text": "2XL"
            },
            {
              "text": "3XL"
            }
          ]
        }
      ]
    ]
  }

• Parametr > Obsługa zdarzeń > No-input default
• Parametr > Realizacja modułu obsługi zdarzeń: I couldn't understand the shirt size. What size do you want?
• Parametr > Realizacja obsługi zdarzeń > Niestandardowy ładunek:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "XS"
            },
            {
              "text": "S"
            },
            {
              "text": "M"
            },
            {
              "text": "L"
            },
            {
              "text": "XL"
            },
            {
              "text": "2XL"
            },
            {
              "text": "3XL"
            }
          ]
        }
      ]
    ]
  }

4. Dodawanie trasy warunkowej:

• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $page.params.shirtsize != "null"
• Przejście do strony: Product

Strona Muzyka:

1. Utwórz te konfiguracje na stronie Muzyka:

• Wypełnianie pozycji: We have a Greatest Hits Album or the Live Album. Which one do you want?
• Realizacja zgłoszenia Niestandardowy ładunek:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "Greatest Hits"
            },
            {
              "text": "Live"
            },
            {
              "text": "Price?"
            }
          ]
        }
      ]
    ]
  }

2. Utwórz trasę intencji: redirect.price z przejściem do strony: Price.
3. Utwórz ten parametr:

• Parametr: album – typ encji: @Album – Required, Redact In Log
• Parametr > Obsługa zdarzeń > No-match default
• Parametr > Realizacja modułu obsługi zdarzeń: You can choose between Greatest Hits and Live Album. Which of these do you want?
• Parametr > Niestandardowy ładunek realizacji obsługi zdarzeń:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "Greatest Hits"
            },
            {
              "text": "Live"
            }
          ]
        }
      ]
    ]
  }

• Parametr > Obsługa zdarzeń > No-input default
• Parametr > Realizacja modułu obsługi zdarzeń: I couldn't understand if you want the album: Greatest Hit or Live. Which of these do you want?
• Parametr > Niestandardowy ładunek realizacji obsługi zdarzeń:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "Greatest Hits"
            },
            {
              "text": "Live"
            }
          ]
        }
      ]
    ]
  }

4. Kliknij wypełnienie wpisu i przewiń w dół do sekcji Gotowe ustawienia parametrów. Za każdym razem, gdy strona Muzyka stanie się aktywna, parametr kategorii zostanie ustawiony na music:

Parametr	Wartość
category	music

4. Dodawanie trasy warunkowej:

• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $page.params.album != "null"
• Przejście do strony: Carrier

Strona operatora:

1. Utwórz te konfiguracje na stronie Operator:

• Wypełnianie pozycji: Do you want this album on CD or MP3?
• Realizacja zgłoszenia Niestandardowy ładunek:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "CD"
            },
            {
              "text": "MP3"
            },
            {
              "text": "Price?"
            }
          ]
        }
      ]
    ]
  }

2. Utwórz trasę intencji redirect.price, która prowadzi do Price strony.
3. Utwórz ten parametr:

• Parametr: merch – typ encji: @Merch – Required, Redact In Log
• Parametr > Obsługa zdarzeń > No-match default
• Parametr > Realizacja modułu obsługi zdarzeń: Do you want a physical CD or the digital album?
• Parametr > Realizacja modułu obsługi zdarzeń: ładunek niestandardowy:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "CD"
            },
            {
              "text": "Digital Album"
            }
          ]
        }
      ]
    ]
  }

• Parametr > Obsługa zdarzeń > No-input default
• Parametr > Realizacja modułu obsługi zdarzeń: I couldn't understand if you mean CD or MP3. Which one do you want?
• Parametr > Realizacja modułu obsługi zdarzeń: ładunek niestandardowy:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "CD"
            },
            {
              "text": "MP3"
            }
          ]
        }
      ]
    ]
  }

4. Dodawanie trasy warunkowej:

• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $page.params.merch != "null"
• Przejście do strony: Product

Strona produktu:

1. Utwórz te parametry:

Wyświetlana nazwa parametru	Typ podmiotu parametru	Weryfikacja
artist	@Artist	Wymagane, usuń z logu
merch	@Merch	Wymagane, usuń z logu

2. Parametr artist wymaga podania następującego początkowego promptu, który będzie wyświetlany, gdy wykonawca jest nieznany. You didn't mention which artist you are interested in. You can ask me to buy the $session.params.merch of the artist you like or ask which artists we signed. How can I help?

{
  "richContent": [
    [
      {
        "options": [
          {
            "text": "Which artists?"
          }
        ],
        "type": "chips"
      }
    ]
  ]
}

• Dodaj też moduł obsługi zdarzeń No-input default z realizacją: I couldn't understand what you just said. Ask me which artists are signed.
• oraz moduł obsługi zdarzeń No-match default z realizacją: I missed that. Please ask me which artists are signed..

3. Parametr merch również wymaga obsługi zdarzeń ponownego wyświetlania promptu.

• Dodaj moduł obsługi zdarzeń No-input default z realizacją: I couldn't understand what you just said. Which merchandise item do you want?
• oraz moduł obsługi zdarzeń No-match default z realizacją: I missed that. Which merchandise item do you want?.

Gdy wykonawca jest znany, a użytkownik wybierze „Film z trasy koncertowej”, następna trasa przejdzie na stronę potwierdzenia.

4. Dodawanie trasy warunkowej:

• Spełnione WSZYSTKIE reguły (ORAZ)
• Wyrażenie: $session.params.artist != null
• Wyrażenie: $session.params.merch = "Tour Movie"
• Ustawienia wstępne parametrów Dodaj parametr > price = 25
• Przejście na nową stronę: Confirmation

Następna ścieżka przejdzie do strony potwierdzenia, gdy wykonawca będzie znany, a użytkownik wybierze „T-shirt” i rozmiar koszulki.

5. Dodawanie trasy warunkowej:

• Wyrażenie niestandardowe: $session.params.artist != null AND $session.params.merch = "T-shirt" AND $session.params.shirtsize != null
• Ustawienia wstępne parametrów Dodaj parametr > price = 25
• Przejście do strony: Confirmation

Gdy wykonawca jest znany, a użytkownik wybierze „Longsleeve” i rozmiar koszulki, następna trasa przejdzie na stronę potwierdzenia.

6. Dodawanie trasy warunkowej:

• Wyrażenie niestandardowe: $session.params.artist != null AND $session.params.merch = "Longsleeve" AND $session.params.shirtsize != null
• Ustawienia wstępne parametrów Dodaj parametr > price = 30
• Przejście do strony: Confirmation

Kolejna ścieżka prowadzi do strony potwierdzenia, gdy wykonawca jest znany, a użytkownik wybierze „CD” i nazwę albumu.

7. Dodawanie trasy warunkowej:

• Wyrażenie niestandardowe: $session.params.artist != null AND $session.params.merch = "CD" AND $session.params.album != null
• Ustawienia wstępne parametrów Dodaj parametr > price = 15
• Przejście do strony: Confirmation

Następna ścieżka prowadzi do strony potwierdzenia, gdy wykonawca jest znany, a użytkownik wybierze „Album cyfrowy” i nazwę albumu.

8. Dodawanie trasy warunkowej:

• Wyrażenie niestandardowe: $session.params.artist != null AND $session.params.merch = "Digital Album" AND $session.params.album != null
• Ustawienia wstępne parametrów Dodaj parametr > price = 10
• Przejście do strony: Confirmation

Teraz utworzymy zaawansowane warunki z promptami, które wykrywają brakujące informacje. Następna ścieżka przekieruje użytkownika z powrotem na stronę muzyki, gdy wykonawca jest znany, a użytkownik wybierze „CD” lub „Album cyfrowy”, ale nie wybierze nazwy albumu.

9. Dodawanie trasy warunkowej:

• Wyrażenie niestandardowe: $session.params.artist != null AND ($session.params.merch = "CD" OR $session.params.merch = "Digital Album") AND $session.params.album = null
• Realizacja: I would also need to know which album you would like to buy!
• Przejście do strony: Music

Ostatnia ścieżka przejdzie na stronę potwierdzenia, gdy wykonawca będzie znany, a użytkownik wybierze „T-shirt” lub „Longsleeve”, ale nie wybierze rozmiaru koszulki.

10. Dodawanie trasy warunkowej:

• Wyrażenie niestandardowe: $session.params.artist != null AND ($session.params.merch = "T-shirt" OR $session.params.merch = "Longsleeve") AND $session.params.shirtsize = null
• Realizacja: I would also need to know which shirt size you need!
• Przejście do strony: Shirt Size

W następnej części ćwiczenia użyjemy warunkowych realizacji, aby wyświetlać różne komunikaty realizacji w zależności od danych wejściowych.

7. Odpowiedzi warunkowe

Niektóre odpowiedzi będą zawierać inne dialogi w zależności od danych wejściowych. Dialogi będą się rozgałęziać. Nazywamy to odpowiedziami warunkowymi. Może to być przydatne, gdy nie korzystasz z realizacji za pomocą webhooków, w przypadku których odpowiedzi warunkowe są określane na backendzie. Przykład:

if [condition]
  [response]
elif [condition]
  [response]
elif [condition]
  [response]
else
  [response]
endif

• Przykład [warunku]: $session.params.user-age >= 21. Ma podobny format do warunków w trasach.
• [response] przyjmuje statyczną odpowiedź tekstową.
• Odpowiedzi warunkowe zawsze zaczynają się od if
• Bloki elif i else są opcjonalne.

Dialogflow CX może też korzystać z wbudowanych funkcji systemowych. Na przykład do sformatowania daty lub godziny albo wyświetlenia bieżącego czasu ($sys.func.NOW()).

Dokończmy proces katalogu, poprawiając strony Potwierdzenie i Cena.

Strona potwierdzenia:

Teraz utworzymy stronę potwierdzenia. Musi spełniać te wymagania:

• Jeśli produkt to CD lub album cyfrowy. W potwierdzeniu wyświetlimy te pola: artist, merch, album i price.
• Jeśli produkt to T-shirt lub Longsleeve. W potwierdzeniu wyświetlimy te pola: artist, merch, size i price.
• W przeciwnym razie (czyli jeśli merch to Film z trasy). W potwierdzeniu wyświetlimy te pola: artist, merch i price.

1. Kliknij stronę Potwierdzenie.
2. Kliknij kolejno Edytuj realizację > Odpowiedzi agenta > opcję Dodaj dialog > Odpowiedź warunkowa:

if ($session.params.merch = "CD" OR $session.params.merch = "Digital Album")
  The $session.params.merch: $session.params.artist - $session.params.album costs $$session.params.price. Shall I continue to order?
elif ($session.params.merch = "T-shirt" OR $session.params.merch = "Longsleeve")
  A $session.params.merch of $session.params.artist size: $session.params.shirtsize costs $$session.params.price. Shall I continue to order?
elif $session.params.merch = "Tour Movie"
  The $session.params.merch of $session.params.artist costs $$session.params.price. Shall I continue to order?
else
  It looks like something went wrong with your order. You can say "Reset", to restart the order process.
endif

3. Create the following Custom payload:

• Custom payload:

{
  "richContent": [
    [
      {
        "options": [
          {
            "text": "Yes, confirm"
          }
        ],
        "type": "chips"
      }
    ]
  ]
}

Next, create two intent routes:

3. confirm.proceed.order transitions to: Order Process Flow.
4. decline.proceed.order transitions to End Flow

When the user declines the order, and does not want to proceed the order process, we will have to transition back to the welcome page, but all the parameters have to be cleared. We can do this by specifically setting null to all the possible parameters. You can do this with Parameter presets.

5. In the decline.proceed.order intent route, scroll down to Parameter presets and add the following parameters:

Parameter	Value
artist	null
merch	null
shirtsize	null
category	null
album	null
price	null
restart	true

Notice that we have created an additional parameter called restart. If this parameter is present, the Default Start Flow, should know to continue the conversation by showing a customized message.

6. Click on the Default Start Flow, Start Page, and create another Conditional Route:

• $session.params.restart = "true"
• Fulfillment: "Welcome back, as the virtual agent of G-Records, I can help you order artists merchandise, you can ask questions about your order or shipping, and I can tell you more which artists are currently signed with us. How can I help?"
• Custom payload:

{
    "richContent": [
      [
        {
          "type": "chips",
          "options": [
            {
              "text": "Which artists?"
            },
            {
              "text": "Which products?"
            },
            {
              "text": "About my order..."
            }
          ]
        }
      ]
    ]
  }

7. Select the Start Page and click on the redirect.end intent. Create the following fulfillment: Thank you for contacting G-Records! Have a nice day!

Price Page:

Let's also fix the Price TODOs. The price information will be static for now. Click on the Price Page in the Catalog Flow, and use the following entry fulfillment:

• Delete the Agent Says entry fulfillment.
• Create a new Conditional Response:

if $session.params.category = "shirts"
  A t-shirt costs $25 and a longsleeve costs $30.
elif $session.params.category = "music"
  A CD costs $15. The digital album on MP3 costs $10.
else
  A t-shirt costs $25 and a longsleeve costs $30. A CD costs $15 and a digital album on MP3 $10. In case you are interested in the Tour Movie, that one is $25.
endif

Well done, by now you completed the Catalog flow. Your flow should look similar to this diagram:

8. Wrapping up the agent

We are almost at the end of this lab. Let's configure the last flows together, and take in practice all the new things that we have learned.

Creating the My Order Flow

1. Go to the My Order Flow, and create the following intent transitions:

Page (In Flow)	Routes > Intent	Routes > Transition To
My Order Start	redirect.my.order	My Order
My Order Start	redirect.my.order.status	My Order Status
My Order Start	redirect.my.order.canceled	My Order Cancellation
My Order Start	redirect.end	End Session
My Order Start	redirect.home	End Flow
My Order	redirect.my.order.status	My Order Status
My Order	redirect.my.order.canceled	My Order Cancellation
Default Start Flow	redirect.my.order.canceled	Flow: My Order
Default Start Flow	redirect.my.order.status	Flow: My Order

2. Let's create the following entry fulfillment for the My Order Page:

• Entry fulfillment: I can look up the status of your order, or I can cancel an order.

3. In the My Order Page create the following parameter:

• Displayname: ordernumber
• Entity Type: @OrderNumber
• Required: checked
• Initial prompt fulfillment: What's the order number? For example ABCD123.
• Event Handler: No-match default: To proceed with your order I will need an order number. Order numbers start with 4 characters and end with 3 numbers, such as ABCD123. Which order number may I use?
• Event Handler: No-input default: I missed that. To proceed with your order I will need an order number. Order numbers start with 4 characters and end with 3 numbers, such as ABCD123. Which order number may I use?

4. Create the following conditional route:

• Customize Expression: $page.params.status = "FINAL"
• Fulfillment: And do you want to Cancel your order, or should I look up the status?

5. Click on Add state handler > Event Handlers and create the Event Handler: No-input default

• Fulfillment: I'm sorry, what was that? Would you like me to cancel an order or look up the status?
• Custom payload:

{
  "richContent": [
    [
      {
        "options": [
          {
            "text": "Status"
          },
          {
            "text": "Cancel"
          }
        ],
        "type": "chips"
      }
    ]
  ]
}

6. Create the Event Handler: No-match default

• Fulfillment: Would you like me to cancel an order or lookup the status?
• Custom payload:

{
  "richContent": [
    [
      {
        "options": [
          {
            "text": "Status"
          },
          {
            "text": "Cancel"
          }
        ],
        "type": "chips"
      }
    ]
  ]
}

7. In the My Order Status Page create the following parameter:

• Displayname: ordernumber
• Entity Type: @OrderNumber
• Required checked
• Initial prompt fulfillment: What's the order number? For example ABCD123.
• Event Handler: No-match default: To proceed with your order I will need an order number. Order numbers start with 4 characters and end with 3 numbers, such as ABCD123. Which order number may I use?
• Event Handler: No-input default: I missed that. To proceed with your order I will need an order number. Order numbers start with 4 characters and end with 3 numbers, such as ABCD123. Which order number may I use?

8. In the My Order Status Page create the following conditional route:

• Customize Expression: $session.params.ordernumber != null
• Fulfillment: Your order $session.params.ordernumber has been shipped, it can take up to approx 2 weeks before you will receive your items.
• Add dialogue option > Text: Is there anything else I can help you with?

9. In the My Order Cancelation Page create the following parameter:

• Displayname: ordernumber
• Entity Type: @OrderNumber
• Required checked
• Initial prompt fulfillment: What's the order number? For example ABCD123.
• Event Handler: No-match default: To proceed with your order I will need an order number. Order numbers start with 4 characters and end with 3 numbers, such as ABCD123. Which order number may I use?
• Event Handler: No-input default: I missed that. To proceed with your order I will need an order number. Order numbers start with 4 characters and end with 3 numbers, such as ABCD123. Which order number may I use?

10. In the My Order Cancelation Page create the following conditional route:

• Customize Expression: $session.params.ordernumber != null
• Fulfillment: Your order $session.params.ordernumber has been canceled.
• Add dialogue option > Text: Is there anything else I can help you with?

11. Test the flow and create the following two test scenarios:

>"About my order"
>"ABCD123"
>"Status"

And:

>"What's the status of order DEFG222"

12. Select the Start Page and click on the redirect.end intent. Create the following fulfillment: Thank you for contacting G-Records! Have a nice day!
13. Select the Start Page and click on the redirect.home intent. Create the following parameter preset: restart = true

Default Negative intents (Fallback)

When you create a virtual agent, a default negative intent is created for you. You can add training phrases to this intent that act as negative examples that will trigger a No-match event. There may be cases where end-user input has a slight resemblance to training phrases in normal intents, but you do not want these inputs to match any normal intents.

1. Try in the simulator: I don't like Alice Googler.

You will see that the virtual agent answers with the Product Overview Page, to continue ordering Alice Googler merchandise. However, your end user does not like that artist. Let's use the Default Negative Intent for this.

2. Go to Manage > Intents and select the Default Negative Intent.
3. Add the following training phrases that will trigger the No-match event.

• I don't like Alice Googler
• I am not a fan of G's N' Roses
• I can't stand the music of the Google Dolls

4. Hit Save and test the following sentence in the simulator: I am really not a fan of the Goo Fighters

This time the No-match event was triggered, you stayed on the Start Page.

Default Fallback Messages

1. Click the Default Start Flow, select the sys.no-input-default event handler.

The No-input fallback basically means: No text or speech answers were detected. Likely no answers were given, or the system couldn't hear it. Therefore, let's make the fallback messages more specific. Use the tab key, to create alternative dialogues:

2. Remove all answers, and add these text dialogues:

• I'm sorry, I didn't receive an answer. Can you say it again?
• I missed your answer, can you say it again?
• Sorry, I didn't hear anything. Can you say it again?
• I couldn't hear what you were saying, what was that?
• I'm sorry, I missed your answer. What were you trying to say?

Don't forget to click Save.

3. Click the Default Start Flow, select the sys.no-match-default event handler.

The No Match fallback basically means: Text or speech answers were detected but nothing in Dialogflow CX got matched.

4. Remove all answers, and add these text dialogues:

• Sorry, I didn't get that. Can you please rephrase?
• I'm sorry, I don't understand. Can you please rephrase?
• I don't understand, please rephrase.
• Sorry, I didn't get that. What was that?
• I didn't get that, can you please rephrase?

Don't forget to click Save.

5. It's advised to repeat these steps for the Catalog, My Order, Order Process and Customer Care flows.

Here's a tip: when creating fallback messages, make them more explicit, by rephrasing the previous question or by mentioning an example. You could create these type of No-match and No-input events on Page level when creating parameters. In our labs, we have already done this.

Creating the Order Process Flow

1. Go to the Order Process Flow, and create the following intent transitions:

Page (In Flow)	Routes > Intent	Routes > Transition To
Order Process Start	redirect.end	End Session
Order Process Start	redirect.home	End Flow
Order Process Start	confirm.proceed.order	New Page: Shipping Details

2. Let's create the following entry fulfillment for the Shipping Details Page:

• Entry fulfillment: To complete your order I will first need to collect your shipping details.

3. Create the following parameters:

These parameters will make use of built-in system entities. System entity support differs for each language. See the docs for more information.

Parameter Display name	Entity	Required?	Initial prompt fulfillment	No-match default	No-input default
firstname	@sys.person	Required	What's your first name?	I'm sorry I missed that. What's the first name?	I'm sorry, I didn't understand. What's the first name?
lastname	@sys.person	Required	What's your last name?	I'm sorry I missed that. What's the last name?	I'm sorry, I didn't understand. What's the last name?
address	@sys.address	Required	What's your address?	I missed that. What's the address?	I'm sorry, I didn't understand. What's the address?
zipcode	@sys.any	Required	What postal code or zipcode do you have?	I'm sorry, what's the zip or postal code? For example: 1234AB or 10001.	I'm sorry, I didn't understand. What's the zip or postal code? For example: 1234AB or 10001.
city	@sys.geo-city	Required	What's the name of the city?	I missed that, what's the name of the city?	I'm sorry, I didn't understand. What's the name of the city?
country	@sys.geo-country	Required	What's the name of the country?	I missed that, what's the name of the country?	I'm sorry, I didn't understand. What's the name of the country?
email	@sys.email	Required	Lastly, what's your email address?	I am sorry. What's the email address? For example [e-mail].	I am sorry, I didn't understand. What's the email address? For example [e-mail].

4. Create the following conditional route:

• Customize Expression: $page.params.status = "FINAL"
• Transition to new Page: Payment Details

5. Create the following entry fulfillment.

Let's fake it that this virtual agent makes use of Google Pay. Don't worry this tutorial won't make real transactions. Create the following entry dialogues:

• Agent Says:

Alright $session.params.firstname! We will make use of Google Pay, that's connected to your email account: $session.params.email.

• Conditional Response

if $session.params.merch != "Digital Album"
  Shipping costs an additional 5 dollars. This will make the total price $$sys.func.TO_TEXT($sys.func.ADD($session.params.price, 5)).
  Your merchandise will be shipped to:
  $session.params.firstname $session.params.lastname
  $session.params.address
  $session.params.zipcode $session.params.city
  $session.params.country
  To continue the order process please explicitly say "I confirm". Do you want to confirm your $session.params.artist $session.params.merch order?
else
  The total costs will be: $$session.params.price.
  After purchasing the digital album, you will receive an email with the download link.
  To continue the order process please explicitly say "I confirm".
  Do you want to confirm your $session.params.artist $session.params.merch order?
endif

6. Utwórz tę trasę intencji:

• Intencja: confirm.proceed.order
• Pracownik obsługi klienta pisze: Thank you for your order! Your merchandise will be shipped today!
• Dodaj opcję dialogu > Tekst: Here's the order number: ABCD123.
• Dodaj opcję dialogu > Tekst: Have a good day!
• Przejście: End Session

7. Wybierz Strona startowa i kliknij intencję redirect.end. Utwórz to działanie: Thank you for contacting G-Records! Have a nice day!
8. Wybierz Strona startowa i kliknij intencję redirect.home. Utwórz te gotowe ustawienia parametru: restart = true

Świetnie! Mamy już w pełni działającego chatbota dla sprzedawcy detalicznego. W następnym module sprawdzimy, jak dobrze radzi sobie wirtualny agent.

9. Testowanie agenta wirtualnego

Możesz użyć wbudowanego symulatora, aby przetestować dialogi wirtualnego agenta. Zaletą testowania ścieżek w symulatorze jest to, że możesz zobaczyć przejrzysty przegląd ścieżek, stron, parametrów i zdarzeń (DTMF), które symulator zebrał podczas przechodzenia przez Twoje ścieżki. Ułatwia to testowanie w porównaniu z testowaniem bezpośrednio w integracji, ponieważ te typy informacji będą ukryte przed użytkownikiem. Możesz nawet tworzyć przypadki testowe, zapisywać je i używać ponownie. Ma to duże znaczenie, gdy z czasem utrzymujesz lub edytujesz przepływy i chcesz mieć pewność, że żadna z wprowadzonych zmian nie zepsuje Twojej wcześniejszej pracy.

Możesz też eksportować i importować wcześniej utworzone przypadki testowe, przechowując testy w Google Cloud Storage lub lokalnie. Eksportowanie testu spowoduje pobranie pliku binarnego. Więcej informacji o symulatorze i elementach testowania znajdziesz w dokumentacji symulatora i elementów testowania.

Zanim utworzymy kilka przypadków testowych, dokończmy tworzenie agenta wirtualnego:

Tworzenie przepływu obsługi klienta

1. Otwórz przepływ Obsługa klienta i utwórz te przejścia intencji:

Strona (w przepływie)	Trasy > Intencja	Trasy > Przejście do
Początek obsługi klienta	redirect.shipping.info	Dostawa
Początek obsługi klienta	redirect.refund.info	Zwrot środków
Początek obsługi klienta	redirect.swapping.info	Zamiana
Początek obsługi klienta	redirect.home	Zakończ proces
Początek obsługi klienta	redirect.end	Zakończ sesję

2. Utwórz te realizacje wpisów na stronie Dostawa:

• Shipping physical merchandise items can take up to 2 weeks.
• Is there anything else I can help you with?

3. Utwórz te realizacje wpisów na stronie Zwrot środków:

• We offer free returns and refunds. We provide one free return label for each order. You can use it within 30 days from receiving your order. If your refund is accepted, we will refund the price you paid for your item back to your original payment method.
• Is there anything else I can help you with?

4. Utwórz te realizacje wpisów na stronie Swapping:

• If you would like to change your item for a different one, please return your unwanted item and place a new order. If your refund is accepted, we will refund the price you paid for your item back to your original payment method.
• Is there anything else I can help you with?

5. Wybierz Strona startowa i kliknij intencję redirect.end. Utwórz to działanie: Thank you for contacting G-Records! Have a nice day!
6. Wybierz Strona startowa i kliknij intencję redirect.home. Utwórz te gotowe ustawienia parametru: restart = true

Tworzenie przypadków testowych

1. Po prawej stronie ekranu kliknij przycisk Test Agent (Testuj agenta).

Gdy po raz pierwszy otworzysz symulator, musisz wybrać środowisko agenta i aktywny przepływ. W większości przypadków należy użyć środowiska wersji roboczej i domyślnego przepływu początkowego.

2. Typ: Hi

3. Zapytaj: Which artists are signed with your label?
4. Powiedz: The Google Dolls
5. Powiedz: I am interested in buying a shirt
6. Powiedz: A t-shirt
7. Powiedz: Medium
8. Teraz kliknij przycisk zapisywania przypadku testowego. Znajduje się ona u góry symulatora (obok strzałki ponawiania i ikony resetowania kosza).

9. Podaj te informacje:

• Nazwa przypadku testowego: Buy Google Dolls t-shirt size M
• Tagi: #katalog, #koszule, #t-shirt, #TheGoogleDolls

10. Kliknij Zapisz.

Utwórzmy więcej przypadków testowych.

11. Najpierw wyczyść bieżący dialog, klikając ikonę Resetuj (kosz).
12. Utwórz te przypadki testowe:

Kup koszulkę Alice Googler:

>"Buy the Alice Googler t-shirt."
>"XL"

• Nazwa przypadku testowego: Buy the Alice Googler t-shirt
• Tagi: #catalog, #shirts, #t-shirt, #AliceGoogler

Kup koszulkę w rozmiarze M: (zwróć uwagę, że nazwa wykonawcy nie została wymieniona, ale chcesz pominąć strony z przeglądem zespołów, przeglądem produktów, koszulkami i rozmiarami koszulek)

>"Buy a t-shirt size M"
>"The Google Fighters"

• Nazwa przypadku testowego: Buy a t-shirt size M
• Tagi: #catalog, #shirts, #t-shirt, #TheGoogleFighters
• Opis: (zwróć uwagę, że nie ma tu nazwy wykonawcy, ale chcesz pominąć strony z informacjami o zespołach, produktach, koszulkach i rozmiarach koszulek)

Kup muzykę G's N' Roses (uwaga: spowoduje to pominięcie strony z przeglądem zespołów i strony z przeglądem produktów)

>"Purchase music of G's N' Roses"
>"Live"
>"CD"

• Nazwa przypadku testowego: Purchase music of G's N' Roses
• Tagi: #catalog, #music, #CD, #GsNRoses, #live
• Opis: (uwaga: spowoduje to pominięcie stron z przeglądem zespołów i przeglądem produktów)

Sprawdź informacje o cenie:

>"Which products"
>"Shirts"
>"What's the price difference?"
>"Longsleeve"
>"What does it cost?"
>"M"
>"The Google Dolls"
>"No"
>"Which bands"
>"The Gooo Fighters"
>"Music"
>"How much does it cost?"
>"Greatest Hits"
>"What's the price difference?"
>"Mp3"
>"No"
>"I want to buy the tour movie"
>"Alice Googler"
>"Yes"

• Nazwa przypadku testowego: Price info
• Tagi: #catalog, #music, #tourmovie, #shirts
• Opis: testowanie informacji o cenie w różnych miejscach okna dialogowego.

Testowanie wcześniej nagranych przypadków testowych

1. W menu głównym Dialogflow po lewej stronie kliknij Zarządzaj > Przypadki testowe.
2. Wybierz wszystkie przypadki testowe i kliknij przycisk Uruchom nad tabelą.

Dialogflow CX uruchomi wszystkie wybrane przypadki testowe na nagraniu zapisanym jako „Golden Test Case”. Jeśli wyniki będą takie same jak w przypadku zapisanego nagrania, testy zostaną zaliczone. – Jeśli w przepływach nastąpiły zmiany, np. strony nie są prawidłowo skonfigurowane lub intencje kierują Cię na niewłaściwe strony, testy zakończą się niepowodzeniem.

4. W symulatorze zadaj to pytanie: How long will shipping take?
5. Zanotuj wynik i zapisz przypadek testowy jako Shipping z tagiem: #shipping.
6. Otwórz panel Zarządzaj > Przypadki testowe i kliknij przycisk Uruchom w prawym górnym rogu siatki, aby uruchomić tylko przypadek testowy Shipping.

Ten test powinien zakończyć się pomyślnie.

7. Wróć do przepływu obsługi klienta, wybierz stronę Start i kliknij nagłówek Trasy.

Wyświetli się ekran z siatką, na której widać wszystkie trasy.

8. Usuń redirect.shipping.info route
9. Otwórz panel Zarządzaj > Przypadki testowe i kliknij przycisk Uruchom w prawym górnym rogu siatki, aby uruchomić tylko przypadek testowy Shipping.

Ten test powinien się nie powieść.

10. Możesz kliknąć test, który zakończył się niepowodzeniem, aby wyświetlić szczegóły.

W tym przypadku test zakończył się niepowodzeniem z tym komunikatem o błędzie:

Page: Page mismatch:
Expected: Shipping
Actual: Start Page

Dzieje się tak, ponieważ strona nie istnieje już w procesie. Spodziewaliśmy się strony Shipping, ale nigdy nie opuściliśmy strony Start. (lub użytkownicy końcowi otrzymają wiadomość zastępczą).

Inaczej mówiąc, jest to pominięte żądanie, czyli wynik testu fałszywie negatywny. Test zakończył się niepowodzeniem. Oczekiwaliśmy strony Dostawa, ale nic się nie dzieje lub wyświetla się komunikat zastępczy.

11. Wróć do sekwencji obsługi klienta i dodaj redirect.shipping.info jako trasę intencji do strony Start. Nie zapomnij przejść na stronę Dostawa i kliknąć Zapisz.
12. W symulatorze zarejestruj ten przypadek testowy: I want to swap my item. Zapisz go jako Swapping #swapping.
13. Otwórz Zarządzaj > Intencje > redirect.refund.info i dodaj to wyrażenie na potrzeby trenowania: I want to swap this item for a refund

Bez tej frazy szkoleniowej, gdy użytkownik poprosi o zmianę produktu w celu uzyskania zwrotu środków, zostanie wywołany zamiar redirect.swapping.info. Nie chcemy jednak podawać informacji o zmianie produktów, tylko o zwrotach środków.

14. Utwórz ten testowy przypadek referencyjny: I want to swap this item for a refund w symulatorze i zapisz go jako Swap for Refund #refund.
15. Wróć do intencji Zarządzaj > Intencje > redirect.refund.info i usuń wiersz I want to swap this item for a refund.
16. Wróć do sekcji Zarządzaj > Przypadki testowe, wybierz przypadek testowy Wymiana za zwrot środków i uruchom go.

Ostatni test zakończył się niepowodzeniem. Wyświetlił się ten komunikat o błędzie:

If you would like to change your item for a different one, please return your unwanted item and place a new order. If your refund is accepted, we will refund the price you paid for your item back to your original payment method.`
Is there anything else I can help you with?
 Page: Page mismatch:
Expected: Refund
Actual: Swapping

Inaczej mówiąc, jest to źle zinterpretowane żądanie, czyli wynik testu fałszywie pozytywny. Test zakończył się niepowodzeniem. Oczekiwaliśmy strony Zwrot środków, ale aktywowana została strona Zamiana.

Zakres

W Dialogflow CX pokrycie testu to miara opisująca stopień, w jakim dialog wirtualnego agenta (strony i intencje) jest wykonywany podczas uruchamiania konkretnego zestawu testów. Wirtualny agent o wysokim pokryciu testami (mierzonym w procentach) ma więcej dialogów wykonanych podczas testowania, co sugeruje, że w porównaniu z wirtualnym agentem o niskim pokryciu testami ma mniejsze prawdopodobieństwo wystąpienia niewykrytych błędów (np. niezrozumiałych żądań).

1. Aby wyświetlić raport pokrycia testami wszystkich przypadków testowych, kliknij Pokrycie.
2. Kliknij kartę Przejścia.

Wyświetli się pokrycie testami wszystkich przejść między stronami.

3. Kliknij kartę Intencje.

Wyświetli się pokrycie testami wszystkich intencji.

Gratulacje! Udało Ci się stworzyć i przetestować kompletny przykład bota sprzedawcy z rzeczywistego świata. Przejdźmy na następną stronę modułu, aby przeczytać podsumowanie i znaleźć przydatne materiały referencyjne.

10. Podsumowanie

Dialogflow CX to platforma konwersacyjnej AI (CAIP) do tworzenia agentów wirtualnych, takich jak boty na czacie lub boty głosowe. Dialogflow CX umożliwia zespołowi szybsze tworzenie konwersacyjnych interfejsów na poziomie przedsiębiorstwa dzięki wizualnym narzędziom do tworzenia botów, wielokrotnemu wykorzystywaniu intencji i możliwości prowadzenia wieloetapowych rozmów.

Z tego ćwiczenia w Codelabs dowiedzieliśmy się, jak utworzyć wirtualnego agenta sprzedaży do zastosowań w rzeczywistym świecie. Omówiliśmy te kwestie:

• Przepływy
• Parametry, niestandardowe i systemowe typy danych
• Strony
• Obsługa stanu, np. trasy intencji i trasy warunkowe
• Statyczne komunikaty realizacji i odpowiedzi warunkowe
• Zamiary zastępcze
• Symulator, przypadki testowe i pokrycie

Utworzony przez Ciebie wirtualny agent sprzedaży detalicznej jest dość złożony. Jak widać na obrazie poniżej, istnieje wiele ścieżek konwersacji, które mogą prowadzić do różnych zakończeń. Niektóre ścieżki konwersacji zostały ponownie wykorzystane, a niektóre mogły zostać pominięte. Ten przypadek użycia pokazuje, jak potężne jest narzędzie Dialogflow CX. Oczywiście możesz tworzyć agentów handlowych za pomocą Dialogflow ES, ale nie możesz ponownie wykorzystywać intencji, a utrzymywanie kontekstu i parametrów jest ograniczone, więc prawdopodobnie skończysz na ręcznym kodowaniu realizacji backendu, co wymaga pomocy programistów. W Dialogflow CX, gdy już opanujesz podstawy, wystarczy kilka kliknięć, aby architekt rozmów mógł skonfigurować złożone ścieżki.

Odniesienia

Więcej informacji o Dialogflow CX znajdziesz w tych blogach i dokumentach:

• Przewodniki techniczne dotyczące Dialogflow CX
• Dokumentacja Dialogflow CX API
• Komponenty Dialogflow CX utworzone przez społeczność
• Blog Dialogflow prowadzony przez Lee Boonstrę, specjalistę ds. technologii konwersacyjnej AI