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

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

В этой статье показано, как создать робот с помощью пакета SDK для Bot Framework и как протестировать его с помощью Bot Framework Emulator.This article shows you how to build a bot by using the Bot Framework SDK, and then shows how to test it with the Bot Framework Emulator.

Создание бота с помощью службы Azure Bot и локальных средств — это независимые друг от друга параллельные процессы.Creating a bot with Azure Bot Service and creating a bot locally are independent, parallel ways to create a bot.

Предварительные требования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 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 StudioIn Visual Studio

  1. Откройте проект Bot.Open your bot project.
  2. Запустите проект без отладки.Run the project without debugging.

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 на вкладке приветствия Emulator.Select Open Bot on the Emulator's Welcome tab.

  3. Введите URL-адрес робота (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.

    Открытие программы-робота

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

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

    Эхо-сообщение

Дополнительные ресурсыAdditional Resources

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