microsoftbotframework

Microsoft Bot Framework

Microsoft Bot Framework — это оболочка Microsoft Bot API от Microsoft. Он использует Flask для получения почтовых сообщений от Microsoft и Celery для выполнения асинхронных задач.

Целью было создать действительно простую в использовании библиотеку, позволяющую взаимодействовать с платформой ботов Microsoft.

Полную документацию можно найти здесь: http://microsoftbotframework.readthedocs.io/.

Чтобы запустить это приложение с помощью локального симулятора

Загрузите и запустите симулятор по адресу: https://docs.botframework.com/en-us/tools/bot-framework-emulator/.

Установить библиотеку

 pip install microsoftbotframework

Определить задачу

Создайте файл в корневом каталоге с именем Tasks.py. В файле определите задачу следующим образом. Дополнительную информацию об объекте ReplyToActivity и других объектах можно найти по адресу http://microsoftbotframework.readthedocs.io/en/latest/conversationoperations/.

 from microsoftbotframework import ReplyToActivity

def echo_response ( message ):
    if message [ "type" ] == "message" :
        ReplyToActivity ( fill = message ,
                        text = message [ "text" ]). send ()

Создайте основной файл

 from microsoftbotframework import MsBot
from tasks import *

bot = MsBot ()
bot . add_process ( echo_response )

if __name__ == '__main__' :
    bot . run ()

Запустите свое приложение

 python main.py

Подключитесь к своему боту

По умолчанию приложение запускается по адресу http://localhost:5000/api/messages.

Введите этот адрес в поле Введите URL-адрес конечной точки эмулятора.

Начни общаться! Если вы следовали приведенным выше инструкциям, он должен повторить то, что вы вводите.

Чтобы запустить это приложение с помощью платформы онлайн-ботов

Чтобы взаимодействовать с платформой ботов Microsoft, вам необходимо иметь конечную точку https с выходом в Интернет и действительным сертификатом. В этом руководстве будет показано, как использовать Gunicorn и Heroku для размещения приложения, но вы можете легко использовать любой вариант хостинга wsgi, поскольку объект MsBot расширяет Flask.

Создайте чат-бота Microsoft

Перейдите на https://dev.botframework.com/bots. Зарегистрируйте бота и сгенерируйте «Идентификатор приложения Microsoft» и «Секрет приложения Microsoft». Не беспокойтесь о конечной точке обмена сообщениями, мы скоро ее создадим. Создайте файл config.yaml в корне вашего проекта и поместите следующую информацию:

 other :
    app_client_id : 
    app_client_secret :  

Публикация в Heroku

Создайте файл с именем require.txt и добавьте следующее.

 microsoftbotframework
gunicorn

Создайте файл с именем «Procfile» и добавьте следующее. Мы собираемся использовать Gunicorn в качестве веб-сервера. Вы можете удалить «--log-level INFO» или установить для него более низкий уровень для производства.

 web: gunicorn -b '0.0.0.0:'$PORT --log-level INFO main:bot

Создайте файл с именем runtime.txt и добавьте следующее.

 python-3.6.0

Если вы еще не установили git

sudo apt-get install git

Зарегистрируйте учетную запись Heroku здесь: https://www.heroku.com/ и создайте новое приложение. Следуйте инструкциям по развертыванию с помощью Heroku Git.

Вернитесь на вкладку Microsoft MyBots и обновите конечную точку обмена сообщениями, чтобы она стала доменом, найденным на вкладке настроек Heroku. Обязательно добавьте «/api/messages» в URL-адрес.

Поздравляем, теперь вы сможете общаться со своим ботом в Skype!

Запуск тестов этой библиотеки

1. Убедитесь, что у вас установлены необходимые библиотеки из раздела setup.pytest_require с помощью pip install -e .[test]
2. Убедитесь, что Redis и mongodb установлены локально.
3. Включите Redis: redis-server
4. Включите монгобд: mongod
5. Откройте терминал в корне этого каталога.
6. Запустите тесты с одним из следующих вариантов.
   • nosetests (требуется установка библиотек шага 1)
   • python setup.py test (не требует установки библиотек шага 1)