Как создать простого бота в Microsoft Teams

Одной из самых мощных функций Microsoft Teams является возможность создавать и подключать ботов. Эти боты позволяют диалоговым и транзакционным возможностям легко создавать более сложные задачи.

Помимо фактического написания кода бота для выполнения полезных задач, реализация инфраструктуры была сложной задачей. Это связано с тем, что ботам обычно требуется поддержка веб-службы, настроенная определенным образом, что делает быстрое создание и тестирование бота более сложной задачей.

Microsoft создала службу Web App Bot, которая запускает всю необходимую инфраструктуру, чтобы вы могли быстро приступить к разработке бота, тестированию и, в конечном итоге, публикации этого бота в Teams. В этой статье мы рассмотрим, как быстро начать использовать шаблон бота Echo.

Создание бота веб-приложения

Самый быстрый способ создать нового бота веб-приложения — использовать возможность поиска на портале Microsoft, чтобы найти бота веб-приложения в Marketplace в службе Bot Services.

После того, как вы нажали на бота веб-приложения, вы попадете в мастер для подготовки вашего бота и его необходимых конфигураций.

• Диспетчер бота: lctestbot
  • Это уникальный дескриптор, который должен отличаться от существующих ботов, поскольку он находится на azurewebsites.net.
  • Есть также вариант 10k.
  • По умолчанию вам нужно нажать на нее, чтобы создать новое местоположение.
  • Рекомендуется совпадать с местом нахождения бота.
  • Рекомендуется разрешить Azure управлять этим, если только у вас нет причин использовать определенный идентификатор приложения и пароль.
  

  Вам нужно будет убедиться, что для вашей подписки зарегистрированы два провайдера: Microsoft.Storage и Microsoft.BotService. Они расположены в разделе «Подписка» → «Поставщики ресурсов». Вы можете обнаружить, что при первой загрузке Web App Bot жалуется на отсутствие регистрации Microsoft.BotService. Однако, если вы выйдете и войдете снова, это, скорее всего, сработает. Эта служба автоматически регистрируется при первой загрузке и занимает некоторое время.

  Создание бота для веб-приложения

  После создания бота веб-приложения у вас есть доступ к страницам конфигурации бота. В этом примере мы собираемся сделать простую модификацию существующего исходного кода, перезапустить скрипт сборки, протестировать, а затем протестировать в клиенте Teams.

  

  Перейдите на страницу «Сборка», затем найдите ссылку «Открыть онлайн-редактор кода». Щелкнув по этой ссылке, вы откроете редактор службы приложений, упрощая быстрое изменение кода и повторный запуск скрипта сборки.

  

  Существует много вспомогательного кода, чтобы заставить бота работать, но ядро кода находится в папке Bots. Он содержит файл EchoBot.cs, который мы собираемся изменить. Как видно из приведенного ниже кода, мы собираемся добавить текст Test перед существующим текстом Echo. Изменив код, файл будет сохраняться по ходу работы, и вам не нужно сохранять изменения вручную.

  

  Перейдите в консоль и введите команду build.cmd. Это запустит серию команд, перекомпилирует код и, в конечном итоге, скопирует скомпилированные файлы туда, куда они должны перейти, чтобы сделать бота доступным. В конце вы должны увидеть сообщение Завершено успешно, указывающее, что скомпилированные файлы теперь доступны.

  

  Тестирование бота веб-приложения

  К счастью, функция Test in Web Chat встроена прямо в службы Microsoft Portal Web App Bot. Этот полезный инструмент позволяет нам проверить, как бот реагирует на разговорный диалог и простые команды. В этом случае наш бот просто повторяет текст. Чтобы убедиться, что наше изменение вступило в силу, при отправке некоторого текста вы должны увидеть тот же текст, отраженный в предыдущем тексте Test Echo:.

  

  Далее мы хотим протестировать этого бота в реальном клиенте Teams. По умолчанию единственным подключенным каналом является веб-чат. Нажмите на значок «Команды», чтобы подключить этого бота к каналу Teams.

  

  В этом случае мы будем использовать все значения по умолчанию, то есть вариант обмена сообщениями Microsoft Teams Commercial, а все остальные параметры останутся прежними. Нажмите «Сохранить», чтобы сделать это доступным для канала Microsoft Teams.

  

  Чтобы загрузить бота в клиент Teams, просто щелкните ссылку Microsoft Teams, и он автоматически загрузит бота в ваш клиент Teams.

  

  Как вы можете видеть ниже, бот доступен клиенту, и мы можем протестировать его, отправив сообщение в чат и увидев, что результат соответствует ожидаемому.

  

  Заключение

  Microsoft Teams предоставляет мощные возможности бота, но для упрощения разработки воспользуйтесь бот-службой веб-приложения в Microsoft Azure. Это позволяет создать тестового бота, который прост в использовании и быстро разрабатывается как в онлайн-редакторе кода, так и в автономном редакторе, таком как VS Code. Начните разрабатывать ботов Microsoft Teams уже сегодня!