Создание бота с помощью пакета SDK Bot Framework

ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4

В этой статье описывается, как создать первого бота с помощью пакета SDK Bot Framework для C#, Java, JavaScript или Python и как протестировать бота с помощью эмулятора Bot Framework.

Для создания первого бота не требуется подписка Azure или ресурс Azure AI Служба Bot. В этом кратком руководстве основное внимание уделяется созданию первого бота локально. Если вы хотите узнать, как создать бота в Azure, см. статью "Создание ресурса Azure Bot".

Примечание.

Пакеты SDK для JavaScript, C# и Python для Bot Framework по-прежнему будут поддерживаться, однако пакет SDK java отменяется с окончательной долгосрочной поддержкой, заканчивающейся в ноябре 2023 года. В этом репозитории будут выполняться только критически важные исправления безопасности и ошибок.

Существующие боты, созданные с помощью пакета SDK для Java, будут продолжать функционировать.

Для создания нового бота рекомендуется использовать Power Virtual Agent и ознакомиться с выбором подходящего решения чат-бота.

Дополнительные сведения см. в статье "Будущее создания бота".

Необходимые компоненты

Шаблоны C#

В текущих примерах ботов используются шаблоны .NET Core 3.1.

Чтобы добавить шаблоны ботов в Visual Studio, скачайте и установите шаблоны SDK Bot Framework версии 4 для Visual Studio VSIX.

Примечание.

Вы можете установить шаблоны из Visual Studio.

  1. В меню выберите "Расширения" и "Управление расширениями".
  2. В диалоговом окне "Управление расширениями" найдите и установите шаблоны SDK Bot Framework версии 4 для Visual Studio.

Сведения о развертывании ботов .NET в Azure см. в статье о подготовке и публикации бота.

Создание бота

В Visual Studio создайте проект бота и используйте шаблон Echo Bot (Bot Framework версии 4 — .NET Core 3.1). Чтобы просмотреть только шаблоны ботов, выберите тип проекта AI Bots .

Благодаря шаблону проект содержит весь необходимый код для создания бота в этом кратком руководстве. Вам больше не нужен код для тестирования бота.

Запуск бота

В Visual Studio:

  1. Откройте проект бота.
  2. Запустите проект без отладки.
  3. Visual Studio создает приложение, развертывает его в localhost и запускает веб-браузер для отображения страницы приложения default.htm .

На этом этапе бот выполняется локально, используя порт 3978.

Запуск эмулятора и подключение к боту

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

  2. Выберите "Открыть бот" на вкладке приветствия эмулятора.

  3. Введите URL-адрес бота, который является локальным узлом и портом, добавив /api/messages его в путь. Адрес обычно: http://localhost:3978/api/messages

    open a bot

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

    Отправьте боту сообщение, и бот ответит обратно.

    echo message

Следующие шаги