Справочник по каналам
ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4
В этой статье описывается поддержка каналов для различных функций Bot Framework:
- Типы действий для каждого канала могут отправлять или получать.
- Типы карточек каждого канала могут отображаться, включая адаптивные карточки.
- Действие карточки и поддержка предлагаемых действий на каждом канале.
- Общая классификация различных типов действий.
Подробные сведения о структуре действий и карточек на уровне протокола см. в схемах действий и карточек Bot Framework.
Адаптивные карточки — это отдельная технология. Дополнительные сведения см. в adaptivecards.io.
Поддержка действий по каналу
В следующей таблице указывается, может ли заданный канал отправлять заданный тип действия боту. В таблице следующие термины имеют следующие значения.
| Термин | Значение |
|---|---|
| Да | Бот может получить это действие из канала. |
| No | Бот не может получить это действие из канала. |
| Не определено | В настоящее время не определено. |
| Канал | Обновление отношения контакта | Обновление беседы | Конец беседы | Мероприятие | Обновление установки | Вызывать | Сообщение | Реагирование на сообщение | Обновление сообщения | Удаление сообщения | Ввод с клавиатуры |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Алена | No | No | Да | Да | No | No | Да | No | No | No | No |
| Службы коммуникации Azure | No | Да | No | Да | No | No | Да | No | Да | Да | Да |
| Direct Line | No | Да | Да | Да | Да | No | Да | No | No | No | Да |
| Direct Line Speech | Да | ||||||||||
| Отправить электронную почту | No | No | No | Не определено | No | No | Да | No | No | No | No |
| No | Да | No | Да | No | No | Да | Да | No | No | No | |
| GroupMe | No | Да | Нет | Не определено | No | No | Да | No | No | No | No |
| LINE | No | Да | No | Да | No | No | Да | No | No | No | No |
| Microsoft Teams | No | Да | Нет | Не определено | No | Да | Да | Да | Да | Да | Нет |
| Многоканальное взаимодействие | Да | ||||||||||
| Outlook (предварительная версия) | Да | ||||||||||
| Поиск (предварительная версия) | Да | ||||||||||
| Slack | No | Да | Нет | Не определено | No | No | Да | No | Да | Да | Нет |
| Telegram | No | Да | Нет | Не определено | No | No | Да | No | Да | Не определено | No |
| Twilio (SMS) | No | No | No | Не определено | No | No | Да | No | No | No | No |
| Веб-чат. | No | Да | Да | Да | Да | No | Да | No | No | No | Да |
event Поддержка и invoke действия зависят от имени действия и зависит от канала.
Поддержка карточек каналом
В следующей таблице указывается, может ли данный канал отображать заданный тип карточки. Даже если канал может отобразить тип карточки, канал может не поддерживать все функции на карточке. Перед выпуском бота проверьте поведение каждой карточки, которые может отправить бот.
В таблице следующие термины имеют следующие значения.
| Термин | Значение |
|---|---|
| Да | Карточка поддерживается в этом канале; однако любой канал может поддерживать только подмножество действий карты или ограничить количество действий, разрешенных на каждой карточке. |
| No | Карточка не поддерживается в этом канале. |
| Частично | Частичная поддержка. Этот канал может не отображать карточку, если карточка содержит входные данные или кнопки. Уровень поддержки зависит от канала. |
| Изображения | Карточка преобразуется в изображение. |
| Текст | Карточка преобразуется в неформатируемый текст. Ссылки могут не быть доступны для щелчка, изображения могут не отображаться, а носитель может быть недоступен для воспроизведения. Уровень поддержки зависит от канала. |
| Канал | Адаптивная карта | Карточка анимации | Звуковая карточка | Карточка имиджевого баннера | Карточка квитанции | Карточка входа | Карточка эскиза | Видеоадаптер |
|---|---|---|---|---|---|---|---|---|
| Алена | No | No | No | Да | No | Да | No | No |
| Службы коммуникации Azure | Да* | Да | Да | Да | Да | Да | Да | Да |
| Отправить электронную почту | Изображения | Текст | Текст | Да | Да | Да | Да | Текст |
| Изображение, частичное | Да | Да | Да | Да | Да | Да | Да | |
| GroupMe | Изображения | Текст | Текст | Текст | Текст | Текст | Текст | Текст |
| LINE | Изображение, частичное | Да | Текст | Да | Да | Да | Да | Текст |
| Microsoft Teams | Да | No | No | Да | Да | Да | Да | Нет |
| Многоканальное взаимодействие | ||||||||
| Outlook (предварительная версия) | ||||||||
| Поиск (предварительная версия) | ||||||||
| Slack | Image | Да | Текст | Текст | Да | Да | Текст | Текст |
| Telegram | Изображение, частичное | Да | Текст | Да | Да | Да | Да | Да |
| Twilio (SMS) | Изображения | Текст | No | Текст | Текст | Текст | Текст | No |
| Веб-чат. | Да | Да | Да | Да | Да | Да | Да | Да |
Примечание.
- Канал Direct Line технически поддерживает все карточки, но он до клиента, чтобы реализовать их.
- *Для чата Службы коммуникации Azure адаптивные карточки поддерживаются только в Службы коммуникации Azure вариантах использования, а не для Службы коммуникации Azure вариантов использования Teams.
Поддержка действий карточек по каналу
В следующей таблице показано максимальное количество предлагаемых действий и действий карточек, поддерживаемых заданным каналом. Значение None указывает, что тип действия не поддерживается в канале.
| Канал | Предлагаемые действия | Действия с карточками |
|---|---|---|
| Алена | нет | нет |
| Службы коммуникации Azure | ||
| Direct Line | 100 | 100 |
| Direct Line Speech | 100 | 100 |
| Эл. почта | нет | нет |
| 11 | 3 | |
| GroupMe | нет | нет |
| LINE | 13 | 99 |
| Microsoft Teams | нет | 3 |
| Многоканальное взаимодействие | ||
| Outlook (предварительная версия) | ||
| Поиск (предварительная версия) | ||
| Slack | нет | 100 |
| Telegram | 100 | 100 |
| Twilio (SMS) | нет | нет |
| Веб-чат. | 100 | 100 |
- Дополнительные сведения о действиях с карточками см. в разделе "Обработка событий в расширенных карточках " статьи "Добавление носителя в сообщения ".
- Дополнительные сведения о предлагаемых действиях см. в разделе " Использование кнопок для ввода".
Категории действий
Действия можно разделить на отдельные категории. Подробное описание каждого типа действия и сведения, содержащиеся в каждом типе действия, см. в схеме действий Bot Framework.
Приветствие
Эта категория включает в себя conversationUpdate и contactRelationUpdate действия.
- Многие каналы отправляют действия обновления беседы.
- Часто поведение приветствия бота активируется действием обновления беседы. Однако для создания надежного поведения приветствия может потребоваться использование беседы или состояния пользователя.
- Некоторые каналы отправляют действия обновления связей контакта.
- Если бот использует эти каналы, может потребоваться включить логику этого действия в поведение приветствия бота.
Беседы
Эта категория включает в себя messagemessageReactionдействия и endOfConversation действия.
- Все каналы могут отправлять и получать действия сообщения.
- Для ботов, использующих диалоговые окна, действия сообщений обычно должны передаваться в диалоговое окно.
- Некоторые каналы могут отправлять и получать действия реакции на сообщения.
- В зависимости от дизайна бота можно передать действия реакции сообщения в диалоговое окно.
- Действия реакции сообщения ссылались на предыдущие сообщения по идентификатору.
- Завершение действий беседы сигнализирует о завершении беседы с точки зрения отправителя.
- Завершение действий беседы используется в взаимодействии бота с ботом для навыков.
Совет
Реакция на сообщение включает такие вещи, как пальцы вверх по предыдущему комментариев. Они могут возникать без определенного порядка и в этом похожи на кнопки. Этот тип действия можно отправить каналом Teams.
Обновление и удаление сообщений
Эта категория включает в себя messageUpdate и messageDelete действия.
- Teams поддерживает действия обновления и удаления сообщений.
Расширяемость приложения
Эта категория включает в себя event и invoke действия.
Смысл действия определяется его name полем, которое имеет смысл в пределах области канала.
- Приложение, которое владеет как клиентом, так и сервером, может использовать действия событий для обмена программными данными между клиентом и сервером.
- Действия событий, как и большинство типов действий, являются асинхронными.
- Direct Line и Веб-чат использовать действия событий в качестве механизма расширяемости.
- Вызов действий зависит от приложения, а не от того, что будет определять клиент.
- Вызов действий, в отличие от других типов действий, синхронны. (Вызов в настоящее время является единственным типом действия, который активирует поведение ответа на запрос в боте.)
- Microsoft Teams использует действия вызова и определяет несколько действий, относящихся к Teams.
Проверка подлинности
Чтобы запрос OAuth работал с диалогами, TeamsVerification действие вызова должно быть перенаправлено в диалоговое окно.
Uncategorized (Без категории)
Действия installationUpdatetypingи handoff действия не соответствуют другим категориям.
- Действия по обновлению установки представляют собой установку или удаление бота в организационном подразделении канала.
- Действия ввода представляют собой активный ввод пользователя или бота.
- Запрос действий на передачу или сигнал об изменении фокуса между элементами внутри бота. Действие передачи отличается от действия события с именем "передача".
Не используется (включает в себя конкретный вызов оплаты)
Эти типы действий больше не используются:
deleteUserDatahandoffpingAddressвзыватьPaymentRequestвзывать
Дополнительная информация:
Все каналы могут отправлять и получать message действия.
Совет
При добавлении поддержки канала в бот ознакомьтесь с документацией разработчика канала. Каждый канал имеет разные ограничения на различные аспекты беседы. Ниже приведены некоторые различия.
- Сколько времени боту нужно обрабатывать каждый HTTP-запрос.
- Может ли бот отправить действие, которое не отвечает на определенное действие пользователя.
- Сколько сообщений бот может отправлять в течение заданного интервала времени.
- Как отрисовывается карточка и какие карты поддерживаются.