Отправка проактивных сообщений Microsoft Teams

После того, как вы опубликовали ваш агент и сделали агент доступным для конечных пользователей в Microsoft Teams, вы можете уведомлять пользователей (получателей) в Microsoft Teams с помощью проактивных сообщений. Проактивные сообщения используют потоки Power Automate для доставки своего контента и полезны во многих сценариях, в том числе:

• Уведомление получателя о том, что его предыдущий запрос был выполнен. Например, запрос пользователя на нерабочее время был одобрен.
• Напоминания или обновления новостей. Например, агент может отправить напоминание о завершении онлайн-обучения.

Внимание!

Проактивные сообщения можно настроить для агентов и классических чат-ботов, созданных и настроенных в Copilot Studio.

Агент не может доставлять сообщения, если получатель:

• Не имеет агента, установленного в Microsoft Teams.
• Удалил агент.
• Заблокировал агент.
• Не имеет разрешения на общение с агентом — в этом случае вам необходимо поделиться агентом с другими пользователями.

Предварительные требования

• Использование потоков Power Automate
• Публикация агента
• Подключение и настройка агента для Microsoft Teams
• Начало работы с Power Automate

Известные ограничения

• Если агент отключен и подключен к Microsoft Teams снова, пользователи не будут получать проактивные сообщения до тех пор, пока не переустановят агент.
• Все проактивные сообщения из Copilot Studio подлежат ограничениям в Power Automate и ограничениям регулирования количества запросов соединителя Microsoft Teams.
• Проактивные сообщения не будут регистрироваться в расшифровках разговоров или в сеансах аналитики.
• Проактивные сообщения должны находиться в той же среде, что и поток Power Automate.
• Проактивные сообщения можно отправлять только в личный чат с агентом.

Отправить проактивное сообщение

1. В Power Automate откройте поток, который должен отправлять упреждающее сообщение.

2. Добавьте действие соединителя Microsoft Teams Опубликовать сообщение в чате или на канале.

3. Для Опубликовать как выберите Power Virtual Agents (предварительная версия).

4. Для Опубликовать в выберите Чат с ботом.

5. Для Бота выберите агент, с которого вы хотите отправить сообщение.

6. Для параметра Получатель введите имя получателя или адрес электронной почты. Вы также можете использовать динамический контент, если информация о получателе поступает с более раннего шага в потоке.

7. Для параметра Сообщение введите сообщение, которое требуется отправить.

   

Когда поток запущен, получатель получит проактивное сообщение от агента в Microsoft Teams.

Отправка проактивной адаптивной карточки

Внимание!

В этом разделе подробно описано, как отправлять упреждающие адаптивные карточки с потоками Power Automate. Проактивные адаптивные карточки позволяют пользователям получать информацию из неактивного разговора с агентом. Чтобы узнать, как отправить адаптивные карточки в активном разговоре, см. раздел Отображение адаптивной карточки в Copilot Studio.

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

Адаптивные карточки — это открытый формат обмена карточками, позволяющий разработчикам обмениваться контентом пользовательского интерфейса общим и согласованным способом. Вы можете создавать адаптивные карточки вручную в формате JSON или, если вы предпочитаете интерфейс перетаскивания, вы можете использовать Конструктор адаптивных карточек.

Заметка

Power Automate не поддерживает адаптивные карточки, использующие функцию шаблонов.

В этом примере вы отправите сводную карточку заказа для просмотра пользователем.

1. В Power Automate добавьте действие соединителя Microsoft Teams Опубликовать адаптивную карточку в чате или в канале на шаге, на котором вы хотите отправить карточку в своем потоке.

2. Для Опубликовать как выберите Power Virtual Agents (предварительная версия).

3. Для Опубликовать в выберите Чат с ботом.

4. Для Бота выберите агент, с которого вы хотите отправить сообщение.

5. Для параметра Получатель введите имя получателя или адрес электронной почты. Вы также можете использовать динамический контент, если информация о получателе поступает с более раннего шага в потоке.

6. Для параметра Адаптивная карточка введите следующий шаблон JSON:

   {
       "type": "AdaptiveCard",
       "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
       "version": "1.5",
       "body": [
           {
               "type": "TextBlock",
               "text": "Order summary",
               "wrap": true,
               "style": "heading"
           },
           {
               "type": "FactSet",
               "facts": [
                   {
                       "title": "Name",
                       "value": "John Doe"
                   },
                   {
                       "title": "Phone number",
                       "value": "(000) 000-0000"
                   }
               ]
           },
           {
               "type": "Container",
               "items": [
                   {
                       "type": "FactSet",
                       "facts": [
                           {
                               "title": "1x",
                               "value": "Steak"
                           },
                           {
                               "title": "2x",
                               "value": "Side Rice"
                           },
                           {
                               "title": "1x",
                               "value": "Soft Drink"
                           }
                       ],
                       "spacing": "Small"
                   }
               ],
               "spacing": "Small"
           }
       ]
   }
   

   

Когда поток запущен, получатель получит адаптивную карточку от агента в Microsoft Teams.

Ожидание ответа пользователя

Внимание!

В этом разделе подробно описано, как отправлять упреждающие адаптивные карточки с потоками Power Automate. Проактивные адаптивные карточки позволяют пользователям получать информацию из неактивного разговора с агентом. Чтобы узнать, как отправить адаптивные карточки в активном разговоре, см. раздел Отображение адаптивной карточки в Copilot Studio.

Адаптивные карточки поддерживают сбор пользовательского ввода. В этих сценариях вам потребуется дождаться ответа пользователя, прежде чем поток продолжится.

Заметка

Power Automate не поддерживает адаптивные карточки, использующие функцию шаблонов.

В этом примере вы отправите карточку подтверждения заказа, которая позволит пользователю внести изменения до отправки заказа.

1. В Power Automate добавьте действие соединителя Microsoft Teams Опубликовать адаптивную карточку и дождаться ответа на шаге, на котором вы хотите отправить карточку в своем потоке.

2. Для Опубликовать как выберите Power Virtual Agents (предварительная версия).

3. Для Опубликовать в выберите Чат с ботом.

4. Для параметра Сообщение введите следующий шаблон JSON:

   Свойства в разделе actions определяет параметры, представленные пользователю.

   {
       "type": "AdaptiveCard",
       "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
       "version": "1.0",
       "body": [
           {
               "type": "TextBlock",
               "text": "Order confirmation",
               "wrap": true,
               "style": "heading"
           },
           {
               "type": "FactSet",
               "facts": [
                   {
                       "title": "Name",
                       "value": "John Doe"
                   },
                   {
                       "title": "Phone number",
                       "value": "(000) 000-0000"
                   }
               ]
           },
           {
               "type": "Container",
               "items": [
                   {
                       "type": "FactSet",
                       "facts": [
                           {
                               "title": "1x",
                               "value": "Steak"
                           },
                           {
                               "title": "2x",
                               "value": "Side Rice"
                           },
                           {
                               "title": "1x",
                               "value": "Soft Drink"
                           }
                       ],
                       "spacing": "Small"
                   }
               ],
               "spacing": "Small"
           }
       ],
       "actions": [
           {
               "type": "Action.Submit",
               "title": "Submit Order"
           },
           {
               "type": "Action.Submit",
               "title": "Edit Order"
           }
       ]
   }
   

5. Для параметра Сообщение об обновлении введите сообщение об обновлении, которое получатель увидит после ответа.

6. Для параметра Получатель введите имя получателя или адрес электронной почты. Вы также можете использовать динамический контент, если информация о получателе поступает с более раннего шага в потоке.

7. Для параметра Бот выберите агент, с которого вы хотите отправить карточку.

   

При запуске потока получатель получит адаптивную карточку от агента в Microsoft Teams, в которой они могут затем предоставить ответ.

Чтобы использовать ответ получателя, выберите submitActionId из всплывающего меню динамического содержимого. Значение этой переменной будет title действия, которое выбрал пользователь.

Отправка проактивных сообщений нескольким получателям

В некоторых сценариях вы можете захотеть отправить одно и то же проактивное сообщение или карточку сразу нескольким получателям.

В этом разделе содержатся примеры отправки сообщений нескольким получателям.

Внимание

Предварительные требования, описанные в этой теме, применяются к каждому получателю.

Например, вы можете отправить одно и то же сообщение 10 получателям за одно действие. Если у трех из 10 получателей агент не установлен, то эти три получателя не получат сообщение.

Отправить участникам рабочей группы

В этом примере агент отправит членам команды напоминание о завершении онлайн-обучения.

1. Добавьте соединитель Microsoft Teams и выберите действие Получить рабочую группу в вашем потоке Power Automate.

2. Для параметра Рабочая группа выберите команду с участниками, которым вы хотите отправить сообщение.

3. Добавьте соединитель Группы Office 365 и выберите действие Список участников группы.

4. Для параметра Код группы выберите Настраиваемое значение.

5. Выберите Идентификатор рабочей группы из динамического контента действия Получить рабочую группу.

6. Добавьте соединитель Microsoft Teams и выберите действие Опубликовать сообщение в чате или на канале.

7. Для Опубликовать как выберите Power Virtual Agents (предварительная версия).

8. Для Опубликовать в выберите Чат с ботом.

9. Для бота выберите агент, которому вы хотите отправить сообщение.

10. Для параметра Получатель выберите динамический контент Имя участника-пользователя в действии Список участников группы.

    

11. Для параметра Сообщение введите сообщение, которое требуется отправить.

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

Отправка в группу безопасности

В этом примере агент отправит группе безопасности напоминание о завершении онлайн-обучения.

1. Добавьте соединитель Microsoft Entra ID и выберите действие Получить членов группы в вашем потоке Power Automate.

2. Для параметра Идентификатор группы введите GUID группы безопасности.

3. Добавьте соединитель Microsoft Teams и выберите действие Опубликовать сообщение в чате или на канале.

4. Для Опубликовать как выберите Power Virtual Agents (предварительная версия).

5. Для Опубликовать в выберите Чат с ботом.

6. Для бота выберите агент, которому вы хотите отправить сообщение.

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

8. Для параметра Сообщение введите сообщение, которое требуется отправить.

   

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

Отправка проактивного сообщения параллельно нескольким получателям

Обычно при отправке проактивного сообщения нескольким получателям ваш агент будет отправлять одно сообщение за другим. Однако в некоторых ситуациях может быть предпочтительнее отправить сообщение нескольким получателям одновременно.

Предупреждение

Все проактивные сообщения из Copilot Studio подлежат ограничениям в Power Automate и ограничениям регулирования количества запросов соединителя Microsoft Teams.

Если вы отправляете сообщения большой группе получателей, вы увидите ошибки, если достигнете ограничения регулирования. Вы можете уменьшить степень параллелизма или уменьшить количество получателей в группе.

1. В действии Применить к каждому выберите три горизонтальные точки (. . .), затем выберите Параметры.

   

2. Включите Контроль параллелизма и установите степень параллелизма.

   

Настройка расширенных параметров для проактивных сообщений

Copilot Studio позволяет вам контролировать детальное поведение вашего агента в Показать дополнительные параметры в соединителе Microsoft Teams.

Отметка отправленного сообщения как уведомления

Элемент управления Отметить как уведомление определяет, будет ли добавлен текст "Уведомление через" в сообщении перед именем агента. Маркировка ответа агента позволяет получателю определить ответ агента на запрос.

Когда получатель в данный момент находится в активном чате с агентом

Иногда агент может отправлять проактивное сообщение, когда получатель находится в активном разговоре с агентом.

Вы можете отложить отправку проактивного сообщения до тех пор, пока они не закончат разговор, чтобы не нарушать его поток.

Поле Если чат активен позволяет контролировать поведение:

• Отправить: агент отправит проактивное сообщение как обычно.

• Не отправлять и получить успешный результат: агент не будет отправлять проактивное сообщение, когда получатель находится в активном разговоре. Возвращается код состояния 300.

• Не отправлять и получить ошибку: агент не будет отправлять проактивное сообщение, когда получатель находится в активном разговоре. Потоковое выполнение будет отмечено как сбой.

Когда получатель не установил агент

Агент может отправлять сообщения только получателям, которые установили агента в Microsoft Teams. Получатели могут не захотеть устанавливать агент или удалили агент.

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

Поле Если бот не установлен позволяет контролировать поведение:

• Сбой: потоковое выполнение будет отмечено как сбой, если получатель не установил агент в Microsoft Teams.

• Завершать успешно с кодом состояния: потоковое выполнение будет отмечено как успешное, даже если получатель не может получить сообщение или карточку, потому что не установил агент. Возвращается код состояния 100.

Определения кода состояния

Вы можете использовать возвращенный код состояния для определения различных последующих действий в вашем потоке. Например, вы можете указать, что поток должен повторить попытку в течение определенного периода времени, или зарегистрировать запись об ошибке.

Код состояния	Успешно (логический)	Description
200	Истина	Сообщение успешно доставлено.
100	False	Сообщение не может быть доставлено, потому что у получателя не установлен агент.
300	False	Сообщение не может быть доставлено, потому что получатель находится в активном разговоре с агентом.