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

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

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

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

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

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

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

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

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

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

3. Для Опубликовать как выберите Microsoft Copilot Studio агент.

4. Для публикации выберите «Общаться с агентом».

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

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

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

   

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

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

В этом разделе объясняется, как отправлять проактивные Adaptive Cards с помощью потоков Power Automate. На проактивной адаптивной карте пользователи могут получать информацию из неактивного разговора с агентом.

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

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

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

2. Для Опубликовать как выберите Microsoft Copilot Studio агент.

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"
           }
       ]
   }
   

   

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

Отправьте проактивную адаптивную карту и ждите ответа пользователя

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

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

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

2. Для Опубликовать как выберите Microsoft Copilot Studio агент.

3. Для публикации выберите «Общаться с агентом».

4. Для Message введите следующий шаблон 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. Для агента выберите агента, от которого хотите отправить карту.

   

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

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

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

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

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

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

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

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

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

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

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

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

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

7. Для Опубликовать как выберите Microsoft Copilot Studio агент.

8. Для публикации выберите «Общаться с агентом».

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

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

    

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

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

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

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

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

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

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

4. Для Опубликовать как выберите Microsoft Copilot Studio агент.

5. Для публикации выберите «Общаться с агентом».

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

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

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

   

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

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

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

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

   

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

   

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

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

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

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

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

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

Опция «Если чат с агентом активен» управляет поведением:

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

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

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

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

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

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

Опция «Если агент не установлен» управляет поведением:

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

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

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

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