共用方式為


使用 Bot Framework SDK 建立 Bot

適用於: SDK v4

本文說明如何使用適用於 C#、Java、JavaScript 或 Python 的 Bot Framework SDK 建置您的第一個 Bot,以及如何使用 Bot Framework 模擬器測試 Bot。

建立您的第一個 Bot 不需要 Azure 訂用帳戶或 Azure AI Bot Service 資源。 本快速入門著重於在本機建立您的第一個 Bot。 如果您想要瞭解如何在 Azure 中建立 Bot,請參閱 建立 Azure Bot 資源

注意

Bot Framework JavaScript、C# 和 Python SDK 將會繼續受到支援,不過,Java SDK 即將淘汰,最終長期支援將於 2023 年 11 月結束。

使用 Java SDK 建置的現有 Bot 將繼續運作。

針對新的 Bot 建置,請考慮使用 Microsoft Copilot Studio ,並閱讀 選擇正確的 Copilot 解決方案

如需詳細資訊,請參閱 Bot 建置的未來。

必要條件

C# 範本

目前的 Bot 範例使用 .NET Core 3.1 範本。

若要將 Bot 範本新增至 Visual Studio,請下載並安裝適用於 Visual Studio VSIX 的 Bot Framework v4 SDK 範本檔案。

注意

您可以從 Visual Studio 內安裝範本。

  1. 在功能表中,選取 [擴充功能],然後選取 [管理擴充功能]。
  2. 在 [ 管理延伸模組 ] 對話框中,搜尋並安裝 適用於Visual Studio的 Bot Framework v4 SDK 範本。

如需將 .NET Bot 部署至 Azure 的相關信息,請參閱如何 布建和發佈 Bot

建立機器人

在 Visual Studio 中,建立新的 Bot 專案,並使用 Echo Bot (Bot Framework v4 - .NET Core 3.1) 範本。 若要查看 Bot 範本,請選擇 AI Bot 項目 類型。

由於範本,您的專案包含在本快速入門中建立 Bot 所需的所有程式代碼。 您不再需要任何程式代碼來測試 Bot。

啟動 Bot

在 Visual Studio 中:

  1. 開啟 Bot 專案。
  2. 執行專案而不偵錯。
  3. Visual Studio 會建置應用程式、將其部署至localhost,並啟動網頁瀏覽器以顯示應用程式的 default.htm 頁面。

此時,您的 Bot 正在本機埠 3978 上執行。

啟動模擬器並連線 Bot

  1. 啟動 Bot Framework 模擬器。

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

  3. 輸入 Bot 的 URL,也就是本機主機和埠,並 /api/messages 新增至路徑。 位址通常是: http://localhost:3978/api/messages

    開啟 Bot

  4. 然後選取 [連線]。

    將訊息傳送至 Bot,Bot 會回應。

    echo 訊息

下一步

  • 如需如何使用 Visual Studio 或 Visual Studio Code 和 Bot Framework Emulator 進行偵錯的詳細資訊,請參閱 對 Bot 進行偵錯。
  • 如需 ngrok 的相關信息,請參閱 Tunneling (ngrok)