Подключите и настройте агент для Teams и Microsoft 365

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

Можно:

• Настройте внешний вид вашего агента в Teams и Microsoft 365 Copilot.
• Установите агент для себя в Teams и Microsoft 365 Copilot.
• Поделитесь ссылкой на установку агента с другими пользователями.
• Отобразить агент в магазине приложений Teams.
  • Покажите агент пользователям с общим доступом, добавив его в магазин приложений Teams в раздел Создано с помощью Power Platform.
  • Поделитесь агентом со своей организацией, отправив агент на утверждение администратору, чтобы он был размещен в магазине приложений Teams в разделе Создано для вашей организации.
• Добавьте агент в канал команды.
• Загрузите манифест приложения для своего агента, чтобы распространить его в своем арендаторе Teams.

Когда вы добавляете агент в Teams, некоторые из ваших данных, такие как контент агента и контент чата пользователя, передаются в Teams. Ваши данные могут передаваться за пределы области соблюдения требований вашей организации и географические или региональные границы. Дополнительные сведения см. в разделе Обзор разрешений и информации, к которой получают доступ приложения Teams.

Предпосылки

• Все пользователи агента в вашей организации могут использовать Microsoft 365 Copilot.

• Разработчики агентов имеют права создавать и получать доступ к среде Copilot Studio.

• Поделитесь своим агентом с другими пользователями, чтобы они могли установить агент и поговорить с ним в Teams и Microsoft 365 Copilot.

• Ваша организация должна разрешить добавление приложений Power Platform в Teams до того, как вы или другие пользователи сможете:

  • Напрямую установите агент в Teams, или
  • Найдите агента в разделе Built with Power Platform в магазине приложений Teams.

  Сотрудничайте со своим администратором, чтобы Управлять приложениями Microsoft Power Platform в центре администрирования Microsoft Teams, если это отключено для вашей организации.

• Администраторы управляют агентами, которые отображаются в разделе «Создано для вашей организации » (одобрено администратором) отдельно на странице «Управление приложениями» Центра админов Teams.

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

Подключите агента к каналам Teams и Microsoft 365 Copilot

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

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Если вы хотите, чтобы ваш агент был доступен как в Microsoft 365 Copilot, так и в Teams, под Включите Microsoft 365, убедитесь, что выбран Make agent available in Microsoft 365 Copilot

   Замечание

   Если вы не выберете Сделать агент доступным в Microsoft 365 Copilot, ваш агент будет доступен только в Teams.

3. Выберите Добавить канал.

   

Настройте внешний вид агента для Teams и Microsoft 365 Copilot

Прежде чем предоставлять агента другим пользователям, предоставьте правильное описание и оформление. Эта информация помогает пользователям понять цель и брендинг агента.

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Изменить сведения для изменения значка, цвета и описания агента. Эти атрибуты отображаются в магазине приложений Teams и на вкладке О программе приложения после того, как пользователь установит агент. Ознакомьтесь с рекомендациями по формату значков приложений для Teams.

   Это важно

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

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

3. Выберите Дополнительно для добавления следующей информации:

   • Имя разработчика
   • веб-сайт
   • Заявление о конфиденциальности
   • Условия использования

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

4. Нажмите кнопку "Сохранить". Ваши изменения цвета, значка и краткого описания теперь видны на панели конфигурации.

Установка агента в Teams и Microsoft 365 Copilot

После публикации вашего агента вы можете добавить его в профиль Teams напрямую через Copilot Studio.

Сначала добавьте своего агента в свой профиль в Teams, прежде чем делиться им с другими.

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Видеть агент в Teams.

   Если вы настроили агента так, чтобы он был доступен в Microsoft 365 Copilot при первом добавлении канала, выбор See agent in Teams устанавливает агента как в Teams, так и в Microsoft 365 Copilot. Если вы не настроили агент для Microsoft 365 Copilot, ваш агент устанавливается только в Teams.

3. Нажмите кнопку "Добавить".

   

   Агент появляется в списке агентов слева.

4. Чтобы задать вопрос новому агенту в Microsoft 365 Copilot, введите @, выберите своего агента из списка, введите свой вопрос и выберите Enter.

Поделитесь ссылкой, чтобы другие могли установить агент

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Параметры доступности.

3. Выберите команду Копировать ссылку.

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

Покажите агента в магазине приложений Teams или в магазине агентов Microsoft 365

После публикации вашего агента вы можете показать его в Teams App Store или в Agent Store Microsoft 365, чтобы пользователи могли найти и установить его.

Показать пользователям в Teams

Вы можете поделиться агентом, добавив его в раздел Создано с помощью Power Platform магазина приложений Teams. Только пользователи с общим доступом могут найти там агент.

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Параметры доступности.

3. Выберите Показывать моим коллегам и пользователям, которым предоставлен доступ и проверьте, у кого есть доступ к агенту.

4. Убедитесь, что галочка «Показать в «Построено вашим коллегам » выбрана и выбрать «Обновить».

   Ваш агент станет доступен в разделе Создано с помощью Power Platform в магазине приложений Teams, и на странице параметров доступности появится зеленая метка Добавлено в Teams.

   

Удаление агента из раздела "Создано с помощью Power Platform"

Можно удалить агент из раздела Создано с помощью Power Platform. Удаление агента из этого раздела не влияет на пользователей с установленным агентом.

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Параметры доступности.

3. Выберите «Показать моим коллегам по команде и общим пользователям » и очистите галочку «Показать» в «Построено вашими коллегами ».

4. Выберите Поделиться. Агент больше не отображается в разделе Создано с помощью Power Platform в магазине приложений Teams.

Показать организации

Вы можете поделиться агентом с организацией, отправив его на утверждение администратору, чтобы он был показан в магазине приложений Teams в разделе Создано для вашей организации. Если вы также публикуете своего агента в Microsoft 365, отправка его на одобрение администратором также применяется в Agent Store Microsoft 365. Размещение вашего приложения в магазине приложений Teams и в Agent Store Microsoft 365 — отличный способ широко распространить информацию о вашем агенте, сотрудничая с администратором, чтобы распространить его среди всех в организации или для некоторых пользователей.

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

Перед отправкой агента в вашу организацию убедитесь, что:

• Агент готов к выпуску и соответствует стандартам, правилам и политикам компании.
• Вы координируете свои действия с другими менеджерами агента. После того, как вы отправите агент, другой пользователь не сможет отправить его повторно, пока администратор не одобрит или не отклонит предыдущую отправку.
• Вы удаляете агента, если это применимо, из раздела Создано с помощью Power Platform магазина приложений Teams. В противном случае, если вы отправите агент на утверждение администратора, он может оказаться в двух местах.

Подайте заявку на одобрение от администратора

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Параметры доступности.

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

4. Выберите Показывать всем в моей организации.

5. Ознакомьтесь с требованиями для отправки и выберите Отправить на утверждение администратором.

   Замечание

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

   После утверждения агента все новые и существующие пользователи агента в Teams и Microsoft 365 Copilot получают обновление.

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

   Появляется окончательное подтверждение.

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

   Замечание

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

   Установка доступа меньше всех приводит к тому, что пользователи организации не могут общаться с агентом после установки его из Teams App Store или Agent Store Microsoft 365.

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

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

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

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

Разрешение пользователям добавлять агент в рабочую группу в Teams

В Teams пользователи могут добавлять агент в определенную команду. После того как агент станет доступен рабочей группе, участники рабочей группы могут «@упомянуть» его в любых каналах рабочей группы, и все сотрудники группы увидят ответы от агента. Эта функция полезна в следующих ситуациях:

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

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

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

• Добавление агента в канал рабочей группы
• Добавление агента в групповые чаты и чаты встреч в Teams

Участники рабочей группы также могут удалить агент из команды.

Чтобы разрешить пользователям добавлять агент в рабочую группу:

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Изменить сведения.

3. Выберите Разрешить пользователям добавлять этот агент в рабочую группу.

4. Нажмите кнопку "Сохранить".

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

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

Запрет пользователям добавлять агент в чаты рабочей группы, группы и собрания

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

Чтобы запретить пользователям добавлять агент в рабочую группу, выполните следующие действия:

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Изменить сведения.

3. Очистите, чтобы пользователи могли добавить этот агент в командный блок.

4. Нажмите кнопку "Сохранить".

Настройка поведения личного приветствия

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

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

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

Чтобы настроить, когда агент отправляет личное приветствие:

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Параметры.

3. Настройте параметры личного приветствия.

4. Нажмите кнопку "Сохранить".

Загрузите манифест приложения Teams для агента (дополнительно)

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

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Параметры доступности.

3. Выберите Загрузить ZIP. Манифест генерируется в виде .zip-файла и сохраняется в соответствии с настройками браузера.

4. В Teams выберите Приложения>Управление приложениями>Загрузка приложения.

5. Выберите Отправить настроенное приложение.

6. Просмотрите скачанный файл .zip.

Отключение агента от Teams

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

Отключенные агенты не отображаются в разделе Создано с помощью Power Platform магазина приложений Teams и не могут быть установлены по общей ссылке. Если у пользователя уже установлен такой агент в Teams, он остается доступным до тех пор, пока пользователь не удалит его.

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

1. Откройте панель конфигурации для Teams и Microsoft 365 Copilot каналов.

2. Выберите Удалить канал.

3. Просмотрите информацию об отключении вашего агента и выберите Отключить, чтобы продолжить.

Вы всегда можете переподключить агента, выбрав Add канал в панели конфигурации для каналов Teams и Microsoft 365 Copilot, затем перепубликовав и затем переустановив агент в Teams.

Откройте панель конфигурации для каналов Teams и Microsoft 365 Copilot

1. Откройте агент в Copilot Studio.

2. В верхней строке меню выберите Каналы.

3. Выберите плитку Teams и Microsoft 365 Copilot. Появится панель конфигурации.

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

Известные ограничения различаются в зависимости от того, используете ли вы Teams или Microsoft 365 Copilot.

Известные ограничения в командах

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

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

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

• Если ваш агент поддерживает аутентификацию пользователя, пользователь не может явно выйти из системы. Такое поведение не соответствует сертификации Teams Marketplace, если вы публикуете своего агента в панели управления продавцом. Это ограничение не относится к личному использованию агента или использованию в рамках арендатора. Узнайте, как опубликовать ваше приложение в Teams Store и узнать о политике сертификации Marketplace.

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

• В групповых чатах и каналах Teams агенты Copilot Studio не могут использовать источники знаний, требующие аутентификации конечного пользователя, такие как SharePoint. Это ограничение предусмотрено и помогает предотвратить непреднамеренное распространение данных. Эти агенты поддерживаются только в 1:1 чатах.

• Групповые чаты и чаты собраний не поддерживают агентов, настроенных для проверки подлинности вручную с единым входом (SSO) для Teams. В зависимости от потребностей вашего бизнеса вы можете либо аутентифицировать с помощью Microsoft, либо удалить единый вход для Teams из вашей ручной аутентификации.

Ссылки не отображаются для индивидуальных ответов

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

Чтобы отобразить цитаты из персонализированного генеративного ответа в Teams:

1. В панели свойств генеративных ответов разверните раздел Расширенные и установите ответ Сохранить LLM на Complete (Recommended). Эта настройка фиксирует полный ответ, включая метаданные цитирования.

2. В редакторе кода темы добавьте SendActivity узел после узла генеративных ответов. Включите citationEntities атрибуты и text атрибуты под activity, указывая на переменные, содержащие цитаты и текст ответа:

   - kind: SearchAndSummarizeContent
     id: search-content
     latencyMessageSettings:
       allowLatencyMessage: false
     autoSend: false
     variable: Topic.Answer
     userInput: =System.Activity.Text
     responseCaptureType: FullResponse
   
   - kind: SendActivity
     id: sendActivity_SnMFMq
     activity:
       text:
         - "{Topic.Answer.Text.Content}"
       citationEntities: =Topic.Answer.Text.CitationSources
   

Для получения дополнительной информации о темах редактирования в редакторе кода узнайте в разделе «Редактирование тем» с редактором кода.

SystemError после публикации или повторной публикации агента

Когда пользователи взаимодействуют с агент Copilot в Teams, они могут увидеть следующее сообщение:

Извините, случилось нечто неожиданное. Мы этим занимаемся.
Код ошибки: SystemError

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

Workaround

Чтобы обновить конфигурацию агента, попробуйте следующие шаги:

1. В административном центре Microsoft Teams найдите приложение агента, отключите его, подождите несколько секунд и затем снова включите.
2. В Copilot Studio отключите канал Teams для агента, сохраните изменения и затем снова включите канал.
3. Перепубликуйте агент, чтобы убедиться, что последняя версия доступна для Teams.

Если проблема сохраняется, свяжитесь с служба поддержки Майкрософт и укажите Conversation ID, Agent ID и time когда возникла ошибка.

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

• Тема начала разговора не поддерживается: Канал Microsoft 365 Copilot не поддерживает тему Начало разговора, поэтому общие приветствия невозможны. Вместо этого агент предлагает рекомендации. Вы можете задавать переменные через темы, вызываемые событием активности, но этот способ не идеален для приветствий из-за побочных эффектов.

• Неподдерживаемые типы медиа: Медиа, такие как GIF-изображения, не рендерятся.

• Embedded URLs: Microsoft 365 Copilot может удалить встроенные URL для безопасности. Цитаты из генеративных ответов должны содержать URL-адреса в разделе цитирования.

• Неподдерживаемые типы узлов:

  • Операции речи
  • Передача информации представителю службы поддержки клиентов
  • Adaptive Cards с Action.Execute

• Неподдерживаемые типы сообщений:

  • Базовые карты (ContentFiltered ошибка)
  • Видео (ContentFiltered ошибка)
  • Изображение (ContentFiltered ошибка)
  • File
  • Речь (не отправлена)

  Замечание

  Вы можете использовать Adaptive Cards для отображения изображений.

• Неактивность вызывает срабатывание, но не отправляет сообщения обратно на Microsoft 365 Copilot.

• Агенты, опубликованные для Microsoft 365 Copilot, не поддерживают отзывы пользователей (реакции).

Связанная информация

• Развернуть агентов в Microsoft Teams