Отправка события или действия
В Microsoft Copilot Studio предусмотрено два узла, которые позволяют отправлять действия, не связанные с сообщениями: «Отправить событие» и «Отправить действие». Эти типы узлов обсуждаются в следующих разделах.
Отправка событий
Узел «Отправить событие» предназначен для отправки действий событий. Действия событий отправляются из помощника и могут быть перехвачены и использованы каналом, который решает, следует ли использовать эти действия и как их использовать. Когда вы отправляете событие, вы даете ему имя, после чего можете установить для него значения. Это значение может быть в любом формате: простое литеральное значение, ссылка на переменную или формула Power Fx. Значение сериализуется в JSON и добавляется к исходящему действию.
Использовать этот узел можно следующим образом:
- Вы можете настроить пользовательский элемент управления веб-чатом для обработки событий, отправленных от помощника. Например, вы можете найти событие, возвращающееся от помощника, и выполнить действие на странице. Пример
04.api/c.incoming-activity-eventв Репозиторий образцов веб-чата Microsoft Bot Framework на GitHub демонстрирует, как может работать обработка событий. - Канал AudioCodes использует действия-события, чтобы вы могли управлять службой. Например, вы можете начинать или останавливать запись разговора. Дополнительную информацию см. в разделе Запись звонков.
Отправка действий других типов
Помимо действий-событий, с помощью узла отправки действия вы можете отправлять действия других типов. Как правило, этот узел предназначен для опытных пользователей, поэтому он находится я подкатегории «Дополнительно». Типы действий, которые вы можете отправлять, являются подмножеством тех, которые предлагаются в классе Bot Framework Schema — ActivityTypes. При использовании этого узла вы выбираете тип действия, а затем дополнительно задаете имя или значение.
К распространенным типам относятся следующие:
- Ввод — отправляет действие по вводу, которое канал может выбрать и отобразить индикатор набора текста на клиенте.
- Задержка — может использоваться для обеспечения задержки между сообщениями. Например, можно отправить сообщение, затем отправить действие-задержку задержки, а затем еще одно сообщение. Конечный пользователь будет видеть первое сообщение, за которым следует пауза и затем второе сообщение. В этом случае «Значение» задается равным количеству миллисекунд задержки. Подробнее см. в статье Поле ActivityTypes.Delay.
- Вызов/Ответ на вызов — обычно используется для Microsoft Teams. Пользователь создает тему с триггером вызова для перехвата входящего вызова из Teams и использует действие ответа на вызов для отправки соответствующего ответа обратно в Teams.
- Передача — позволяет пользователю отправлять действие передачи с явным контролем над значением. Передача обслуживания используется для некоторых внешних каналов, таких как AudioCodes.
