Разговорные чат-боты для общения в Telegram и Вконтакте с использованием DialogFlow
Автор проекта: Алексей Свирин, телеграм — @svirin
Цель проекта: создание автономных чат-ботов для мессенджера Телеграм и социальной сети ВКонтакте
Боты отвечают пользователю на сообщения, боты работают на одной бозе фраз, которая загружена в DialogFlow. Ботов можно быстро обучить благодаря дополнительно реализованным функциям. Также в ботах реализована отправка сообщений на отдельного бота в телеграме для ошибок.
Примечание. Если вы задете сложный вопрос для бота, то бот ничего не ответит.
Как установить
Этап 1. Получить все авторизационные ключи
Этап 1.1 Для запуска бота в Телеграме необходимо:
1) Создать бота для пользователй в telegram через Отца ботов и взять токен для авторизации. 2) Создать бота для сервисных сообщений в telegram через Отца ботов и взять токен для авторизации. 3) Узнать свой ID через специального бота.
Этап 1.2 Для запуска бота во Вконтакте необходимо:
1) Создать бота для сервисных сообщений в telegram через Отца ботов и взять токен для авторизации. 2) Узнать свой ID через специального бота. 3) Создать сообщество или выбрать из уже созданных. 4) Взять сервисный ключ в разделе "Управление" на вкладке "Работа с API" 5) Разрешить отправку сообщений на вкладке "Сообщения"
Этап 1.3 Зарегистрироваться и получить ключ авторизации для Dialogflow:
1) Зарегистрироваться на сайте сервиса. 2) Создать нового агента — нашего бота в DiaologFlow. 3) На вкладке General установить настройку V2 API и перейти по ссылке в поле 'Service Account' в единую панель управления сервисами Google для получения авторизационного ключа. 4) У вашего сервисного аккаунта необходимо создать ключ и скачать его. Этот ключ авторизации необходимо будет использовать для получения ответов от Dialogflow. 5) На вкладке IAM у вашего сервисного аккаунта установить роль 'Администратор Dialogflow API'
Этап 2. Установить переменные окружения
1) telegram_token: токен для основного телеграм-бота;
2) telegram_token_information_message: токен для сервисного телеграм-бота;
3) chat_id_information_message: id пользователя телеграм, который будет получать сервисные сообщения;
4) vk_community_token: токен для бота ВКонтакте;
5) project_id: id проекта в dialogflow, который можно взять вкладке 'General' в поле 'Project ID';
6) GOOGLE_APPLICATION_CREDENTIALS: путь для json-файла с ключом авторизации для dialogflow;
7) GOOGLE_CREDENTIALS: данную переменную необходимо использовать только, если вы используете Heroku. В данную переменную необходимо поместить содержимое json-файла авторизации для dialogflow.
Этап 3. Запустить бота
Пример запуска в консоли
python3 bot-tg.pyТребования
Все требуемые модули указаны в файле requirements.txt
Для установки запустите команду:
python3 pip install -r requirements.txtТребования к запуску на Heroku
Для запуска на Heroku необходимо: 1) Файл Procfile. В файле Procfile прописано какой файл нужно запускать на Heroku; 2) Файл Pipfile. В файлах Pipfile и reqirements.txt указаны необходимые модули для работы бота; 3) В разделе Settings добавить новый Buildpack; 4) В раздел Config Vars добавить все переменные окружения.
Как создать модель вопрос — ответ в dialogflow
Cоздание новой темы разговора
1) На вкладке Intents создать Intent. Это будет отдельной темой для бота. 2) Добавить варианты вопросов и ответов.
Создать список быстрых ответов
1) На вкладке Small Talk добавить ответы на самые популярные вопросы.
Пример автоматизации в папке Example
1) Файл example phrases.json — пример файла по которому можно построить темы разговора. 2) Файл example_create_intent.py — пример файла для парсинга файла из пункта 1. Функция create_intent — пример кода отправки данных для создания темы разговора. Обратите внимание, что API Dialogflow требует отправка ответов и вопросов в формате list.
Аргументы функции create_intent:
— project_id: id проекта, который мы получили в пункте 2.5;
— display_name: название Intent (темы диалога);
— training_phrases_parts: фразы на которые будет реагировать бот;
— message_texts: ответы для бота.