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步驟的函式庫）