Krótki przewodnik po pakiecie Actions SDK i Kreatorze

Z tego przewodnika dowiesz się, jak skonfigurować środowisko do tworzenia działań za pomocą pakietu Actions SDK i Actions Builder. Wykonaj te czynności:

  • Zainstaluj Node.js: to środowisko wykonawcze jest potrzebne, aby korzystać z naszej biblioteki realizacji Node.js.
  • Zainstaluj interfejs wiersza poleceń Firebase: to narzędzie wiersza poleceń umożliwia tworzenie i wdrażanie zależności Firebase, takich jak aplikacje internetowe dla interaktywnego obszaru roboczego, w Hostingu Firebase.
  • Zainstaluj narzędzie wiersza poleceń gactions: podczas programowania za pomocą pakietu SDK Actions możesz za pomocą tego narzędzia tworzyć i wdrażać pakiet Action dla akcji, a także nim zarządzać.
  • Utwórz projekt Actions: projekt Actions to logiczny kontener na potrzeby działań związanych z rozmowami. Zanim zaczniesz tworzyć treści, musisz je utworzyć w Konsoli Actions.
  • Zainicjuj i wdróż przykład: ten prosty przykład pokazuje, jak rozpocząć tworzenie działań opartych na interaktywnym obszarze roboczym.

Po wykonaniu tego krótkiego wprowadzenia możesz zsynchronizować projekt Actions między swoim lokalnym środowiskiem programistycznym a interfejsem internetowym Actions Builder.

Zainstaluj Node.js i interfejs wiersza poleceń Firebase

Pobierz i zainstaluj Node.js zgodnie z dokumentacją Node.js, aby użyć naszej biblioteki realizacji. Instalacja środowiska Node.js umożliwia też zainstalowanie interfejsu wiersza poleceń Firebase z npm, a później do lokalnego uruchamiania konwersacyjnej realizacji zamówień.

Zainstaluj i skonfiguruj interfejs wiersza poleceń Firebase zgodnie z dokumentacją Firebase. Interfejs wiersza poleceń Firebase umożliwia wdrożenie interaktywnej aplikacji internetowej Canvas w Hostingu Firebase i – w razie potrzeby – ręczne wdrożenie realizacji w Cloud Functions dla Firebase.

Zainstaluj narzędzie wiersza poleceń gactions

Zainstaluj narzędzie wiersza poleceń (CLI) interfejsu gactions, pobierając pakiet instalacyjny, rozpakowując go i konfigurując ścieżkę wykonania.

Aby zainstalować i skonfigurować interakcje, wykonaj te czynności:

  1. Pobierz pakiet odpowiedni dla używanego systemu operacyjnego:

    Platforma Pakiet Suma kontrolna
    Windows Pobierz SHA256
    Linux Pobierz SHA256
    System operacyjny macOS Pobierz SHA256

  2. Wyodrębnij pakiet do wybranej lokalizacji i dodaj plik binarny do zmiennej PATH środowiska. Możesz też wyodrębnić pakiet do lokalizacji, która jest już w zmiennej PATH (np. /usr/local/bin).

  3. W systemie Linux i na Macu włącz w razie potrzeby uprawnienia do wykonywania:

    chmod +x PATH_TO/gactions

  4. Uruchom to polecenie, aby uwierzytelnić interfejs wiersza poleceń. To polecenie uruchamia proces uwierzytelniania i wymaga przeglądarki:

    gactions login

    Po zakończeniu procesu interfejs wiersza poleceń automatycznie się uwierzytelni.

Tworzenie i konfigurowanie projektu

Aby korzystać z narzędzia wiersza poleceń gactions, musisz utworzyć projekt w konsoli Actions i przyznać gacjom dostęp do projektu. Aby utworzyć i skonfigurować projekt:

  1. Otwórz Konsolę Actions.
  2. Kliknij Nowy projekt, wpisz nazwę projektu i kliknij Utwórz projekt.
  3. Wybierz kategorię i kliknij Dalej.
  4. Wybierz Pusty projekt i kliknij Rozpocznij tworzenie.
  5. Włącz Actions API w konsoli Google Cloud zgodnie z instrukcjami podanymi w artykule Włączanie i wyłączanie interfejsów API. Dzięki temu mogą wchodzić w interakcje z Twoim projektem.

Pobierz fragment Hello World

Z interaktywnego przykładu aplikacji Hello World dowiesz się, jak utworzyć prosty projekt w Actions za pomocą pojedynczej akcji korzystającej z interaktywnego obszaru roboczego.

  1. Utwórz pusty katalog i zainicjuj w nim próbkę Interactive Canvas. Na przykład ten kod inicjuje próbkę w katalogu interactive-canvas-sample/, który jest używany jako przykład w całym tym dokumencie:

    gactions init interactive-canvas --dest interactive-canvas-sample
cd interactive-canvas-sample

  2. Otwórz plik interactive-canvas-sample/sdk/settings/settings.yaml i zmień wartość w polu projectId na identyfikator projektu.

Wdróż i przetestuj przykład

Po skonfigurowaniu przykładu możesz wdrożyć aplikację internetową Interactive Canvas i swój projekt Actions. Ten proces tworzy wersję roboczą projektu w Actions, którą możesz wdrożyć w Actions Simulator (Symulatorze Actions), aby wyświetlać podgląd i testować:

  1. W katalogu interactive-canvas-sample/ uruchom poniższe polecenie, aby wdrożyć aplikację internetową Interactive Canvas (zawartość katalogu public/).

    firebase deploy --project PROJECT_ID --only hosting

    Wyrenderowaną wersję aplikacji internetowej możesz zobaczyć pod adresem URL zwróconym przez interfejs wiersza poleceń Firebase w przeglądarce: https://PROJECT_ID.web.app.

  2. Otwórz plik interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js i zmień wartość zmiennej CANVAS_URL na adres URL aplikacji internetowej projektu.

    const CANVAS_URL = 'https://PROJECT_ID.web.app';

  3. Z katalogu interactive-canvas-sample/sdk/ uruchom to polecenie, aby przekazać lokalną wersję projektu Actions do konsoli jako wersję roboczą:

    gactions push

  4. W katalogu interactive-canvas-sample/sdk/ uruchom to polecenie, aby przetestować projekt Actions w symulatorze:

    gactions deploy preview

  5. Otwórz link zwracany przez narzędzie wiersza poleceń, aby przejść do symulatora.

  6. W symulatorze wpisz „Talk to Interactive Canvas sample”, aby rozpocząć działanie. Powinno pojawić się obracający się trójkąt z aplikacją internetową wdrożonym pod adresem https://PROJECT_ID.web.app

    Rysunek 1. Symulator podglądu projektu Actions