使用適用於 Python 的 Bot Framework SDK 建立 Bot

適用于: SDK v4

本文說明如何使用 Python Echo Bot 範本來建立 bot,然後如何使用 Bot Framework Emulator 進行測試。

使用 Azure Bot Service 建立 Bot 與在本機建立 Bot 是兩種不同建立 Bot 的方式。

必要條件

提示

有些開發人員可能會發現,在 虛擬環境中建立 Python bot 會很有用。 但無論您是在虛擬環境中或在本機電腦上進行開發,都可以使用下列步驟。

範本

執行下列命令來安裝必要套件︰

pip install botbuilder-core
pip install asyncio
pip install aiohttp
pip install cookiecutter==1.7.0

最後一個套件 cookiecutter 將用來產生您的 bot。 藉由執行來確認它是否已正確安裝 cookiecutter --help

建立 Bot

若要建立您的 bot,請流覽至您想要在其中建立 bot 的目錄,然後執行:

cookiecutter https://github.com/microsoft/BotBuilder-Samples/releases/download/Templates/echo.zip

此命令會從 GitHub 複製所有必要的檔案,以建立以 Python echo 範本為基礎的 echo Bot。 系統會提示您輸入 Bot 的「名稱」和「說明」。 命名您的 bot echo-bot ,並將描述設定為回應 使用者回應的 bot。 如下所示:

設定名稱和說明

啟動 Bot

  1. 從終端機流覽至您儲存 bot 的 echo bot 資料夾。 執行 pip install -r requirements.txt 以安裝任何用以執行 Bot 的必要套件。

  2. 安裝好套件之後,請執行 python app.py 來啟動 Bot。 當您看到下列螢幕擷取畫面中所示的最後一行時,就表示 Bot 已準備好而可進行測試:

    Bot 正在本機執行

將最後一行位址中的最後四個數字 (通常是 3978) 複製起來,以供下一個步驟使用。 您現在已準備好開始模擬器。

啟動模擬器並連線至您的 Bot

  1. 啟動 Bot Framework 模擬器。

  2. 在模擬器的 [歡迎使用] 索引標籤上選取 [開啟 Bot ]。

  3. 輸入 Bot 的 URL,也就是本機連接埠的 URL,並將 /api/messages 新增至路徑,通常會是 http://localhost:3978/api/messages

    開啟 bot 畫面 cs

  4. 然後選取 [連線] 。

    將訊息傳送至您的 bot,bot 將會回復。

    執行 cs 的模擬器

其他資源

請參閱通道 (ngrok),了解如何連線到遠端裝載的 Bot。

後續步驟