教學課程:建立基本 botTutorial: Create a basic bot

適用于: SDK v4APPLIES TO: SDK v4

本教學課程說明如何使用 Bot Framework SDK 來建立基本的 bot。This tutorial describes how to create a basic bot with the Bot Framework SDK. 如果您已經建立基本 bot 並讓它在本機執行,請閱讀 教學課程:部署基本 bot 文章。If you've already created a basic bot and have it running locally, read the Tutorial: Deploy a basic bot article.

您將了解如何:You will learn how to:

  • 建立基本 BotCreate a basic bot
  • 在您的本機電腦上執行 botRun the bot on your local machine
  • 使用 Bot Framework Emulator 測試Test it using the Bot Framework Emulator

PrerequisitesPrerequisites

範本Templates

若要將 bot 範本新增至 Visual Studio,請下載並安裝 適用于 Visual Studio VSIX 檔案的 Bot Framework V4 SDK 範本To add the bot templates to Visual Studio, download and install the Bot Framework v4 SDK Templates for Visual Studio VSIX file.

注意

VSIX封裝包含 .net core 2.1 和 .net core 3.1 版本的 c # 範本。The VSIX package includes both .NET Core 2.1 and .NET Core 3.1 versions of the C# templates. 在 Visual Studio 2019 中建立新的 Bot 時,您應該使用 .NET Core 3.1 範本。When creating new bots in Visual Studio 2019, you should use the .NET Core 3.1 templates. 目前的 Bot 範例會使用 .NET Core 3.1 範本。The current bot samples use .NET Core 3.1 templates. 您可以在 BotBuilder-Samples 存放庫的 4.7-archive 分支中,找到使用 .NET Core 2.1 範本的範例。You can find the samples that use .NET Core 2.1 templates in the 4.7-archive branch of the BotBuilder-Samples repository. 如需將 .NET Core 3.1 bot 部署至 Azure 的詳細資訊,請參閱如何將 您的 bot 部署至 azureFor information about deploying .NET Core 3.1 bots to Azure, see how to deploy your bot to Azure.

建立 BotCreate a bot

使用 Visual Studio 建立Build with Visual Studio

在 Visual Studio 中,使用 Echo Bot (Bot Framework v4 - .NET Core 3.1) 範本建立新的 Bot 專案。In Visual Studio, create a new bot project using the Echo Bot (Bot Framework v4 - .NET Core 3.1) template. 若要只顯示 Bot 範本,請從專案類型中選擇 AI BotChoose AI Bots from the project types to show only bot templates.

Visual Studio 建立新專案的對話方塊Visual Studio create a new project dialog

由於有範本,專案中會包含要在本快速入門建立聊天機器人所需的所有程式碼。Thanks to the template, your project contains all the code that's necessary to create the bot in this quickstart. 您不需要使用任何額外程式碼來測試您的 Bot。You don't need any additional code to test your bot.

注意

如果您建立 核心 bot,您將需要 LUIS 語言模型。If you create a Core bot, you'll need a LUIS language model. 您可以在 luis.ai建立語言模型。You can create a language model at luis.ai. 建立模型之後,請更新設定檔。After creating the model, update the configuration file.

啟動 BotStart your bot

在 Visual Studio 中,啟動專案。In Visual Studio, start the project. 這將會建置應用程式、將其部署到 localhost,並啟動 Web 瀏覽器來顯示應用程式的 default.htm 頁面。This will build the application, deploy it to localhost, and launch the web browser to display the application's default.htm page. 此時,Bot 正在本機的連接埠 3978 上執行。At this point, your bot is running locally on port 3978.

啟動模擬器並連線至您的 BotStart the Emulator and connect your bot

  1. 啟動 Bot Framework 模擬器。Start the Bot Framework Emulator.

  2. 在模擬器的 [歡迎使用] 索引標籤上選取 [開啟 Bot ]。Select Open Bot on the Emulator's Welcome tab.

  3. 輸入 Bot 的 URL,也就是本機連接埠的 URL,並將 /api/messages 新增至路徑,通常會是 http://localhost:3978/api/messagesEnter your bot's URL, which is the URL of the local port, with /api/messages added to the path, typically http://localhost:3978/api/messages.

    開啟 bot 畫面 csopen a bot screen cs

  4. 然後選取 [連線] 。Then select Connect.

    將訊息傳送至您的 bot,bot 將會回復。Send a message to your bot, and the bot will respond back.

    執行 cs 的模擬器Emulator running cs

下一步Next steps