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

   

   .