Настройка бота для запуска в одном или нескольких каналах

  • Статья

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

Канал — это подключение между коммуникационным приложением и ботом. Бот, зарегистрированный в Azure, использует каналы для взаимодействия бота с пользователями. Вы можете настроить бот для подключения к любому из стандартных каналов, таких как Alexa, Facebook Messenger и Slack. Дополнительные сведения см. в статье о регистрации Azure Bot. Вы также можете подключить бота к приложению связи с помощью Direct Line в качестве канала. Дополнительные сведения см. в разделе Подключение бота в Direct Line.

Bot Framework позволяет разрабатывать бот в канале, не зависящий от канала, нормализуя сообщения, отправляемые ботом в канал.

  • Служба или адаптер преобразовывает связь между схемой действий Bot Framework и схемой канала.
  • Если канал не поддерживает все аспекты схемы действий, служба бота Подключение or пытается преобразовать сообщение в формат, поддерживаемый каналом. Например, если бот отправляет сообщение, содержащее карта с кнопками действий в канал электронной почты, соединитель может отправить карта как изображение и включить действия в виде ссылок в тексте сообщения электронной почты.
  • Для большинства каналов необходимо предоставить сведения о конфигурации канала для запуска бота на канале. Большинству каналов требуется, чтобы у бота была учетная запись на канале. Другие, такие как Facebook Messenger, требуют, чтобы бот зарегистрировал приложение в канале.

Чтобы настроить бот для подключения к каналу, выполните следующие действия.

  1. Войдите на портал Azure.
  2. Выберите бот, который требуется настроить.
  3. В левой области выберите каналы в Параметры.
  4. В правой области выберите значок канала, который вы хотите добавить в бот. Чтобы просмотреть список всех доступных каналов, может потребоваться прокрутить вниз.

После настройки канала пользователи смогут использовать ваш бот.

Список каналов

Шаги подключения различны для каждого канала. Дополнительные сведения см. в соответствующей статье в таблице ниже.

Канал Description
Alexa Обмен данными с пользователями с помощью пользовательских навыков Alexa.
чат Службы коммуникации Azure Используйте Службы коммуникации Azure Чат, чтобы добавить бота в функции чата веб-сайта.
Direct Line Интеграция бота в мобильное приложение, веб-страницу или другие приложения.
Электронная почта Разрешить боту взаимодействовать с пользователями по электронной почте Microsoft 365.
Facebook Подключение бот в Facebook Messenger и Facebook Workplace, чтобы он смог взаимодействовать с пользователями на обеих платформах.
GroupMe Настройте бота для взаимодействия с пользователями через GroupMe.
Kik Kik больше не поддерживает разработку новых ботов.
LINE Настройте бота для взаимодействия с пользователями через приложение LINE.
Microsoft Teams Настройте бота для взаимодействия с пользователями через Microsoft Teams.
Многоканальное взаимодействие Интеграция бота для запуска беседы с клиентом, предоставления автоматических ответов, а затем переключения беседы на агент человека при необходимости.
Outlook (предварительная версия) Настройте бота для взаимодействия с пользователями с помощью быстрых действий из Outlook.
Поиск (предварительная версия) Разрешить боту отвечать на запросы пользователей с помощью федеративного поиска Dynamics 365.
Skype Skype больше не поддерживает разработку новых ботов.
Slack Настройте бота для взаимодействия с пользователями через Slack.
Telegram Настройте бота для взаимодействия с пользователями через Telegram.
Телефония Телефония доступна в предварительной версии и в настоящее время не принимает дополнительных клиентов.
Twilio (SMS) Настройте бота для взаимодействия с пользователями через платформу облачной коммуникации Twilio.
WeChat Настройте бота для взаимодействия с пользователями с помощью платформы WeChat.
Веб-чат Автоматически настраивается при создании бота со службой Bot Framework.
Дополнительные каналы Дополнительные каналы, доступные в качестве адаптера с помощью Botkit, предоставляют платформы и репозитории сообщества.

Выбор версии преобразования схемы протокола

Как описано выше, канал преобразует входящие сообщения из других служб в схему протокола Bot Framework. Аналогичным образом сообщения, отправленные ботом в другие службы, преобразуются из собственной схемы Bot Framework в формат этих служб. Этот процесс называется преобразованием схемы. Служба Bot Framework поддерживает обратную совместимость протокола, чтобы избежать изменения поведения существующих ботов.

Иногда изменение процесса преобразования схемы должно происходить, что может, возможно, изменить поведение существующих ботов. Пример такого изменения может быть любым исправлением ошибок, если некоторые из пользователей приняли зависимость от существующего (однако ошибочного) поведения. Еще одним примером такого изменения будет обновление или улучшение других служб, которые будут использовать боты; однако принятие этих обновлений может, возможно, изменить существующее поведение.

Управляя версией преобразования схемы своих ботов, разработчики ботов могут управлять тем, когда (если когда-либо) можно включить новое поведение. По умолчанию созданные боты получают последнюю версию преобразования схемы. Существующие боты можно обновить до последней версии, когда они готовы воспользоваться улучшениями, представленными в этой версии. Любой бот может быть обновлен или понижен в любое время.

Вы можете изменить версию преобразования схемы бота в области конфигурации в Параметры:

The Schema Transformation Version field in the Configuration pane

Поддерживаемые версии преобразования схемы

  • Версия 1.3

    • Дата начала: май 2021 г.
    • Изменения:
      • Прямая линия: удаление десериализации и повторной инициализации адаптивных карточек. Содержимое адаптивных карточек передается клиенту как есть.

  • Версия 1.2

    • Дата начала: апрель 2021 г.
    • Изменения:
      • Канал Slack: имя вложения используется для значения "Текст сообщения".
      • Канал Facebook: обновление до API Graph для Facebook версии 9.0.

  • Версия 1.1

    • Дата начала: апрель 2021 г.
    • Изменения:
      • Телеграмм-канал: используйте синтаксис MarkdownV2 для всех markdown.

  • Версия 1.0

    • Исходная версия

Подключение бота в один или несколько каналов

Процесс публикации на каждом канале разный. Дополнительные сведения см. в статье для каждого конкретного канала.

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

Этот пакет SDK содержит примеры, которые можно использовать для создания ботов. Посетите репозиторий примеров в GitHub, чтобы просмотреть список примеров.