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:
Pobierz pakiet odpowiedni dla używanego systemu operacyjnego:
Platforma Pakiet Suma kontrolna Windows Pobierz SHA256 Linux Pobierz SHA256 System operacyjny macOS Pobierz SHA256 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 zmiennejPATH
(np./usr/local/bin
).W systemie Linux i na Macu włącz w razie potrzeby uprawnienia do wykonywania:
chmod +x PATH_TO/gactions
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:
- Otwórz Konsolę Actions.
- Kliknij Nowy projekt, wpisz nazwę projektu i kliknij Utwórz projekt.
- Wybierz kategorię i kliknij Dalej.
- Wybierz Pusty projekt i kliknij Rozpocznij tworzenie.
- 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.
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
Otwórz plik
interactive-canvas-sample/sdk/settings/settings.yaml
i zmień wartość w poluprojectId
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ć:
W katalogu
interactive-canvas-sample/
uruchom poniższe polecenie, aby wdrożyć aplikację internetową Interactive Canvas (zawartość katalogupublic/
).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
.Otwórz plik
interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js
i zmień wartość zmiennejCANVAS_URL
na adres URL aplikacji internetowej projektu.const CANVAS_URL = 'https://PROJECT_ID.web.app';
Z katalogu
interactive-canvas-sample/sdk/
uruchom to polecenie, aby przekazać lokalną wersję projektu Actions do konsoli jako wersję roboczą:gactions push
W katalogu
interactive-canvas-sample/sdk/
uruchom to polecenie, aby przetestować projekt Actions w symulatorze:gactions deploy preview
Otwórz link zwracany przez narzędzie wiersza poleceń, aby przejść do symulatora.
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