В этой лаборатории кода вы научитесь создавать внешний клиент Django для создания диалогового интерфейса для приложения Dialogflow. В частности, вы сделаете следующее:
- Загрузите, настройте и запустите внешний клиент Django.
- Настройте конечную точку Dialogflow detectIntent для вызова из внешнего клиента Django.
- Разверните приложение в Google Cloud на App Engine.
- Проверьте, настраиваются ли приглашения Календаря по запросу пользователя.
Предпосылки
Прежде чем продолжить, вам необходимо выполнить следующие лабораторные работы:
- Создайте планировщик встреч с Dialogflow
- Понимание сущностей в Dialogflow
- Поймите выполнение, интегрировав Dialogflow с Календарем
Что вы узнаете
- Как настроить и запустить внешний клиент Django для Dialogflow
- Как развернуть внешний клиент Django в Google Cloud на App Engine
- Как протестировать приложение Dialogflow из пользовательского интерфейса
Что вы будете строить
- Вы настроите и запустите внешний клиент Django для Dialogflow.
- Вы развернете интерфейсный клиент Django в Google Cloud на App Engine.
- Вы будете тестировать приложение Dialogflow из этого пользовательского интерфейса.
Что вам понадобится
- Базовое понимание Python
- Базовое понимание Dialogflow
Вы будете использовать ранее созданный интерфейс беседы с планировщиком встреч и создать настраиваемый интерфейс для приложения. Вы создадите внешний интерфейс с помощью Django, запустите и протестируете его локально, а затем развернете в App Engine.
Пользователь отправит запрос на встречу через интерфейс, который вызовет Dialogflow detectIntent API, чтобы назначить встречу на запрошенную дату и время. Затем выполнение Dialogflow отправит запрос в Календарь, чтобы установить соответствующую встречу, и вернет подтверждение пользователю через Dialogflow.
Конечный результат будет выглядеть так:
- Клонируйте репозиторий на свой локальный компьютер, введя эту команду в локальном терминале вашего компьютера:
git clone https://github.com/priyankavergadia/Django-Dialogflow-Appointment-Scheduler.git
- Перейдите в каталог, содержащий код. Кроме того, вы можете скачать образец в виде zip-архива и распаковать его.
cd Django-Dialogflow-Appointment-Scheduler
При развертывании ваше приложение использует прокси-сервер Cloud SQL, встроенный в стандартную среду App Engine, для связи с вашим экземпляром Cloud SQL. Однако для локального тестирования приложения необходимо установить и использовать локальную копию Cloud SQL Proxy в среде разработки. Дополнительные сведения см. в разделе О прокси-сервере Cloud SQL .
Для выполнения основных задач администрирования в вашем экземпляре Cloud SQL вы можете использовать клиент Cloud SQL для MySQL.
Установите облачный SQL-прокси
Загрузите и установите прокси-сервер Cloud SQL. Прокси-сервер Cloud SQL используется для подключения к вашему экземпляру Cloud SQL при локальном запуске.
Скачайте прокси.
curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
Сделайте прокси исполняемым.
chmod +x cloud_sql_proxy
Создайте экземпляр Cloud SQL
- Создайте экземпляр Cloud SQL для MySQL второго поколения. Назовите экземпляр «опросы-экземпляр» или что-то подобное. Подготовка экземпляра может занять несколько минут. После того, как он будет готов, он должен появиться в списке экземпляров.
- Используйте инструмент 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, пока вы тестируете приложение локально.
./cloud_sql_proxy -instances="[YOUR_INSTANCE_CONNECTION_NAME]"=tcp:3306
Затем создайте нового пользователя и базу данных Cloud SQL.
- Создайте новую базу данных с помощью Google Cloud Console для экземпляра Cloud SQL с именем polls-instance . Например, вы можете ввести «опросы» в качестве имени.
- Создайте новую учетную запись пользователя с помощью Cloud Console для своего экземпляра Cloud SQL с именем polls-instance .
Настройте параметры базы данных
- Откройте
mysite/settings.py
для редактирования. - В двух местах замените
[YOUR-USERNAME]
и[YOUR-PASSWORD]
на имя пользователя и пароль базы данных, которые вы создали в предыдущем разделе. Это помогает настроить подключение к базе данных для развертывания App Engine и локального тестирования. - В строке
'HOST': 'cloudsql/ [PROJECT_NAME]:[REGION_NAME]:[INSTAN
'
замените[PROJECT_NAME]:[REGION_NAME]:[INSTANCE_NAME]
значением, записанным в предыдущем разделе. - Выполните следующую команду и скопируйте полученное значение имени подключения к экземпляру для следующего шага.
gcloud sql instances describe [YOUR_INSTANCE_NAME]
- Замените
[YOUR-CONNECTION-NAME]
значением, которое вы записали в предыдущем разделе. - Замените
[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]
- Закройте и сохраните
settings.py
.
- В консоли Dialogflow нажмите . На вкладке Общие рядом с Идентификатором проекта нажмите Google Cloud . .
- Нажмите Меню навигации ☰ > API и службы > Учетные данные .
- Нажмите «Создать учетные данные » > «Учетная запись службы» .
- В сведениях об учетной записи службы введите «appointment-scheduler» в качестве имени учетной записи службы , затем нажмите « Создать » .
- Там, где указано «Предоставить этой учетной записи службы доступ к проекту» , нажмите «Продолжить », чтобы пропустить его.
- Там, где указано «Предоставить пользователям доступ к этой учетной записи службы (необязательно) », нажмите «Создать ключ » > «JSON » > « Создать ».
На ваш компьютер будет загружен файл JSON, который вам понадобится в следующих разделах настройки.
- В папке чата замените
AppointmentScheduler.json
файлом JSON с вашими учетными данными. - В
views.py
в папке чата изменитеGOOGLE_PROJECT_ID = "<YOUR_PROJECT_ID>"
на идентификатор вашего проекта.
Чтобы запустить приложение Django на локальном компьютере, вам необходимо настроить среду разработки Python, включая Python, pip и virtualenv. Инструкции см. в разделе «Настройка среды разработки Python» .
- Создайте изолированную среду Python и установите зависимости:
virtualenv env source env/bin/activate pip install -r requirements.txt
- Запустите миграции Django, чтобы настроить свои модели.
python3 manage.py makemigrations python3 manage.py makemigrations polls python3 manage.py migrate
- Запустите локальный веб-сервер.
python3 manage.py runserver
- В веб-браузере введите http://localhost:8000/ . Вы должны увидеть простую веб-страницу, как показано на следующем снимке экрана:
Страницы примера приложения доставляются веб-сервером Django, работающим на вашем компьютере. Когда вы будете готовы двигаться дальше, нажмите Control+S
( Command+S
на Macintosh), чтобы остановить локальный веб-сервер.
Выполните следующую команду, чтобы переместить все статические файлы приложения в папку, указанную STATIC_ROOT
в settings.py
:
python3 manage.py collectstatic
Загрузите приложение, выполнив следующую команду в каталоге приложения, где находится файл app.yaml
:
gcloud app deploy
Дождитесь сообщения о том, что обновление завершено.
В веб-браузере введите https://<идентификатор_вашего_проекта>.appspot.com.
На этот раз ваш запрос обслуживается веб-сервером, работающим в стандартной среде App Engine.
Команда app deploy
развертывает приложение, как описано в app.yaml
, и устанавливает только что развернутую версию в качестве версии по умолчанию, заставляя ее обслуживать весь новый трафик.
Перейдите на https://<your_project_id>.appspot.com и введите следующее:
- Пользователь: «Назначьте встречу для регистрации автомобиля завтра на 15:00».
- Чат-бот отвечает следующим образом:
- Календарь записывает ответ.
Если вы планируете выполнить другие лабораторные работы Dialogflow, пропустите эту часть и вернитесь к ней позже.
Удалить агент Dialogflow
- Нажмите рядом с существующим агентом.
- На вкладке « Общие » прокрутите вниз и нажмите « Удалить этого агента ».
- Введите Удалить в появившемся окне и нажмите Удалить .
Вы создали чат-бота в Dialogflow и интегрировали его с Календарем. Теперь вы разработчик чат-бота!
Учить больше
Ознакомьтесь со следующими ресурсами, чтобы узнать больше:
- Интегрируйте Vision API с Dialogflow
- Примеры кода на странице Dialogflow Github