Учебник. Создание базового роботаTutorial: Create a basic bot

применимо к: Пакет SDK v4APPLIES TO: SDK v4

В этом учебнике описывается, как создать базовый робот с пакетом SDK для Bot Framework.This tutorial describes how to create a basic bot with the Bot Framework SDK. Если вы уже создали базовый робот и хотите, чтобы он выполнялся локально, ознакомьтесь с руководством по развертыванию базовой ленты .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:

  • Создание базового ботаCreate a basic bot
  • Запуск программы-робота на локальном компьютереRun the bot on your local machine
  • Тестирование с помощью эмулятора Bot FrameworkTest it using the Bot Framework Emulator

Предварительные требованияPrerequisites

ШаблоныTemplates

Чтобы добавить шаблоны Bot в Visual Studio, скачайте и установите Шаблоны пакета SDK для Bot Framework версии 4 для Visual Studio VSIX.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 следует использовать шаблоны .NET Core 3.1.When creating new bots in Visual Studio 2019, you should use the .NET Core 3.1 templates. В текущих примерах ботов используются шаблоны .NET Core 3.1.The current bot samples use .NET Core 3.1 templates. Примеры, использующие шаблоны .NET Core 2.1, можно найти в ветви 4.7-archive репозитория BotBuilder-Samples.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 программы-роботы в Azure см. в статье развертывание программы Bot в Azure.For information about deploying .NET Core 3.1 bots to Azure, see how to deploy your bot to Azure.

Создание ботаCreate a bot

Сборка с помощью Visual StudioBuild with Visual Studio

В Visual Studio создайте проект бота с использованием шаблона эхо-бота на основе Bot Framework версии 4 и .NET Core 3.1.In Visual Studio, create a new bot project using the Echo Bot (Bot Framework v4 - .NET Core 3.1) template. Выберите тип проекта AI Bots (Боты (ИИ)), чтобы отображались только шаблоны ботов.Choose AI Bots from the project types to show only bot templates.

Диалоговое окно создания проекта в Visual StudioVisual 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. Для тестирования бота не требуется дополнительный код.You don't need any additional code to test your 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.

Запуск ботаStart your bot

В Visual Studio запустите проект.In Visual Studio, start the project. Visual Studio создаст приложение, развернет его на узле localhost и запустит веб-браузер для отображения страницы приложения default.htm.This will build the application, deploy it to localhost, and launch the web browser to display the application's default.htm page. На этом этапе бот выполняется локально, используя порт 3978.At this point, your bot is running locally on port 3978.

Запуск эмулятора и подключение к ботуStart the Emulator and connect your bot

  1. Установите Bot Framework Emulator.Start the Bot Framework Emulator.

  2. Выберите Открыть Bot на вкладке приветствия эмулятора.Select Open Bot on the Emulator's Welcome tab.

  3. Введите локальный URL-адрес бота с указанием порта и пути /api/messages. Обычно этот адрес выглядит так: http://localhost:3978/api/messages.Enter 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.

    Открытие экрана-робота CSopen a bot screen cs

  4. В этом случае выберите Подключиться.Then select Connect.

    Отправьте сообщение в Bot, и Bot ответит обратно.Send a message to your bot, and the bot will respond back.

    Эмулятор, выполняющий CSEmulator running cs

Дальнейшие действияNext steps