Подключение и настройка агента для 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.
• Ваша организация должна разрешить добавление приложений Microsoft Power Platform в Teams, прежде чем вы или другие пользователи сможете напрямую установить агент в Teams или найти его в разделе Создано с помощью Power Platform в магазине приложений Teams. Сотрудничайте со своим администратором, чтобы Управлять приложениями Microsoft Power Platform в центре администрирования Microsoft Teams, если это отключено для вашей организации.
• Агенты, которые отображаются в разделе Создано для вашей организации (утвержденные администратором), управляются отдельно администраторами в центре администрирования Teams на странице управления приложениями.
• Перед тем, как установить агент для себя или поделиться им с другими, вы должны опубликовать агент хотя бы один раз.

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

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

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

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

   Заметка

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

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

   

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

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

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

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

   Внимание!

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

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

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

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

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

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

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

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

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

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

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

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

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

   

   В Teams агент отображается в списке агентов слева. В Microsoft 365 Copilot агент появляется в списке агентов справа.

4. Чтобы задать новому агенту вопрос в Teams, выберите агент из списка, затем введите свой вопрос и нажмите клавишу ВВОД.

5. Чтобы задать новому агенту вопрос в Microsoft 365 Copilot, введите @, выберите свой агент из появившегося списка, затем введите свой вопрос и выберите ВВОД.

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

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

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

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

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

Отображение агента в магазине приложений Teams

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

Показать пользователям с общим доступом

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

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

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

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

4. Убедитесь, что установлен флажок Показывать в разделе "Создано с помощью Power Platform", и выберите Поделиться.

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

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

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

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

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

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

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

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

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

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

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

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

Отправьте агент в раздел «Создано для вашей организации»

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

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

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

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

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

   Заметка

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

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

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

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

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

   Заметка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4. Выберите Сохранить.

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

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

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

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

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

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

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

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

4. Выберите Сохранить.

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

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

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

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

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

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

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

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

4. Выберите Сохранить.

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

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

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

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

3. Выберите Загрузить ZIP.

   Манифест создается как файл ZIP и сохраняется в соответствии с настройками сохранения вашего браузера.

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

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

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

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

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

2. Выберите Отключить бота от Teams.

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

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

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

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

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

3. Перейдите на плитку Microsoft Teams. Появится панель конфигурации.

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

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