Справочник по каналам
ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4
В этой статье описывается поддержка каналов для различных функций Bot Framework:
- Типы действий для каждого канала могут отправлять или получать.
- Карта типы каждого канала могут отображаться, включая адаптивные карточки.
- Действие карточки и поддержка предлагаемых действий на каждом канале.
- Общая классификация различных типов действий.
Подробные сведения о структуре действий и карта на уровне протокола см. в действиях Bot Framework и схемах карта.
Адаптивные карточки — это отдельная технология. Дополнительные сведения см. в разделе "Адаптивный картаs.io".
Поддержка действий по каналу
В следующей таблице указывается, может ли заданный канал отправлять заданный тип действия боту. В таблице следующие термины имеют следующие значения.
| Термин | Значение |
|---|---|
| Да | Бот может получить это действие из канала. |
| No | Бот не может получить это действие из канала. |
| Не определено | В настоящее время не определено. |
| Канал | Обновление отношения контакта | Обновление беседы | Конец беседы | Событие | Обновление установки | Вызывать | Message | Реагирование на сообщение | Обновление сообщения | Удаление сообщения | Ввод с клавиатуры |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Алена | No | No | Да | Да | No | No | Да | No | No | No | Нет |
| Azure Communication Services Chat | 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 | Нет | |
| GroupMe | No | Да | Нет | Не определено | No | No | Да | No | No | No | Нет |
| LINE | 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 | Да |
event Поддержка и invoke действия зависят от имени действия и зависит от канала.
Поддержка карточек каналом
В следующей таблице указывается, может ли данный канал отображать заданный тип карта. Даже если канал может отобразить тип карта, канал может не поддерживать все функции в карта. Перед выпуском бота проверьте поведение каждого карта бот может отправлять.
В таблице следующие термины имеют следующие значения.
| Термин | Значение |
|---|---|
| Да | В этом канале поддерживается карта. Однако любой канал может поддерживать только подмножество действий карта или может ограничить количество действий, разрешенных для каждого карта. |
| No | В этом канале не поддерживается карта. |
| Частично | Частичная поддержка. Этот канал может не отображать карта, если карта содержит входные данные или кнопки. Уровень поддержки зависит от канала. |
| Image | Карточка преобразуется в изображение. |
| Текст | Карточка преобразуется в неформатируемый текст. Ссылки могут не быть доступны для щелчка, изображения могут не отображаться, а носитель может быть недоступен для воспроизведения. Уровень поддержки зависит от канала. |
| Канал | Адаптивная карта | Анимация карта | Звуковая карточка | Карточка имиджевого баннера | Карточка квитанции | Вход карта | Карточка эскиза | Видеоадаптер |
|---|---|---|---|---|---|---|---|---|
| Алена | No | No | No | Да | No | Да | No | Нет |
| Azure Communication Services Chat | Да* | Да | Да | Да | Да | Да | Да | Да |
| Отправить электронную почту | Image | Текст | Текст | Да | Да | Да | Да | Текст |
| Изображение, частичное | Да | Да | Да | Да | Да | Да | Да | |
| GroupMe | Image | Текст | Текст | Текст | Текст | Текст | Текст | Текст |
| LINE | Изображение, частичное | Да | Текст | Да | Да | Да | Да | Текст |
| Microsoft Teams | Да | No | No | Да | Да | Да | Да | Нет |
| Многоканальное взаимодействие | ||||||||
| Outlook (предварительная версия) | ||||||||
| Поиск (предварительная версия) | ||||||||
| Slack | Изображение | Да | Текст | Текст | Да | Да | Текст | Текст |
| Telegram | Изображение, частичное | Да | Текст | Да | Да | Да | Да | Да |
| Twilio (SMS) | Image | Текст | No | Текст | Текст | Текст | Текст | No |
| Веб-чат. | Да | Да | Да | Да | Да | Да | Да | Да |
Примечание.
- Канал Direct Line технически поддерживает все карта, но он до клиента, чтобы реализовать их.
- *Для чата Службы коммуникации Azure адаптивные карта поддерживаются только в Службы коммуникации Azure вариантах использования, а не для Службы коммуникации Azure вариантов использования Teams.
Поддержка действий карточек по каналу
В следующей таблице показано максимальное количество предлагаемых действий и карта действий, поддерживаемых заданным каналом. Значение None указывает, что тип действия не поддерживается в канале.
| Канал | Предлагаемые действия | Действия с карточками |
|---|---|---|
| Алена | Нет | Нет |
| Azure Communication Services Chat | ||
| 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-запрос.
- Может ли бот отправить действие, которое не отвечает на определенное действие пользователя.
- Сколько сообщений бот может отправлять в течение заданного интервала времени.
- Как отрисовывается карта и какие карта поддерживаются.