Отправка действий типа "событие"

Важно

Возможности и функции Power Virtual Agents теперь являются частью Microsoft Copilot Studio после значительных инвестиций в генеративный искусственный интеллект и расширенную интеграцию с Microsoft Copilot.

Некоторые статьи и снимки экрана могут ссылаться на Power Virtual Agents, пока мы обновляем документацию и учебные материалы.

В 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.

Связанный контент

• Повторное использование переменных в темах
• Настройка внешнего вида помощника