Krótki przewodnik po pakiecie Actions SDK i Kreatorze

Z tego przewodnika dowiesz się, jak skonfigurować środowisko do tworzenia akcji za pomocą SDK Actions i Actions Builder. Wykonasz te zadania:

  • Zainstaluj Node.js: aby korzystać ze środowiska Node.js, musisz mieć to środowisko wykonawcze. w bibliotece realizacji zamówień.
  • Zainstaluj interfejs wiersza poleceń Firebase: to narzędzie wiersza poleceń pozwala tworzyć wdrażanie zależności Firebase, takich jak aplikacje internetowe, na potrzeby interaktywnego obszaru roboczego, Hosting Firebase.
  • Instalowanie narzędzia wiersza poleceń gactions: podczas programowania za pomocą polecenia Actions SDK, za pomocą tego narzędzia możesz tworzyć i wdrażać pakiet akcji dla akcję.
  • Tworzenie projektu w Actions: projekt w Actions jest kontenerem logicznym. dotyczące akcji konwersacyjnych. Musisz je utworzyć w Konsoli Actions, zanim mogą zacząć tworzyć.
  • Zainicjuj i wdróż przykład: ten prosty przykład pokazuje, jak rozpoczął tworzenie akcji opartych na Interaktywnej Canvas.

Gdy wykonasz ten krótki przewodnik, możesz zsynchronizować swój projekt w Actions między lokalnego środowiska programistycznego i środowiska internetowego Actions Builder.

Instalowanie Node.js i interfejsu wiersza poleceń Firebase

Pobierz i zainstaluj Node.js zgodnie z Node.js dokumentacji do korzystania z naszej biblioteki realizacji zamówień. Również Twoja instalacja środowiska Node.js pozwala zainstalować interfejs wiersza poleceń Firebase za pomocą npm, a później uruchamiać lokalnej implementacji realizacji konwersacyjnej.

Zainstaluj i skonfiguruj interfejs wiersza poleceń Firebase zgodnie z wymaganiami do dokumentacji Firebase. Interfejs wiersza poleceń Firebase pozwala wdrożyć aplikację internetową Canvas w Hostingu Firebase i w razie potrzeby wdrożyć ją ręcznie; do Cloud Functions dla Firebase.

Instalowanie narzędzia wiersza poleceń Gactions

Zainstaluj narzędzie interfejsu wiersza poleceń Gactions, pobierając pakietu instalacyjnego, rozpakowania go i skonfigurowania ścieżki wykonywania.

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

  1. Pobierz pakiet odpowiedni dla swojego systemu operacyjnego:

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

  2. Rozpakuj pakiet do wybranej lokalizacji i dodaj plik binarny do w zmiennej PATH środowiska. Możesz też rozpakować pakiet do lokalizacja, która znajduje się już w zmiennej PATH (np. /usr/local/bin).

  3. W systemach Linux i Mac włącz uprawnienia do uruchamiania, jeśli to konieczne:

    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ń uwierzytelnia się automatycznie.

Tworzenie i konfigurowanie projektu

Zanim zaczniesz korzystać z narzędzia wiersza poleceń frakcji, musisz utworzyć projekt w w Konsoli Actions i przyznaj gakcjom dostęp do projektu. Aby utworzyć i ustawić utwórz projekt, wykonaj te czynności:

  1. Otwórz konsolę działań.
  2. Kliknij New project (Nowy projekt), wpisz nazwę projektu i kliknij Create project (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 przez wykonanie tych czynności instrukcje znajdziesz w sekcji Włączanie i wyłączanie interfejsów API. Dzięki temu ułamki mogą wchodzić w interakcję z Twoim projektem.

Pobierz próbkę ze świata Hello World

Interaktywny przykład gry Hello World pokazuje, jak utworzyć proste akcje za pomocą jednej akcji korzystającej z platformy Interactive Canvas.

  1. Utwórz pusty katalog i zainicjuj przykładowy obszar interaktywny do tego katalogu. Na przykład ten kod inicjuje przykład w pliku interactive-canvas-sample/, używany jako przykład w 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ść pola projectId na identyfikator Twojego projektu.

Wdrażanie i testowanie przykładu

Po skonfigurowaniu przykładu możesz wdrożyć aplikację internetową Interactive Canvas w projekcie Actions. Ten proces spowoduje utworzenie wersji roboczej działań. projekt, który możesz wdrożyć w Actions Simulator (Symulatorze Actions) na potrzeby wyświetlania podglądu i testowania:

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

    firebase deploy --project PROJECT_ID --only hosting

    Możesz zobaczyć wyrenderowaną wersję aplikacji internetowej pod adresem URL zwróconym przez funkcję 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 Twojego projektu.

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

  3. W katalogu interactive-canvas-sample/sdk/ uruchom następujące polecenie aby przekazać lokalną wersję projektu Actions do konsoli jako wersja robocza:

    gactions push

  4. W katalogu interactive-canvas-sample/sdk/ uruchom następujące polecenie aby przetestować projekt Actions w symulatorze:

    gactions deploy preview

  5. Otwórz link zwrócony przez narzędzie wiersza poleceń, by przejść do symulatora.

  6. W symulatorze wpisz "Talk to Interactive Canvas sample", aby uruchomić działanie. Ty zobaczysz obracający się trójkąt zasilany przez aplikację internetową https://PROJECT_ID.web.app

    Rysunek 1. Symulator wyświetlający podgląd projektu Actions
    .