Tworzenie klienta Django frontendu dla aplikacji Dialogflow

W tym ćwiczeniu z programowania dowiesz się, jak utworzyć klienta Django po stronie klienta, aby zapewnić interaktywną obsługę aplikacji Dialogflow. W szczególności wykonasz te czynności:

  • Pobierz, skonfiguruj i uruchom klienta frontendowego Django.
  • Skonfiguruj punkt końcowy detectIntent Dialogflow, aby można go było wywoływać z klienta frontendu Django.
  • wdrożyć aplikację w Google Cloud w App Engine,
  • Sprawdź, czy zaproszenia w Kalendarzu są konfigurowane zgodnie z żądaniem użytkownika.

Wymagania wstępne

Zanim przejdziesz dalej, musisz ukończyć te ćwiczenia:

  1. Tworzenie harmonogramu spotkań za pomocą Dialogflow
  2. Informacje o encjach w Dialogflow
  3. Realizacja zamówień dzięki integracji Dialogflow z Kalendarzem

Czego się nauczysz

  • Konfigurowanie i uruchamianie klienta frontendowego Django dla Dialogflow
  • Wdrażanie klienta frontendu Django w Google Cloud w App Engine
  • Testowanie aplikacji Dialogflow z niestandardowego interfejsu

Co utworzysz

  • Skonfigurujesz i uruchomisz klienta frontendu Django dla Dialogflow.
  • Wdrożysz klienta frontendu Django w Google Cloud w App Engine.
  • Będziesz testować aplikację Dialogflow z tego niestandardowego frontendu.

Czego potrzebujesz

  • podstawowa znajomość języka Python,
  • Podstawowa znajomość Dialogflow

Wykorzystasz utworzoną wcześniej funkcję konwersacyjną Harmonogram spotkań i stworzysz niestandardowy interfejs aplikacji. Zbudujesz go za pomocą Django, uruchomisz i przetestujesz lokalnie, a następnie wdrożysz w App Engine.

Użytkownik wyśle żądanie spotkania za pomocą interfejsu, który wywoła interfejs Dialogflow detectIntent API, aby umówić spotkanie na wybraną datę i godzinę. Realizacja Dialogflow wyśle wtedy do Kalendarza prośbę o ustawienie odpowiedniego spotkania i zwróci użytkownikowi potwierdzenie za pomocą Dialogflow.

Wynik końcowy będzie wyglądać tak:
  1. Sklonuj repozytorium na komputer lokalny, wpisując to polecenie w lokalnym terminalu komputera: 
git clone https://github.com/priyankavergadia/Django-Dialogflow-Appointment-Scheduler.git
  1. Przejdź do katalogu zawierającego kod. Możesz też pobrać próbkę jako plik ZIP i ją rozpakować.
cd Django-Dialogflow-Appointment-Scheduler

Po wdrożeniu aplikacja używa serwera proxy Cloud SQL wbudowanego w środowisko standardowe App Engine do komunikacji z instancją Cloud SQL. Aby jednak przetestować aplikację lokalnie, musisz zainstalować i użyć lokalnej kopii serwera proxy Cloud SQL w środowisku programistycznym. Więcej informacji znajdziesz w artykule Informacje o serwerze proxy Cloud SQL.

Aby wykonywać podstawowe zadania administracyjne na instancji Cloud SQL, możesz użyć klienta Cloud SQL for MySQL.

Instalowanie Cloud SQL Proxy

Pobierz i zainstaluj serwer proxy Cloud SQL. Serwer proxy Cloud SQL służy do łączenia się z instancją Cloud SQL podczas uruchamiania lokalnego.

Pobierz serwer proxy.

curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64

Ustaw plik serwera proxy jako wykonywalny.

chmod +x cloud_sql_proxy

Tworzenie instancji Cloud SQL

  1. Utwórz instancję Cloud SQL for MySQL drugiej generacji. Nazwij instancję „polls-instance” lub podobnie. Przygotowanie instancji może potrwać kilka minut. Gdy będzie gotowa, powinna być widoczna na liście instancji.
  2. Użyj narzędzia gcloud, aby uruchomić to polecenie, gdzie [YOUR_INSTANCE_NAME] to nazwa instancji. Zapisz wartość wyświetlaną w przypadku nazwy połączenia instancji, która będzie potrzebna w następnym kroku. Jest ona podana w formacie [PROJECT_NAME]:[REGION_NAME]:[INSTANCE_NAME].
gcloud sql instances describe [YOUR_INSTANCE_NAME]

Możesz też kliknąć instancję, aby wyświetlić Nazwę połączenia instancji.

Inicjowanie instancji Cloud SQL

Uruchom serwer proxy Cloud SQL, używając nazwy połączenia instancji z poprzedniego kroku. Zastąp [YOUR_INSTANCE_CONNECTION_NAME] wartością zapisaną w poprzednim kroku. Ustanawia to połączenie między komputerem lokalnym a instancją na potrzeby testów lokalnych. Podczas testowania aplikacji lokalnie serwer proxy Cloud SQL powinien być uruchomiony.

./cloud_sql_proxy -instances="[YOUR_INSTANCE_CONNECTION_NAME]"=tcp:3306

Następnie utwórz nowego użytkownika i bazę danych Cloud SQL.

  1. Utwórz nową bazę danych za pomocą konsoli Google Cloud dla instancji Cloud SQL o nazwie polls-instance. Możesz na przykład wpisać „ankiety”.
  2. Utwórz nowe konto użytkownika w konsoli Google Cloud dla instancji Cloud SQL o nazwie polls-instance.

Konfigurowanie ustawień bazy danych

  1. Otwórz plik mysite/settings.py do edycji.
  2. W 2 miejscach zastąp [YOUR-USERNAME] i [YOUR-PASSWORD] nazwą użytkownika i hasłem bazy danych utworzonymi w poprzedniej sekcji. Pomaga to skonfigurować połączenie z bazą danych na potrzeby wdrożenia w App Engine i testowania lokalnego.
  3. W wierszu ‘HOST': ‘cloudsql/ [PROJECT_NAME]:[REGION_NAME]:[INSTANCE_NAME],' zastąp [PROJECT_NAME]:[REGION_NAME]:[INSTANCE_NAME] wartością zapisaną w poprzedniej sekcji.
  4. Uruchom to polecenie i skopiuj wartość nazwy połączenia instancji, która pojawi się w danych wyjściowych. Będzie ona potrzebna w następnym kroku.
gcloud sql instances describe [YOUR_INSTANCE_NAME]
  1. Zastąp [YOUR-CONNECTION-NAME] wartością zapisaną w poprzedniej sekcji.
  2. Zastąp [YOUR-DATABASE] nazwą wybraną w poprzedniej sekcji.
# [START db_setup]
if os.getenv('GAE_APPLICATION', None):
    # Running on production App Engine, so connect to Google Cloud SQL using
    # the unix socket at /cloudsql/<your-cloudsql-connection string>
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.mysql',
            'HOST': '/cloudsql/[PROJECT_NAME]:[REGION_NAME]:[INSTANCE_NAME]',
            'USER': '[YOUR-USERNAME]',
            'PASSWORD': '[YOUR-PASSWORD]',
            'NAME': '[YOUR-DATABASE]',
        }
    }
else:
    # Running locally so connect to either a local MySQL instance or connect to
    # Cloud SQL via the proxy. To start the proxy via command line:
    #     $ cloud_sql_proxy -instances=[INSTANCE_CONNECTION_NAME]=tcp:3306
    # See https://cloud.google.com/sql/docs/mysql-connect-proxy
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.mysql',
            'HOST': '127.0.0.1',
            'PORT': '3306',
            'NAME': '[YOUR-DATABASE]',
            'USER': '[YOUR-USERNAME]',
            'PASSWORD': '[YOUR-PASSWORD]'
        }
    }
# [END db_setup]
  1. Zamknij i zapisz settings.py.
  1. W konsoli Dialogflow kliknij . Na karcie Ogólne obok pozycji Identyfikator projektu kliknij Google Cloud.
  2. Kliknij Menu nawigacyjne ☰ > Interfejsy API i usługi > Dane logowania.
  3. Kliknij Utwórz dane logowania > Konto usługi.
  4. W sekcji Szczegóły konta usługi wpisz „appointment-scheduler” jako Nazwę konta usługi, a następnie kliknij Utwórz.

  1. W sekcji Przyznaj temu kontu usługi dostęp do projektu kliknij Dalej, aby pominąć ten krok.
  2. W sekcji Przyznaj użytkownikom dostęp do tego konta usługi (opcjonalnie) kliknij Utwórz klucz > JSON > Utwórz.

Na komputer zostanie pobrany plik JSON, który będzie potrzebny w kolejnych sekcjach konfiguracji.
  1. W folderze chat zastąp AppointmentScheduler.json plikiem JSON z danymi logowania.
  2. W pliku views.py w folderze czatu zmień GOOGLE_PROJECT_ID = "<YOUR_PROJECT_ID>" na identyfikator projektu.

Aby uruchomić aplikację Django na komputerze lokalnym, musisz skonfigurować środowisko programistyczne Pythona, w tym Python, pip i virtualenv. Instrukcje znajdziesz w artykule Konfigurowanie środowiska programistycznego w Pythonie.

  1. Utwórz izolowane środowisko Pythona i zainstaluj zależności:
virtualenv env
source env/bin/activate
pip install -r requirements.txt
  1. Uruchom migracje Django, aby skonfigurować modele.
python3 manage.py makemigrations
python3 manage.py makemigrations polls
python3 manage.py migrate
  1. Uruchom lokalny serwer WWW.
python3 manage.py runserver
  1. W przeglądarce wpisz http://localhost:8000/. Powinna wyświetlić się prosta strona internetowa, jak na tym zrzucie ekranu:

Strony aplikacji przykładowej są dostarczane przez serwer WWW Django działający na Twoim komputerze. Gdy wszystko będzie gotowe, naciśnij Control+S (Command+S na komputerze Macintosh), aby zatrzymać lokalny serwer WWW.

Uruchom to polecenie, aby przenieść wszystkie pliki statyczne aplikacji do folderu określonego przez STATIC_ROOT w settings.py:

python3 manage.py collectstatic

Prześlij aplikację, uruchamiając to polecenie w katalogu aplikacji, w którym znajduje się plik app.yaml:

gcloud app deploy

Poczekaj na komunikat z informacją o zakończeniu aktualizacji.

W przeglądarce wpisz https://<your_project_id>.appspot.com.

Tym razem Twoje żądanie jest obsługiwane przez serwer WWW działający w standardowym środowisku App Engine.

Polecenie app deploy wdraża aplikację zgodnie z opisem w app.yaml i ustawia nowo wdrożoną wersję jako domyślną, co powoduje, że obsługuje ona cały nowy ruch.

Otwórz stronę https://<your_project_id>.appspot.com i wpisz:

  1. Użytkownik: „Umów mnie na jutro na godzinę 15:00 na rejestrację pojazdu”.
  2. Chatbot odpowie w ten sposób:

  1. Kalendarz zarezerwuje odpowiedź.

Jeśli planujesz ukończyć inne samouczki Dialogflow, na razie pomiń tę część i wróć do niej później.

Usuwanie agenta Dialogflow

  1. Kliknij  obok istniejącego agenta.
  2. Na karcie Ogólne przewiń do dołu i kliknij Usuń tego agenta.
  3. W wyświetlonym oknie wpisz Usuń i kliknij Usuń.

Czatbot został utworzony w Dialogflow i zintegrowany z Kalendarzem. Jesteś teraz deweloperem chatbotów.

Więcej informacji

Więcej informacji znajdziesz w tych materiałach: