microsoftbotframework

微软机器人框架

Microsoft Bot Framework 是 Microsoft 的 Microsoft Bot API 的包装器。它使用Flask接收来自Microsoft和Celery的post消息来完成异步任务。

目标是创建一个非常简单易用的库，使您能够与 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 bot 框架交互，您需要有一个面向互联网的 https 端点以及有效的证书。本指南将展示如何使用gunicorn和heroku来托管应用程序，但您可以轻松使用任何wsgi托管选项，因为MsBot对象扩展了Flask。

创建 Microsoft 聊天机器人

转到 https://dev.botframework.com/bots。注册机器人并生成“Microsoft App ID”和“Microsoft App Secret”。不用担心消息传递端点，因为我们很快就会创建它。在项目的根目录中创建 config.yaml 文件并放置以下信息：

 other :
    app_client_id : 
    app_client_secret :  

发布到 Heroku

创建一个名为requirements.txt 的文件并添加以下内容。

 microsoftbotframework
gunicorn

创建一个名为“Procfile”的文件并添加以下内容。我们将使用 Gunicorn 作为我们的 Web 服务器。您可以删除“--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 设置选项卡中找到的域。确保在 url 的末尾添加“/api/messages”。

恭喜您现在应该可以在 Skype 上与您的机器人聊天了！

运行这个库的测试

1. 确保您已使用pip install -e .[test]从 setup.pytests_require 部分安装了所需的库
2. 确保本地安装了redis和mongodb
3. 开启redis： redis-server
4. 开启 mongod: mongod
5. 在此目录的根目录中打开终端
6. 使用以下选项之一运行测试
   • nosetests （需要安装第 1 步库）
   • python setup.py test （不需要安装第1步的库）