Создайте внешний клиент Django для приложения Dialogflow.

В этой лабораторной работе вы научитесь создавать фронтенд-клиент Django для реализации диалогового интерфейса приложения Dialogflow. В частности, вам предстоит выполнить следующие действия:

• Загрузите, настройте и запустите клиент интерфейса Django.
• Настройте конечную точку Dialogflow detectIntent для вызова из клиента интерфейса Django.
• Разверните приложение в Google Cloud на App Engine.
• Проверьте, настраиваются ли приглашения в Календарь по запросу пользователя.

Предпосылки

Прежде чем продолжить, вам необходимо выполнить следующие лабораторные работы:

1. Создайте планировщик встреч с помощью Dialogflow
2. Понимание сущностей в Dialogflow
3. Понимание выполнения заказов путем интеграции Dialogflow с Calendar

Чему вы научитесь

• Как настроить и запустить фронтенд-клиент Django для Dialogflow
• Как развернуть клиентский интерфейс Django в Google Cloud на App Engine
• Как протестировать приложение Dialogflow из пользовательского интерфейса

Что вы построите

• Вы настроите и запустите клиентский интерфейс Django для Dialogflow.
• Вы развернете клиентскую часть Django в Google Cloud на App Engine.
• Вы протестируете приложение Dialogflow из этого пользовательского интерфейса.

Что вам понадобится

• Базовое понимание Python
• Базовое понимание Dialogflow

Вы воспользуетесь ранее созданным интерфейсом диалога Appointment Scheduler и создадите собственный интерфейс для приложения. Вы создадите интерфейс на Django, запустите и протестируете его локально, а затем развернёте в App Engine.

Пользователь отправляет запрос на запись через фронтенд, который вызывает API Dialogflow detectIntent для записи на указанную дату и время. Затем Dialogflow выполняет запрос в Calendar для записи на указанную дату и время и возвращает подтверждение пользователю через Dialogflow.

Конечный результат будет выглядеть так:

1. Клонируйте репозиторий на локальный компьютер, введя следующую команду в локальном терминале вашего компьютера:

git clone https://github.com/priyankavergadia/Django-Dialogflow-Appointment-Scheduler.git

2. Перейдите в каталог с кодом. Вы также можете скачать пример в формате ZIP-архива и распаковать его.

cd Django-Dialogflow-Appointment-Scheduler

После развёртывания ваше приложение использует Cloud SQL Proxy, встроенный в стандартную среду App Engine, для взаимодействия с вашим экземпляром Cloud SQL. Однако для локального тестирования приложения необходимо установить и использовать локальную копию Cloud SQL Proxy в вашей среде разработки. Подробнее см. в разделе «О Cloud SQL Proxy» .

Для выполнения основных задач администрирования вашего экземпляра Cloud SQL вы можете использовать клиент Cloud SQL for MySQL.

Примечание: для использования прокси-сервера для подключения с локального компьютера необходимо выполнить аутентификацию инструмента командной строки gcloud.

Установите облачный SQL-прокси

Загрузите и установите Cloud SQL Proxy. Cloud SQL Proxy используется для подключения к вашему экземпляру Cloud SQL при локальной работе.

Загрузите прокси.

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

Сделайте прокси исполняемым.

chmod +x cloud_sql_proxy

Создайте экземпляр Cloud SQL

1. Создайте экземпляр Cloud SQL for MySQL второго поколения. Назовите его «polls-instance» или как-то похоже. Подготовка экземпляра может занять несколько минут. После этого он должен появиться в списке экземпляров.
2. Используйте инструмент gcloud для выполнения следующей команды, где [YOUR_INSTANCE_NAME] — имя вашего экземпляра. Запишите значение имени подключения к экземпляру для следующего шага. Оно представлено в формате [PROJECT_NAME]:[REGION_NAME]:[INSTANCE_NAME].

gcloud sql instances describe [YOUR_INSTANCE_NAME]

Кроме того, вы можете щелкнуть по экземпляру, чтобы увидеть имя соединения с ним .

Инициализируйте свой экземпляр Cloud SQL

Запустите Cloud SQL Proxy, используя имя подключения к экземпляру из предыдущего шага. Замените [YOUR_INSTANCE_CONNECTION_NAME] на значение, записанное на предыдущем шаге. Это установит соединение между вашим локальным компьютером и экземпляром для локального тестирования. Не выключайте Cloud SQL Proxy, пока вы тестируете приложение локально.

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

Затем создайте нового пользователя и базу данных Cloud SQL.

1. Создайте новую базу данных с помощью Google Cloud Console для вашего экземпляра Cloud SQL с именем polls-instance . Например, можно ввести имя «polls».
2. Создайте новую учетную запись пользователя с помощью Cloud Console для вашего экземпляра Cloud SQL с именем polls-instance .

Настройте параметры базы данных

1. Откройте mysite/settings.py для редактирования.
2. В двух местах замените [YOUR-USERNAME] и [YOUR-PASSWORD] на имя пользователя и пароль базы данных, созданные в предыдущем разделе. Это поможет настроить подключение к базе данных для развёртывания App Engine и локального тестирования.
3. В строке 'HOST': 'cloudsql/ [PROJECT_NAME]:[REGION_NAME]:[INSTAN INSTANCE_NAME]» ' [PROJECT_NAME]:[REGION_NAME]:[INSTANCE_NAME] на значение, которое вы записали в предыдущем разделе.
4. Выполните следующую команду и скопируйте полученное значение имени подключения экземпляра для следующего шага.

gcloud sql instances describe [YOUR_INSTANCE_NAME]

5. Замените [YOUR-CONNECTION-NAME] на значение, которое вы записали в предыдущем разделе.
6. Замените [YOUR-DATABASE] на имя, которое вы выбрали в предыдущем разделе.

# [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]

7. Закройте и сохраните settings.py .

1. В консоли Dialogflow нажмите На вкладке «Общие» рядом с идентификатором проекта нажмите «Google Cloud» . .
2. Нажмите Меню навигации ☰ > API и службы > Учетные данные .
3. Нажмите Создать учетные данные > Учетная запись службы .
4. В сведениях об учетной записи службы введите «appointment-scheduler» в качестве имени учетной записи службы , затем нажмите кнопку Создать .

5. Там, где указано Предоставить этой учетной записи службы доступ к проекту , нажмите Продолжить , чтобы пропустить этот шаг.
6. Там, где указано Предоставить пользователям доступ к этой учетной записи службы (необязательно) , нажмите Создать ключ > JSON > Создать .

На ваш компьютер будет загружен JSON-файл, который понадобится вам в следующих разделах настройки.

1. В папке чата замените AppointmentScheduler.json на JSON-файл с вашими учетными данными.
2. В файле views.py в папке чата измените GOOGLE_PROJECT_ID = "<YOUR_PROJECT_ID>" на идентификатор вашего проекта.

Для запуска приложения Django на локальном компьютере вам потребуется настроить среду разработки Python, включая Python, pip и virtualenv. Инструкции см. в разделе «Настройка среды разработки Python» .

1. Создайте изолированную среду Python и установите зависимости:

virtualenv env
source env/bin/activate
pip install -r requirements.txt

2. Запустите миграции Django для настройки ваших моделей.

python3 manage.py makemigrations
python3 manage.py makemigrations polls
python3 manage.py migrate

3. Запустите локальный веб-сервер.

python3 manage.py runserver

4. В веб-браузере введите http://localhost:8000/ . Вы увидите простую веб-страницу, как показано на следующем снимке экрана:

Примеры страниц приложения предоставляются веб-сервером Django, работающим на вашем компьютере. Когда будете готовы продолжить, нажмите Control+S ( Command+S на Macintosh), чтобы остановить локальный веб-сервер.

Выполните следующую команду, чтобы переместить все статические файлы приложения в папку, указанную STATIC_ROOT в settings.py :

python3 manage.py collectstatic

Загрузите приложение, выполнив следующую команду в каталоге приложения, где находится файл app.yaml :

gcloud app deploy

Дождитесь сообщения о завершении обновления.

В веб-браузере введите https://<your_project_id>.appspot.com.

На этот раз ваш запрос обслуживается веб-сервером, работающим в стандартной среде App Engine.

Команда app deploy развертывает приложение, как описано в app.yaml , и устанавливает вновь развернутую версию в качестве версии по умолчанию, заставляя ее обслуживать весь новый трафик.

Перейдите по адресу https://<your_project_id>.appspot.com и введите следующее:

1. Пользователь: «Запишитесь на регистрацию транспортного средства завтра на 15:00».
2. Чат-бот отвечает следующим образом:

3. Календарь записывает ответ.

Если вы планируете выполнить другие лабораторные работы по Dialogflow, то пропустите эту часть пока и вернитесь к ней позже.

Удалить агент Dialogflow

1. Щелкните рядом с вашим текущим агентом.

1. 
2. На вкладке Общие прокрутите вниз и нажмите Удалить этого агента .
3. Введите Delete в появившемся окне и нажмите Delete .

Вы создали чат-бота в Dialogflow и интегрировали его с Календарем. Теперь вы разработчик чат-ботов!

Узнать больше

Для получения более подробной информации ознакомьтесь со следующими ресурсами:

• Интеграция Vision API с Dialogflow
• Примеры кода на странице Dialogflow на Github