Build Actions for Asystent Google – Kreator działań (poziom 1)

1. Opis

Ostrzeżenie: działania konwersacyjne zostaną wycofane 13 czerwca 2023 r. Więcej informacji znajdziesz w zachowaniu czynności konwersacyjnych.

Platforma dewelopera Asystenta Google umożliwia tworzenie oprogramowania rozszerzającego możliwości Asystenta wirtualnego – wirtualnego asystenta osobistego – na ponad miliard urządzeń, takich jak inteligentne głośniki, telefony, samochody, telewizory czy słuchawki. Użytkownicy rozmawiają z Asystentem podczas rozmowy, np. kupując artykuły spożywcze czy rezerwując przejazd. Jako deweloper możesz korzystać z platformy dla deweloperów Asystenta, by łatwo tworzyć przydatne rozmowy i zarządzać nimi między użytkownikami a własną usługą realizacji zamówień.

Ćwiczenia z programowania obejmują zagadnienia dla początkujących użytkowników Asystenta Google. Nie musisz mieć żadnego doświadczenia z platformą, żeby je ukończyć. W tym ćwiczeniu z programowania stworzysz prostą akcję dla Asystenta Google, która będzie przekonywać użytkowników do szczęścia na początku przygody w mitycznym kraju Gryffinberg. W ćwiczeniach z zakresu programowania w Asystencie na poziomie 2 bardziej rozbudowujesz tę akcję, dostosowując fortunę użytkowników na podstawie ich danych wejściowych.

Co stworzysz

W ramach tego ćwiczenia z programowania tworzysz proste działanie z tymi funkcjami:

• Odpowiada użytkownikom wiadomość powitalną
• Użytkownik otrzymuje pytanie. Po wyświetleniu odpowiedzi akcja jest odpowiednio reagowana na wybór użytkownika
• Oferuje elementy sugestii, które użytkownicy mogą kliknąć, aby wprowadzić dane
• Modyfikuje wiadomość powitalną dla użytkownika na podstawie tego, czy jest to użytkownik powracający

Po zakończeniu ćwiczeń z ćwiczenia w ramach tego ćwiczenia omówiony zostanie następujący przebieg rozmowy:

Czego się nauczysz

• Jak utworzyć projekt w konsoli Actions
• Jak wysłać potwierdzenie do użytkownika, który wywołał Twoją akcję
• Jak przetworzyć odpowiedź użytkownika i zwrócić odpowiedź
• Testowanie działania w Symulatorze działań
• Jak wdrożyć realizację w edytorze Cloud Functions

Czego potrzebujesz

W Twoim środowisku muszą być dostępne te narzędzia:

• Przeglądarka internetowa, np. Google Chrome.

2. Skonfiguruj

W poniższych sekcjach znajdziesz informacje o tym, jak skonfigurować środowisko programistyczne i utworzyć projekt w Actions.

Sprawdzanie ustawień uprawnień Google

Aby przetestować działanie utworzone w tym ćwiczeniu z programowania, musisz włączyć niezbędne uprawnienia, by symulator mógł uzyskać dostęp do Twojego działania. Aby włączyć uprawnienia, wykonaj te czynności:

1. Otwórz stronę Zarządzanie aktywnością.
2. W razie potrzeby zaloguj się na konto Google.
3. Włącz te uprawnienia:

• Aktywność w internecie i aplikacjach
• W sekcji Aktywność w internecie i aplikacjach zaznacz pole wyboru Uwzględnij historię Chrome i aktywność na stronach, urządzeniach i w aplikacjach, które używają usług Google.

Tworzenie projektu w Actions

Projekt w Actions to kontener akcji. Aby utworzyć projekt w Actions dla tych ćwiczeń z programowania, wykonaj te czynności:

1. Otwórz konsolę Actions.
2. Kliknij Nowy projekt.
3. Wpisz nazwę projektu, np. actions-codelab. (Nazwa służy do celów wewnętrznych. Później możesz ustawić zewnętrzną nazwę projektu).

4. Kliknij Utwórz projekt.
5. Na ekranie Jakiego działania chcesz utworzyć? wybierz kartę Niestandardowe.
6. Kliknij Dalej.
7. Wybierz kartę Pusty projekt.
8. Kliknij Rozpocznij tworzenie.

Powiąż konto rozliczeniowe

Aby wdrożyć realizację w późniejszym terminie w ćwiczeniach programowania z wykorzystaniem Cloud Functions, musisz powiązać konto rozliczeniowe z projektem w Google Cloud.

Jeśli z Twoim projektem nie jest jeszcze powiązane żadne konto rozliczeniowe, wykonaj te czynności:

1. Otwórz stronę płatności Google Cloud Platform.
2. Kliknij Dodaj konto rozliczeniowe lub Utwórz konto.
3. Wpisz dane karty.
4. Kliknij Rozpocznij bezpłatny okres próbny lub Prześlij i włącz płatności.
5. Otwórz stronę płatności Google Cloud Platform.
6. Kliknij kartę Moje projekty.
7. Kliknij 3 kropki w sekcji Czynności obok projektu Działania w ćwiczeniach z programowania.
8. Kliknij Zmień ustawienia płatności.
9. W menu wybierz skonfigurowane konto rozliczeniowe. Kliknij Skonfiguruj konto.

Aby uniknąć opłat, wykonaj czynności opisane w sekcji Czyszczenie projektu na końcu tych ćwiczeń z programowania.

3. Rozpocznij rozmowę

Użytkownicy rozpoczynają rozmowę z Twoją akcją przez wywołanie. Jeśli na przykład masz działanie o nazwie movieTime, użytkownicy mogą je wywołać, mówiąc na przykład "OK Google, porozmawiaj z FilmemFilmowym, gdzie FilmFilm to wyświetlana nazwa. Akcja musi mieć wyświetlaną nazwę, jeśli chcesz ją wdrożyć w wersji produkcyjnej. Aby jednak przetestować działanie, nie musisz jej określać. Zamiast tego możesz użyć symulatora "Talk to my test app", aby wywołać działanie.

Musisz określić główne wywołanie, aby zdefiniować, co ma się stać po wywołaniu działania przez użytkownika.

Kluczowe terminy:

• Główne wywołanie: punkt początkowy, za pomocą którego użytkownicy mogą rozpoczynać rozmowy z akcją. Gdy użytkownik wypowiesz wyrażenie podobne do "OK Google, wypowiedz polecenie <wyświetl nazwę>" , aby wywołać główne działanie i odpowiedz na nie.

Domyślnie Actions Actions wyświetla ogólny komunikat, który jest wywoływany ("Zacznij tworzyć akcję, definiując główne wywołanie).").

Kluczowe terminy:

• Powiadomienie: definiuje, co akcja wysyła do użytkowników w odpowiedzi. Potwierdzenia mogą obejmować proste odpowiedzi tekstowe i głosowe oraz wiadomości z elementami rozszerzonymi, takie jak karty i obrazy.

Aby zwrócić użytkownikowi wizualizację na pełnym ekranie, możesz użyć specjalnego komunikatu: Canvas. Więcej informacji o usłudze Canvas znajdziesz w artykule Obszary interaktywne.

W następnej sekcji możesz dostosować prośbę o główne wywołanie w konsoli Actions.

Konfigurowanie głównego wywołania

Aby zmienić komunikat, który wysyłasz do użytkownika, gdy go wywoła, wykonaj te czynności:

1. Na pasku nawigacyjnym kliknij Główne wywołanie.

2. W edytorze kodu zastąp tekst w polu speech (Start building your action...) taką wiadomością powitalną: A wondrous greeting, adventurer! Welcome to the mythical land of Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you're on your way to an epic journey.

Do edycji komunikatów możesz używać formatowania w formacie YAML lub JSON.

3. Kliknij Zapisz.

Testowanie głównego wywołania w symulatorze

Konsola Actions udostępnia narzędzie internetowe do testowania akcji o nazwie symulator. Interfejs jest symulowany przez sprzęt i jego ustawienia, dzięki czemu możesz rozmawiać z aplikacją tak, jakby działała na inteligentnym ekranie, telefonie, głośniku lub KaiOS.

Aby uzyskać więcej informacji o korzystaniu z symulatora konsoli Actions, zapoznaj się z artykułem Symulator. Zapoznaj się z nimi, jeśli napotkasz problemy podczas wykonywania kolejnych czynności.

Po wywołaniu działania powinna ono zawierać dodany samodzielnie dodany komunikat ("A wondrous greeting, adventurer!...").

Aby przetestować główne wywołanie akcji w symulatorze, wykonaj te czynności:

1. Na górnym pasku nawigacyjnym kliknij Przetestuj, aby przejść do symulatora.
2. Aby wywołać działanie w symulatorze, wpisz Talk to my test app w polu Input (Dane wejściowe) i naciśnij Enter.

Aby wywołać działanie, możesz też kliknąć element sugestii, Porozmawiaj z aplikacją testową lub ikonę mikrofonu i powiedz "Talk to my test app&quot.

Gdy aktywujesz główne działanie akcji, Asystent odpowiada Twoją wiadomością powitalną. Na tym etapie rozmowa kończy się po wysłaniu przez Asystenta powitania. W następnej sekcji modyfikujesz działanie tak, aby rozmowa była kontynuowana.

Wyświetl logi zdarzeń

Na karcie Testowanie panel po prawej stronie pokazuje dzienniki zdarzeń, które wyświetlają historię rozmów jako dzienniki zdarzeń. Dziennik zdarzeń zawiera wszystkie zdarzenia, które nastąpiły w trakcie danego wątku.

Akcja ma obecnie jeden dziennik zdarzeń, który zawiera dane wejściowe użytkownika ("Talk to my test app") i jego odpowiedź. Ten zrzut ekranu przedstawia dziennik zdarzeń:

Jeśli klikniesz strzałkę w dół w dzienniku zdarzeń, zobaczysz wydarzenia ułożone chronologicznie, które wystąpiły w danej chwili wątku:

• userInput: odpowiada danych wejściowych użytkownika ("Talk to my test app").
• interactionMatch: odpowiada głównej odpowiedzi wywołania wywoływanej przez dane wejściowe użytkownika. Jeśli rozwiniesz ten wiersz, klikając strzałkę, zobaczysz prośbę dodaną dla głównego wywołania (A wondrous greeting, adventurer!...)
• endConversation: odpowiada wybranemu przeniesieniu w intencji Main invocation, która obecnie kończy rozmowę. (Więcej informacji o przejściu znajdziesz w następnej sekcji tego ćwiczenia z ćwiczeniami.

Dzienniki zdarzeń zapewniają wgląd w działanie działania i są przydatnymi narzędziami do debugowania działania. Aby zobaczyć szczegóły wydarzenia, kliknij strzałkę obok nazwy wydarzenia, jak pokazano na tym zrzucie ekranu:

4. Utwórz wątek akcji

Po zdefiniowaniu tego, co dzieje się po wywołaniu działania użytkownika przez użytkownika, możesz stworzyć pozostałą część rozmowy, którą chcesz przeprowadzić. Zanim przejdziesz do tych ćwiczeń z programowania, zapoznaj się z tymi terminami, aby zrozumieć, jak działa rozmowa Akcji:

Kluczowe terminy:

• Sceneria: element składowy akcji, który przetwarza dane wejściowe użytkownika i zazwyczaj generuje odpowiedź. Zamiary użytkowników często aktywują inne sceny, ale mogą też zostać aktywowane w inny sposób.
• Intencja użytkownika: definiuje dane wejściowe użytkownika zrozumiałe dla działania. Definiujesz wyrażenia na potrzeby trenowania przeznaczone do tych intencji. Gdy użytkownik mówi o tym, co pasuje do wyrażenia treningowego lub do niego podobnego, odpowiednia intencja jest dopasowywana.
• Wyrażenia na potrzeby trenowania: przykłady tego, co użytkownik może powiedzieć, żeby dopasować się do intencji. Mechanizm rozumienia języka naturalnego (NLU) w naturalny sposób rozszerza te wyrażenia treningowe, dodając do nich inne podobne wyrażenia.
• Przejście: definiuje scenę, na którą chcesz przejść po spełnieniu warunku.

Akcja może zawierać jeden lub więcej scen, a każde z nich musi zostać aktywowane. (Akcję, którą tworzysz w tym ćwiczeniu z programowania, masz tylko 1 scenę zatytułowaną Start). Najpopularniejszym sposobem aktywowania sceny jest skonfigurowanie akcji tak, że gdy użytkownik pasuje do intencji użytkownika w danej scenie, intencja ta uruchamia przejście do innej sceny i ją aktywuje.

Wyobraź sobie hipotetyczne działanie, które dostarcza użytkownikowi informacji o zwierzętach. Gdy użytkownik wywoła tę akcję, intencja Main invocation zostanie dopasowana i wywoła przejście do sceny o nazwie Facts. To przejście aktywuje scenę Facts, która wysyła do użytkownika następujący komunikat: Would you like to hear a fact about cats or dogs? W scenie Facts jest intencja użytkownika o nazwie Cat, która zawiera wyrażenia treningowe, które użytkownik może wypowiedzieć, aby usłyszeć kotowy fakt, np. "Chcę usłyszeć kotowy fakt." lub "kot". Gdy użytkownik prosi o usłyszenie kota, intencja Cat jest dopasowywana i wywołuje przejście do sceny o nazwie Cat fact. Scena Cat fact włączy się i wyśle do użytkownika prośbę o dodanie informacji o kocie.

Rysunek 1. Przebieg typowej rozmowy w akcji zbudowanej w Kreatorze działań

Scenorys, intencje i przejścia stanowią całość logiki rozmowy i określają różne ścieżki, jaki może prowadzić użytkownik w ramach rozmowy „Akcja”. W poniższej sekcji możesz utworzyć scenę i określić sposób jej aktywacji po wywołaniu przez użytkownika akcji.

Przejście z głównego wywołania do sceny

W tej sekcji utworzysz nową scenę o nazwie Start, która będzie wysyłała do użytkowników pytanie, czy chcą otrzymać szczęście. Możesz też dodać przejście z głównego wywołania do nowej sceny Start.

Aby utworzyć tę scenę i dodać do niej przejście, wykonaj te czynności:

1. Na pasku nawigacyjnym kliknij Programowanie.
2. Kliknij Główne wywołanie na bocznym pasku nawigacyjnym.
3. W sekcji Przejście kliknij menu i wpisz Start w polu tekstowym.

4. Kliknij Dodaj. Spowoduje to utworzenie sceny o nazwie Start i informację o tym, jak po wyświetleniu komunikatu Działanie użytkownik zobaczy komunikat powitalny od użytkownika wyświetlany Start.
5. Kliknij Sceny na bocznym pasku nawigacyjnym, aby wyświetlić listę scen.
6. W sekcji Sceny kliknij Rozpocznij, by zobaczyć punkt widokowy Start.
7. Kliknij + w sekcji On Enter (Włącz) na scenie Start.
8. Wybierz Wyślij monity.
9. Zamień zdanie w polu speech (Enter the response that users will see or hear...) na pytanie użytkownika: Before you continue on your quest, would you like your fortune told?

10. Kliknij Zapisz.

Gdy Google wejdzie na scenę w usłudze Start, Asystent Google wyświetli ten komunikat (Before you continue on your quest...).

Dodaj elementy propozycji

Elementy propozycji oferują sugestie kliknięć, które są przetwarzane przez działanie użytkownika jako dane wejściowe. W tej sekcji dodasz elementy z sugestią, aby wspierać użytkowników na urządzeniach z ekranami.

Aby dodać elementy propozycji do sceny Start, wykonaj te czynności:

1. Na scenie Start kliknij sugestie. To działanie spowoduje dodanie pojedynczego elementu sugestii.
2. W polu title zastąp Suggested Response wartością 'Yes'.
3. Przy użyciu tego samego formatowania ręcznie dodaj element sugestii o nazwie 'No'. Twój kod powinien wyglądać tak:

    suggestions:
      - title: 'Yes'
      - title: 'No'

4. Kliknij Zapisz.

Testowanie działania w symulatorze

W tym momencie Twoje działanie powinno zostać przeniesione z głównego wywołania do sceny Start i zapytać użytkownika, czy ma mu się wyświetlić wróżba. Proponowane elementy powinny się też wyświetlać na wyświetlaczu symulowanym.

Aby przetestować działanie w symulatorze, wykonaj te czynności:

1. Aby przejść do symulatora, na pasku nawigacyjnym kliknij Test.
2. Aby przetestować działanie w symulatorze, wpisz Talk to my test app w polu Dane wejściowe i naciśnij Enter. Akcja powinna wyświetlić się w polu Main invocation, a na ekranie – w sekcji Start. Będzie to "Before you continue on your quest, would you like your fortune told?".

Poniższy zrzut ekranu przedstawia tę interakcję:

Logi zdarzeń rejestrują każdą interakcję symulatora w obecnej sesji, więc dziennik zdarzeń z testów wykonanych wcześniej w tym ćwiczeniu z programowania jest widoczny jako pierwszy. Aby wyczyścić dzienniki zdarzeń, kliknij Resetuj test.

3. Kliknij element Yes lub No sugestii, by odpowiedzieć na powiadomienie. (Możesz też powiedzieć "Tak" lub "Nie" albo wpisać Yes albo No w polu Dane wejściowe).

W odpowiedzi na komunikat Akcja przekazuje komunikat z informacją, że nie może zrozumieć wprowadzonych danych: "Przykro mi, nie rozumiem. Spróbuj ponownie. Akcja nie została jeszcze skonfigurowana tak, by rozumieć odpowiedź typu "Yes" lub "No" i dlatego odpowiada na intencję NO_MATCH.

Kluczowe terminy:

• NO_MATCH: intencja ogólna, która jest dopasowywana, gdy użytkownik podpowie coś, co nie może zostać dopasowane do innej intencji w Twojej akcji.
• Zamiar systemu: zamiar skonfigurowany domyślnie, który obsługuje typowe zdarzenia systemowe, np. gdy użytkownik nie poda danych wejściowych. NO_MATCH i intencja związana z głównym wywołaniem to przykładowe intencje systemowe.

Domyślnie intencja systemowa NO_MATCH podaje ogólne odpowiedzi, ale możesz dostosować te odpowiedzi, aby wskazać użytkownikowi, że nie znasz jego danych wejściowych. Asystent kończy rozmowę z Twoją akcją, gdy nie może ona trzykrotnie dopasować danych wejściowych użytkownika.

Dodaj intencje yes i no

Dzięki temu, że użytkownicy mogą odpowiedzieć na pytanie, które wydaje akcja, możesz skonfigurować akcję tak, aby zrozumiała odpowiedzi użytkowników ("Tak" lub "Nie"). W następnych sekcjach utworzysz intencje użytkownika pasujące do polecenia "Yes" lub "No" i dodasz je do sceny Start.

Utwórz yes intencję

Aby utworzyć intencję yes:

1. Na pasku nawigacyjnym kliknij Programowanie.
2. Kliknij Custom Intents (Intencje niestandardowe) na pasku nawigacyjnym, aby otworzyć listę intencji.
3. Kliknij + (znak plusa) na końcu listy intencji.
4. Nazwij nową intencję yes i naciśnij Enter.
5. Kliknij intencję yes, aby otworzyć stronę intencji yes.
6. W sekcji Dodaj wyrażenia szkoleniowe kliknij pole tekstowe Wpisz wyrażenie i wpisz następujące wyrażenia:

• Yes
• Y
• I would
• Tell me

7. Kliknij Zapisz.

Dodaj intencję yes do sceny Start

Akcja może teraz zrozumieć, kiedy użytkownik wyraża intencję "yes". Możesz dodać intencję użytkownika yes do sceny Start, ponieważ użytkownik odpowiada na powiadomienie Start.

Aby dodać tę intencję użytkownika do sceny Start:

1. Kliknij scenę Rozpocznij na pasku nawigacyjnym.
2. Kliknij + (znak plus) na scenie Start obok pozycji Obsługa intencji użytkownika.
3. Wybierz yes (tak) w menu intencji.

4. Kliknij Wyślij monity i wpisz w polu speech ten tekst: Your future depends on the aid you choose to use for your quest. Choose wisely! Farewell, stranger.

Kod w edytorze powinien wyglądać tak:

candidates:
  - first_simple:
      variants:
        - speech: >-
            Your future depends on the aid you choose to use for your quest. Choose
            wisely! Farewell, stranger.

5. W sekcji Przejście kliknij menu i wybierz Zakończ rozmowę.
6. Kliknij Zapisz.

Testowanie intencji yes w symulatorze

Na tym etapie akcja wie, kiedy użytkownik chce poznać szczęście, i zwraca odpowiednią odpowiedź.

Aby to zrobić, wykonaj te czynności w symulatorze:

1. Na pasku nawigacyjnym kliknij Przetestuj.
2. Aby przetestować działanie w symulatorze, wpisz Talk to my test app w polu Dane wejściowe i naciśnij Enter.
3. Wpisz Yes w polu Dane wejściowe i naciśnij Enter. Możesz też kliknąć element Tak w sugestii.

Akcja reaguje na użytkownika i powiadamia mu o oferowaniu, w zależności od wybranej pomocy. Akcja kończy sesję, ponieważ wybrano przejście End conversation do intencji yes.

Utwórz no intencję

Teraz musisz utworzyć intencję no, aby zrozumieć i zareagować, gdy użytkownik nie chce poznać wróżby. Aby to zrobić:

1. Na pasku nawigacyjnym kliknij Programowanie.
2. Kliknij Custom Intents (Intencje niestandardowe) na pasku nawigacyjnym, aby otworzyć listę intencji.
3. Kliknij + (znak plusa) na końcu listy intencji.
4. Nazwij nową intencję no i naciśnij Enter.
5. Kliknij nie, aby otworzyć stronę **no**zamiar.
6. W sekcji Dodaj wyrażenia szkoleniowe kliknij w polu tekstowym Wpisz wyrażenie i wpisz następujące wyrażenia:

• No
• N
• I don't want
• nope

7. Kliknij Zapisz.

Dodaj intencję no do sceny Start

Czynność może teraz zrozumieć, kiedy użytkownik wyraża wyrażenie "no" lub podobne w ten sposób: "no", na przykład "nope". Musisz dodać intencję użytkownika no do sceny Start, bo użytkownik odpowiada na komunikat Start ("Zanim przejdziesz dalej, czy chcesz, aby Twoja wróżka powiedziała:).

Aby dodać ten zamiar do sceny Start, wykonaj te czynności:

1. Kliknij scenę Rozpocznij na pasku nawigacyjnym.
2. Kliknij + (znak plus) na scenie Start obok pozycji Obsługa intencji użytkownika.
3. W sekcji Podobne zamiary wybierz z menu nie.

4. Kliknij Wyślij monity.
5. W polu speech dodaj następujący tekst: I understand, stranger. Best of luck on your quest! Farewell..

Kod w edytorze powinien wyglądać tak:

 candidates:
  - first_simple:
      variants:
        - speech: >-
             I understand, stranger. Best of luck on your quest! Farewell.

6. W sekcji Przejście wybierz z menu Zakończ rozmowę.
7. Kliknij Zapisz.

Testowanie intencji no w symulatorze

Na tym etapie akcja rozumie, kiedy użytkownik nie chce poznać wróżby, i zwraca odpowiednią odpowiedź.

Aby to zrobić, wykonaj te czynności w symulatorze:

1. Na pasku nawigacyjnym kliknij Przetestuj.
2. Wpisz Talk to my test app w polu Dane wejściowe i naciśnij Enter.
3. Wpisz No w polu Dane wejściowe i naciśnij Enter. Możesz też kliknąć element Nie.

Akcja nie polega na przysługiwaniu użytkownikom, lecz życzy im powodzenia w dalszej podróży. Akcja kończy sesję, ponieważ wybrano przejście End conversation do intencji no.

5. Wdrażanie realizacji

Obecnie odpowiedzi na działaniach są statyczne. Gdy scena zawierająca komunikat jest aktywowana, akcja wysyła to samo powiadomienie za każdym razem. W tej sekcji wdrożysz realizację zawierającą logikę, aby utworzyć dynamiczną odpowiedź konwersacyjną.

Kluczowe terminy:

• Realizacja: kod zawierający logikę Twojej akcji. Webhook wywołuje wywołania na podstawie realizacji zdarzeń w Twoich działaniach.

Realizacja określa, czy użytkownik jest powracającym czy nowym użytkownikiem i modyfikuje wiadomość powitalną akcji dla powracających użytkowników. Wiadomość powitalna jest skracana dla powracających użytkowników i potwierdza ich zwrot: "Niesamowite pozdrowienie, przygoda! Witamy z powrotem do mitycznego krainy Gryffinberg!"

W tym ćwiczeniu możesz używać edytora Cloud Functions w konsoli Actions, aby edytować i wdrożyć kod realizacji.

Kluczowe terminy:

• Edytor Cloud Functions: wbudowany edytor w Konsoli Actions, który umożliwia edytowanie i wdrażanie kodu realizacji za pomocą Cloud Functions dla Firebase.

Akcja może wywołać webhooka, które powiadamiają o wykonaniu zdarzenia, które występuje w wywołaniu lub podczas wykonywania określonych fragmentów sceny. Po wywołaniu webhooka akcja wysyła do realizacji żądanie żądanie z ładunkiem JSON wraz z nazwą modułu obsługi używanego do przetwarzania zdarzenia. Ten moduł obsługuje logikę i zwraca odpowiednią odpowiedź JSON.

Realizacja celów

Możesz teraz modyfikować realizację w edytorze wbudowanym, aby generować różne komunikaty o powracających i nowych użytkownikach, którzy wywołali działanie.

Aby dodać tę realizację do realizacji, wykonaj te czynności:

1. Na pasku nawigacyjnym kliknij Programowanie.
2. Kliknij kartę Webhook na pasku nawigacyjnym.
3. Zaznacz pole wyboru inline Cloud Functions.
4. Kliknij Potwierdź. W przypadku plików index.js i package.json kod zostanie automatycznie dodany.

5. Zamień zawartość index.js na ten kod:

index.js

const { conversation } = require('@assistant/conversation');
const functions = require('firebase-functions');

const app = conversation({debug: true});

app.handle('greeting', conv => {
 let message = 'A wondrous greeting, adventurer! Welcome back to the mythical land of Gryffinberg!';
 if (!conv.user.lastSeenTime) {
   message = 'Welcome to the mythical land of  Gryffinberg! Based on your clothes, you are not from around these lands. It looks like you\'re on your way to an epic journey.';
 }
 conv.add(message);
});


exports.ActionsOnGoogleFulfillment = functions.https.onRequest(app);

5. Kliknij Save Fulfillment (Zapisz realizację).
6. Kliknij Deploy Fulfillment (Wdróż realizację).

Zaczekaj kilka minut, aż Cloud Functions zapewni obsługę administracyjną i wdroży realizację zamówienia. Nad edytorem kodu powinien pojawić się komunikat Wdrażanie funkcji w Cloud Functions.... Gdy kod zostanie poprawnie wdrożony, komunikat w artykule Wdrażanie funkcji w Cloud Functions jest aktualny.

Omówienie kodu

Twoja realizacja, która korzysta z biblioteki Realizacja Google w witrynie Node.js, odpowiada na żądania HTTP wysyłane przez Asystenta Google.

W poprzednim fragmencie kodu definiujesz moduł obsługi greeting, który sprawdza, czy użytkownik już odwiedził działanie, sprawdzając właściwość lastSeenTime. Jeśli zasada lastSeenTime nie jest zdefiniowana, użytkownik jest nowy, a moduł obsługi greeting udostępnia nowe powitanie.

Zaktualizuj główne wywołanie, aby uruchomić webhooka

Po zdefiniowaniu funkcji greeting możesz skonfigurować moduł obsługi zdarzeń greeting w głównej intencji wywołania, aby akcja wiedziała, aby wywołać tę funkcję, gdy użytkownik wywoła ją.

Aby skonfigurować działanie tak, by wywoływało nowy moduł obsługi greeting, wykonaj te czynności:

1. Na pasku nawigacyjnym kliknij Główne wywołanie.
2. Wyczyść pole Wyślij potwierdzenie.
3. Zaznacz pole wyboru Zadzwoń do webhooka.
4. Dodaj pole greeting w polu tekstowym.

5. Kliknij Zapisz.

Test został zaktualizowany w głównym symulatorze

Aby przetestować działanie w symulatorze, wykonaj te czynności:

1. Aby przejść do symulatora, na pasku nawigacyjnym kliknij Test.
2. Wpisz Talk to my test app w polu Dane wejściowe i naciśnij Enter.

Ponieważ akcja została przez Ciebie przetestowana wcześniej w tym ćwiczeniu z programowania, nie jesteś nowym użytkownikiem, więc otrzymujesz następujące skrócone powitanie: "Niesamowite pozdrowienie, przygoda! Witamy z powrotem do mitycznego krainy Gryffinberg!

Sprzątnij projekt [zalecane]

Ćwiczenia z programowania na poziomie 2 – Build Actions for Google Assistant Assistant Actions (Poziom 2) – bazują na projekcie utworzonym w tym ćwiczeniu. Jeśli planujesz ćwiczenia z programowania na poziomie 2, nie usuwaj projektu. Możesz to zrobić w sekcji Czyszczenie projektu na końcu ćwiczenia z poziomu programowania 2.

Aby uniknąć ewentualnych opłat, zalecamy usunięcie projektów, których nie chcesz używać. Aby usunąć projekty utworzone w tym ćwiczeniu, wykonaj te czynności:

1. Aby usunąć projekt i zasoby Cloud, wykonaj czynności opisane w sekcji Wyłączanie (usuwanie) projektów.

Wybierz na stronie Ustawienia Google Cloud Platform odpowiedni projekt do usunięcia.

2. Opcjonalnie: aby natychmiast usunąć projekt z konsoli Actions, wykonaj czynności opisane w sekcji Usuwanie projektu. Jeśli nie wykonasz tego kroku, Twój projekt zostanie automatycznie usunięty po około 30 dniach.

6. Gratulacje!

Znasz podstawy tworzenia działań w Asystencie Google.

Omawiane zagadnienia

• Konfigurowanie projektu w Actions w konsoli Actions
• Jak dodać potwierdzenie w głównym wywołaniu, żeby użytkownicy mogli rozpocząć rozmowę z Twoją akcją
• Tworzenie interfejsu rozmowy ze scenami, intencjami, przejściami, elementami sugestii i spełnieniem
• Testowanie działania za pomocą Actions Simulator (Symulatora Actions)

Więcej informacji

Zapoznaj się z tymi materiałami, aby dowiedzieć się więcej o tworzeniu działań w Asystencie Google:

• Utwórz akcje Asystenta Google za pomocą narzędzia Action Builder (poziom 2), aby kontynuować tworzenie akcji konwersacyjnej z tego modułu
• oficjalna strona dokumentacji, która służy do programowania działań w Asystencie Google.
• Strona Actions on Google GitHub dla przykładowego kodu i bibliotek
• Oficjalna społeczność Reddit dla deweloperów pracujących z Asystentem.
• Obserwuj @ActionsOnGoogle na Twitterze, aby otrzymywać najnowsze powiadomienia (tweetuj w #AoGDevs, aby pokazać, co gromadzisz)

Ankieta dotycząca opinii

Zanim skończysz, wypełnij krótką ankietę.