Web App Bot для Microsoft Teams — быстрый старт

Быстрые ссылки

• Создание Web App Bot
• Сборка Web App Bot
• Тестирование Web App Bot
• Заключение

Что такое Web App Bot в двух словах

Web App Bot — это служба Azure, которая разворачивает веб-сервис и всю инфраструктуру, необходимую для запуска бота (включая App Service, настройки приложения и интеграцию с Bot Framework). Это ускоряет разработку: не нужно вручную конфигурировать веб‑хостинг и провайдеры — платформа сделает это за вас.

Важно: если ваш бот будет обрабатывать персональные данные, заранее продумайте требования безопасности и соответствие требованиям конфиденциальности (GDPR / локальные правила).

Создание Web App Bot — пошагово

Следуйте этим шагам для быстрого создания тестового бота на шаблоне Echo.

1. Откройте Microsoft Azure Portal и в строке поиска найдите “Web App Bot” в Marketplace под Bot Services.

2. Запустится мастер создания. Основные поля для заполнения:

• Bot Handle: lctestbot — уникальный идентификатор, он используется в домене azurewebsites.net.
• Subscription: {tenant subscription}
• Resource Group: {resource group for the bot}
• Location: {location to place the bot}
• Pricing Tier: $1 (1k Premium Msgs/Unit) — доступен также уровень 10k.
• App Name: lctestbot.
• Bot Template: Echo Bot (C#).
• App Service Plan/Location: lctestbot/Central US — по умолчанию нужно создать план.
• Application Insights: Включено.
• Application Insights Location: Central US (рекомендуется совпадать с регионом бота).
• Microsoft App ID and Password: Auto Create App ID and password (рекомендуется автоматическое создание, если нет особых требований).

3. Проверьте регистрацию провайдеров ресурсов для подписки. В Subscription → Resource Providers должны быть зарегистрированы Microsoft.Storage и Microsoft.BotService. Иногда первый запуск запустит регистрацию автоматически — если мастер жалуется, закройте и откройте его снова через минуту.

Примечание: Имена и цены в примере — демонстрационные. Выберите параметры, соответствующие вашей подписке и политике компании.

Сборка и правка кода бота

После создания Web App Bot вы получите доступ к панелям конфигурации.

1. Откройте раздел Build и нажмите Open online code editor — это откроет App Service Editor (он же Monaco/Visual Studio Online-подобный редактор).

2. В дереве проекта перейдите в папку Bots. Основной файл: EchoBot.cs. Мы изменим поведение, добавив префикс к ответам.

Пример изменения: добавьте текст Test перед существующим Echo в ответе. Редактор сохраняет файл автоматически.

3. Откройте консоль в портале и выполните команду:

build.cmd

Этот скрипт выполнит компиляцию, соберёт артефакты и скопирует их в нужную папку App Service. В конце вы должны увидеть сообщение:

Finished successfully

Полезные советы по сборке

• Если сборка падает, откройте лог сборки в консоле и проверьте ошибки компиляции.
• При изменении зависимостей добавьте их в проект и перезапустите build.cmd.

Тестирование в портале и в Teams

Azure Portal предоставляет встроенный тестер “Test in Web Chat” — быстрый способ проверить диалог и простую логику.

1. В разделе Test отправьте любое сообщение — если изменения внесены верно, бот должен ответить с префиксом, например:

Test Echo: <ваше сообщение>

2. Чтобы протестировать в клиенте Microsoft Teams, подключите канал Teams в настройках Channels. По умолчанию подключён только Web Chat. Нажмите иконку “Teams” и сохраните настройки.

3. Выберите варианты по умолчанию (Microsoft Teams Commercial), нажмите “Save”.

4. Нажмите ссылку Microsoft Teams, и бот загрузится в ваш Teams-клиент.

5. Отправьте сообщение в чате с ботом и проверьте ответ.

Что делать, если что‑то пошло не так

• Бот не отвечает в Web Chat: проверьте журналы App Service, ошибки сборки и настройки переменных окружения (Microsoft App ID/Password).
• Канал Teams не подключается: убедитесь, что App ID корректно создан и что в Bot Channels Registration указаны правильные параметры.
• Ошибки при выполнении build.cmd: проверьте версии SDK и целевую платформу .NET в проекте.

Важно: при изменениях App ID или пароля нужно обновлять соответствующие настройки в Azure и, при необходимости, заново авторизовывать канал Teams.

Альтернативные подходы

• Разрабатывать локально и разворачивать через CI/CD (GitHub Actions, Azure DevOps) вместо онлайн-редактора.
• Использовать Azure Functions + Bot Framework SDK для серверлесс-подхода (меньше затрат на постоянно работающий App Service).
• Прямое использование Bot Framework Composer для визуального проектирования диалогов.

Когда Web App Bot подходит, а когда нет

• Подходит: быстрые прототипы, демонстрации, учебные боты, простые сценарии с минимальной нагрузкой.
• Не подходит: высоконагруженные прод‑системы с требованиями к отказоустойчивости, сложные голосовые каналы, строгие требования к хранению данных и шифрованию. В этих случаях лучше архитектурно разделять сервисы и использовать CI/CD.

Мини‑методология быстрой итерации (быстрый цикл Dev→Test→Publish)

1. Создать Web App Bot с шаблоном Echo.
2. Править код в App Service Editor или локально в VS Code.
3. Запустить build.cmd и убедиться в успешной сборке.
4. Тестировать в “Test in Web Chat”.
5. Подключить канал Teams и выполнить тест в клиенте.
6. Перенести изменения в репозиторий и настроить CI/CD для автоматизации деплоя.

Роль‑ориентированные чек‑листы

Разработчик:

• Проверить локальную сборку.
• Внести изменение в EchoBot.cs.
• Выполнить build.cmd и проверить Finished successfully.
• Написать unit‑тесты для логики бота (где применимо).

Администратор Azure:

• Убедиться в регистрации Microsoft.Storage и Microsoft.BotService.
• Проверить настройки App Service Plan и Application Insights.
• Контролировать доступы и секреты (App ID/Password в Key Vault при необходимости).

Тестировщик:

• Проверить ответы в Web Chat и Teams.
• Выполнить сценарии краевых случаев (пустые сообщения, специальные символы).
• Проверить логи и трассировки в Application Insights.

Критерии приёмки

• Бот успешно создаётся через портал и доступен по URL.
• Изменения в коде приводят к успешной сборке (build.cmd -> Finished successfully).
• Встроенный тестер возвращает ожидаемый ответ с модификацией (например, “Test Echo:”).
• Бот подключен к каналу Teams и отвечает в клиенте.

Примеры тест‑кейсов

1. Отправить текст “Hello” в Web Chat → Ожидаемый ответ: “Test Echo: Hello”.
2. Отправить пустое сообщение → Ожидаемый ответ: обработать безопасно (например, просьба ввести текст).
3. Отправить длинный текст (>5000 символов) → Ожидаемо: корректная обработка или внятная ошибка.
4. Эмулировать ошибку сервера (искусственно вызвать исключение) → Система должна логировать исключение и возвращать дружелюбное сообщение.

Безопасность и конфиденциальность

• Храните App ID и Password в защищённых хранилищах (Azure Key Vault), не в коде.
• Ограничьте доступ к ресурсам по ролям (RBAC).
• Если бот обрабатывает персональные данные, зафиксируйте поток данных и примените шифрование в покое и в транзите.

Краткий глоссарий

• App Service: платформа для размещения веб‑приложений в Azure.
• Bot Framework: набор SDK и сервисов для создания ботов.
• Echo Bot: шаблон, который повторяет входящие сообщения.
• Application Insights: мониторинг и телеметрия для приложений.

Заключение

Microsoft Teams получает мощную функциональность через ботов, а Web App Bot в Azure позволяет быстро запустить прототип и протестировать его в реальном клиенте. Для производства рекомендуется настроить CI/CD, управление секретами и контролируемую архитектуру с учётом безопасности и конфиденциальности.

Ключевые шаги: создать бота в портале → править код → запустить build.cmd → тестировать в Web Chat → подключить Teams.

Примечание: рассматривайте Web App Bot как быстрый старт; для масштабирования и поддержки в продакшене планируйте архитектуру и процессы доставки кода.