Wdrażanie realizacji (Dialogflow)

Po utworzeniu realizacji webhooka wdróż ją w środowisku produkcyjnym i połącz do Akcji. Z instrukcji poniżej dowiesz się, jak skonfigurować środowisko aby wdrożyć ją w Cloud Functions dla Firebase na potrzeby hostingu produkcyjnego. Pamiętaj jednak: możesz wybrać dowolną platformę hostingu WWW, która obsługuje żądania HTTPS odpowiedzi do hostowania realizacji.

Jeśli wdrożysz już webhooka na platformie hostingu WWW, możesz przejdź do sekcji Łączenie webhooka z akcją. Pamiętaj, że ostateczna wersja kroki w poniższym procesie różnią się w zależności od tego, czy używasz Dialogflow czy Pakiet SDK Actions.

Wdrażanie w Cloud Functions dla Firebase

  1. Pobierz i zainstaluj Node.js.

  2. Skonfiguruj i zainicjuj interfejs wiersza poleceń Firebase. Jeśli następujące polecenie zakończy się niepowodzeniem, błąd EACCES, może być konieczne zmień uprawnienia npm.

    npm install -g firebase-tools

  3. Uwierzytelnij narzędzie Firebase za pomocą konta Google:

    firebase login

  4. Przejdź do katalogu projektu Action i zainicjuj Firebase. Będziesz o wybranie funkcji interfejsu wiersza poleceń Firebase, które chcesz skonfigurować Projekt Actions. Wybierz aplikację Functions oraz inne funkcje, których możesz używać. np. Firestore, a następnie naciśnij Enter, aby potwierdzić i kontynuować:

    cd <cloud_function_dir>
firebase init

  5. Powiąż narzędzie Firebase z projektem w Actions, wybierając je za pomocą użyj klawiszy strzałek do poruszania się po liście projektów:

  6. Po wybraniu projektu narzędzie Firebase rozpocznie konfigurację funkcji. pytając, którego języka chcesz użyć. Wybierz za pomocą klawiszy strzałek Aby kontynuować, naciśnij Enter.

    === Functions Setup
    
A functions directory will be created in your project with a Node.js
package pre-configured. Functions can be deployed with firebase deploy.

? What language would you like to use to write Cloud Functions? (Use arrow keys)
> JavaScript
TypeScript

  7. Określ, czy chcesz używać ESLint do wychwytywania prawdopodobnych błędów i egzekwowania stylu wpisując Y lub N:

    ? Do you want to use ESLint to catch probable bugs and enforce style? (Y/n)

  8. Pobierz zależności projektu, wpisując w prompcie Y:

    ? Do you want to install dependencies with npm now? (Y/n)

    Po zakończeniu konfiguracji zobaczysz dane wyjściowe podobne do tych:

    ✔  Firebase initialization complete!

  9. Zainstaluj zależność actions-on-google:

    cd <cloud_function_dir>/functions
npm install actions-on-google

  10. Pobierz zależności realizacji i wdróż funkcję realizacji:

    npm install
firebase deploy --only functions

    Wdrożenie zajmuje kilka minut. Po zakończeniu zobaczysz dane wyjściowe w podobny sposób. Aby wpisać URL funkcji, potrzebujesz adresu URL funkcji Dialogflow.

    ✔  Deploy complete!
    
Project Console: https://console.firebase.google.com/project/exampleproject-123/overview
Function URL (cloudFunctionName): https://us-central1-exampleproject-123.cloudfunctions.net/cloudFunctionName

Połącz webhooka z akcją

Jeśli korzystasz z Dialogflow: w panelu Konsola Dialogflow, otwórz Fulfillment (Realizacja), przełącz przycisk Webhook (webhook) na ENABLED (WŁĄCZONY) i zastąp adres URL w polu URL zastąp adresem URL funkcji.

Jeśli używasz pakietu Actions SDK: utwórz obiekt. wewnątrz obiektu conversations, aby zadeklarować realizację w akcji. pakiet:

{
  "actions": [
    {
      "description": "Default Welcome Intent",
      "name": "MAIN",
      "fulfillment": {
        "conversationName": "myFulfillmentFunction"
      },
      "intent": {
        "name": "actions.intent.MAIN",
        "trigger": {
          "queryPatterns": [
            "talk to myFulfillmentFunction"
          ]
        }
      }
    }
  ],
  "conversations": {
    "myFulfillmentFunction": {
      "name": "myFulfillmentFunction",
      "url": "https://us-central1-myprojectname-ab123.cloudfunctions.net/cloudFunctionName"
    }
  },
  "locale": "en"
}