Рекомендации по проверке для агентов Copilot

Важно!

• Подключаемые модули для Microsoft 365 Copilot доступны в предварительной версии и работают только в Microsoft 365 Copilot.
• Подключаемые модули расширений сообщений в Microsoft 365 Copilot доступны в общедоступной предварительной версии для Microsoft Word и Microsoft PowerPoint.
• Поддержка клиентских приложений Excel и OneNote станет доступна в ближайшее время.
• Убедитесь, что Microsoft 365 Copilot доступны для вашей организации. Вы можете получить среду разработчика для Microsoft 365 Copilot двумя способами:
  • Клиент песочницы Microsoft 365 с Microsoft 365 Copilot (доступна в ограниченной предварительной версии через членство в TAP).
  • Корпоративная клиентская рабочая среда с Microsoft 365 Copilot лицензиями.
• Если вы хотите настроить пользовательский соединитель Graph для Microsoft 365 Copilot, обязательно соблюдайте рекомендации по созданию или обновлению соединителей Graph.

Этот раздел соответствует политике коммерческой платформы Майкрософт no 1140.9.

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

Описание

Хорошее описание содержит четкое и краткое описание функций агента Copilot. Это повышает осведомленность пользователей и позволяет Microsoft 365 Copilot эффективно обнаруживать и выполнять операции поиска.

Необходимо обеспечить соблюдение следующих рекомендаций для агентов Copilot:

• Применимы рекомендации по проверке в Магазине Teams, связанные с описанием приложений Microsoft 365. Дополнительные сведения см. в разделе описания приложений.

• Краткое описание агента Copilot, параметра, описания команды, семантического описания и идентификатора операции не должно включать:

  • Инструктивные фразы, например "если пользователь говорит X", "игнорировать", "удалить", "сброс", "новые инструкции", "Ответ полужирным шрифтом" или "Ничего не выводить". [Необходимо исправить]
  • URL-адреса, эмодзи или скрытые символы, такие как шестнадцатеричные, двоичные или нетрадиционные символы. [Необходимо исправить]
  • Грамматические ошибки и ошибки препинания. [Необходимо исправить]
  • Слишком подробный, цветочный или маркетинговый язык. [Хорошо для исправления]
  • Превосходные утверждения, такие как "#1", "удивительный" или "лучший". [Хорошо для исправления]

  Примечание.

  • В случае декларативных агентов к полям и conversation_starters также применяются рекомендации по краткому описаниюinstructions.
  • Для подключаемых модулей на основе API эти рекомендации применяются к description_for_human, description_for_model, capabilities, conversation_starters (как заголовок, так и текст) states\reasoning\description в functions полях, если они указаны. [Необходимо исправить]
  • При использовании форматов файлов Swagger или OpenAPI соблюдайте эти рекомендации для содержимого, связанного path с ключами, и description поля для API GET, POST, PUT или DELETE. [Необходимо исправить]

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

  

  

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

К началу страницы

Снимки экрана

Необходимо обеспечить соблюдение следующих рекомендаций для агентов Copilot:

• Применимы рекомендации по проверке в Магазине Teams, связанные со снимками экрана для приложений Microsoft 365. Дополнительные сведения см. в разделе Снимки экрана.
• Приложения с функциями агента Copilot должны иметь один снимок экрана, связанный с функциональностью Microsoft 365 Copilot. [Необходимо исправить]

К началу страницы

Имя агента Copilot

Необходимо обеспечить соблюдение следующих рекомендаций для агентов Copilot:

• Применимы рекомендации по проверке магазина Teams, связанные с именем приложений Microsoft 365. Дополнительные сведения см. в разделе Имя приложения.
• Для декларативного агента убедитесь, что следующие параметры идентичны: [Должно быть исправлено]
  • name в манифесте приложения
  • name в declarativeAgent1.json
  • name_for_human в файлах plugin.json

К началу страницы

Составные речевые фрагменты

Агенты Copilot должны поддерживать три уникальных составных речевых фрагмента путем обработки трех или более параметров.

К началу страницы

Запросы

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

Примеры запросов

Свойство samplePrompts предоставляет пользователям рекомендации по использованию различных подключаемых модулей в Microsoft 365 Copilot.

Примеры запросов задаются с помощью samplePrompts свойства в манифесте приложения. Эти запросы должны соответствовать следующим требованиям:

• Подключаемый модуль должен содержать не менее трех запросов и не более пяти запросов для каждой команды. [Необходимо исправить]
• Каждый запрос не должен превышать 128 символов. [Необходимо исправить]
• Две команды в одном подключаемом модуле не должны иметь одинаковые запросы. [Необходимо исправить]
• Примеры запросов должны быть универсальными по своей природе и не включать пользовательские ссылки. Например, имена проектов и задачи. [Необходимо исправить]
• Все примеры запросов должны быть функциональными и возвращать ответы. [Необходимо исправить]
• Запрос должен быть связан с командами. [Необходимо исправить]

Начальные запросы

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

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

К началу страницы

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

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

• Ответ адаптивной карточки должен включать содержимое адаптивной карточки и предварительный просмотр карта сведения в рамках одного шаблона. [Необходимо исправить]

  

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

  

• Адаптивная карточка должна быть хорошо отформатирована для настольных, веб-клиентов и мобильных клиентов (iOS и Android). [Необходимо исправить]

• Адаптивные карточки должны содержать URL-адрес в составе метаданных, что позволяет легко копировать карточки из одного концентратора в другой. [Необходимо исправить]

К началу страницы

Совместимость

Агенты Copilot должны полностью реагировать и работать в последних версиях этих клиентов: [Должно быть исправлено]

• Microsoft Teams на рабочем столе и в Интернете
• copilot.microsoft.com в Интернете
• Microsoft 365 Copilot в Word

Убедитесь, что подключаемые модули Copilot работают в собраниях Teams

Необходимо реализовать следующее:

• Адаптивные карточки не должны отображать горизонтальную прокрутку. Чтобы избежать горизонтальной прокрутки, не указывайте фиксированную ширину: [Должно быть исправлено]

  • Наборы столбцов

    • Не определяйте ColumnSets с более чем тремя столбцами.
    • Не используйте явную ширину пикселей для нескольких столбцов в наборе.
    • Убедитесь, что столбец не превышает одну четверть от ширины самого узкого карта, например в чате собрания или Microsoft 365 Copilot.
    • Как правило, явная ширина не должна превышать 48 пикселей, хотя в некоторых сценариях могут быть исключения.

  • Изменение размера изображений

    • При использовании изображения внутри ColumnSet с несколькими столбцами укажите размер столбца, содержащего изображение, а не само изображение.
    • Если изображение не в ColumnSet, рекомендуется задать для его размера auto значение или stretch.
    • Если вы хотите определить явную ширину в пикселях, убедитесь, что она не превышает три четверти самой узкой карта ширины.
    • Если вы хотите определить явный размер в пикселях, определите его для ширины или высоты. Если задать явный размер для любого параметра, пропорции изображения сохраняются.
    • Рекомендуется задать ширину образа, хотя в некоторых сценариях могут быть разрешены исключения.

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

К началу страницы

Убедитесь, что агенты Copilot работают с Microsoft 365 — Word, Excel, PowerPoint, OneNote, Office и Outlook Copilots

Необходимо обеспечить соблюдение следующих рекомендаций для агентов Copilot:

1. При использовании приложения с поддержкой единого входа обновите Microsoft Entra регистрации приложения: [Необходимо исправить]

   Microsoft Entra единого входа для расширения message работает так же, как в Teams или Outlook. Если вы включили единый вход для приложения, добавьте идентификатор клиентского приложения Office Copilot в Microsoft Entra регистрации приложения бота на портале Регистрация приложений клиента.

   1. Войдите на портал Azure с помощью учетной записи клиента песочницы.

   2. Откройте Регистрации приложений.

   3. Выберите имя приложения, чтобы открыть его регистрацию.

   4. В разделе Управление выберите Предоставить API.

   5. В разделе Авторизованные клиентские приложения убедитесь, что указаны следующие значения идентификаторов клиента:

      Клиентское приложение Microsoft 365	Идентификатор клиента
      Word, PowerPoint, Excel (интернет, настольный компьютер)	3068386c-7a16-4f6a-a64-043b6b232816
      Классическое, мобильное приложение Teams	1fec8e78-bce4-4aaf-ab1b-5451cc387264
      Веб-приложение Teams	5e3ce6c0-2b1f-4285-8d4b-75ee78787346
      Microsoft 365 web	4765445b-32c6-49b0-83e6-1d93765276ca
      Microsoft 365 desktop	0ec893e0-5785-4de6-99da-4ed124e5296c
      Microsoft 365 mobile	d3590ed6-52b3-4102-aeff-aad2292ab01c
      Классическое приложение Outlook	d3590ed6-52b3-4102-aeff-aad2292ab01c
      Outlook Web	bc59ab01-8403-45c6-8796-ac3ef710b3e3
      Outlook Mobile	27922004-5251-4030-b22d-91ecd9a37ea4
      Bing	9ea1ad79-fdb6-4f9a-8bc3-2b70f96e34c7

      Примечание.

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

2. Убедитесь, что зарегистрированный бот подключен к Microsoft 365 и каналу Microsoft Teams: [Необходимо исправить]

   1. Войдите на портал Azure с помощью учетной записи клиента песочницы.
   2. Откройте Bot Services.
   3. Выберите имя бота, чтобы обновить его каналы.
   4. В разделе Параметры выберите Каналы.
   5. В разделе Доступные каналы выберите Microsoft 365 & Microsoft Teams, а затем нажмите кнопку Применить.

3. Настройка заголовков политики безопасности содержимого [необходимо исправить]

   Если агент Copilot использует заголовки политики безопасности содержимого (CSP), убедитесь, что в заголовки CSP включены все следующие предки кадров :

   Приложение Microsoft 365	frame-ancestors разрешение
   Все узлы (новые)	*.cloud.microsoft
   Word	fa000000125.resources.office.net
   PowerPoint	fa000000129.resources.office.net
   Excel	fa000000124.resources.office.net
   OneNote	fa000000128.resources.office.net
   Microsoft 365 Copilot и Bing	edgeservices.bing.com, www.bing.com, copilot.microsoft.com
   Приложение Microsoft 365	*.microsoft365.com, *.office.com
   Outlook	outlook.office.com, outlook.office365.com, outlook-sdf.office.com, outlook-sdf.office365.com
   Office.com	Office.com/copilot Office.com/chat
   Microsoft365.com	Microsoft365.com/copilot Microsoft365.com/chat
   M365.cloud.microsoft	M365.cloud.microsoft/chat M365.cloud.microsoft/copilot
   Copilot.cloud.microsoft	Copilot.cloud.microsoft

4. Обновление версии Teams JS до сборки 2.22.0 [должно быть исправлено]

   Если вы используете Teams JS версии 2.22 или более ранней, обновите ее до версии 2.22 или более поздней. 

   Дополнительные сведения см. в разделе Репозиторий JS Teams @microsoft/teams-js — npm (npmjs.com)).

К началу страницы

Технические требования

Чтобы агент Copilot проверялся, вызывался и работал без проблем, убедитесь, что он соответствует следующим критериям: [Должно быть исправлено]

Критерии	Выполнение
Версия манифеста	Манифест приложения должен быть версии 1.13 или более поздней. [Необходимо исправить] Если вы используете декларативный агент, необходимо использовать схему манифеста общедоступной предварительной версии приложения для разработчиков. [Необходимо исправить]
Время отклика	Время отклика не должно превышать девять секунд для 99 процентов, пять секунд для 75 процентов и две секунды для 50 процентов. [Необходимо исправить]
Надежность	Приложения должны поддерживать доступность 99,9 %. Например, если Microsoft 365 Copilot вызывает подключаемый модуль 1000 раз, он должен предоставить значимый ответ 999 раз. [Необходимо исправить]
Ноль регрессий	Если вам нужно повторно отправить агент Copilot для проверки, существующие функции расширения сообщений, которые работали ранее, не должны прерываться. Это требование применимо только к приложениям независимых поставщиков программного обеспечения (ISV), а не к приложениям, созданным для вашей организации. [Необходимо исправить]
Канал Microsoft 365	Чтобы пользователи взаимодействовали с расширением сообщений из Outlook, необходимо добавить в бот канал Microsoft 365. Дополнительные сведения см. в статье Добавление канала Microsoft 365 для приложения. [Необходимо исправить]
Единый вход (SSO)	Если применимо, обновите регистрацию приложения Microsoft Entra для единого входа. [Необходимо исправить]
Политика безопасности содержимого (CSP)	Если применимо, измените заголовки CSP и X-Frame-Options в соответствии с настройкой заголовков политики безопасности содержимого. [Необходимо исправить]

К началу страницы

Раскрытие пользователем и подтверждение сценариев действий

Для сценариев действий агенты Copilot должны предоставить общий доступ к раскрытию информации о пользователе и получить подтверждение пользователя:

• Данные, отображаемые в сторонней службе (через диалог), должны отражать подтверждение, предоставленное пользователем. [Необходимо исправить]
• Подтверждение завершения действия должно быть предоставлено подключаемым модулем в виде карта. [Необходимо исправить]
• Действия, выполняемые пользователем, должны правильно отражаться в сторонней службе. [Необходимо исправить]
• Запросы на изменение от пользователя до подтверждения действия должны быть учтены. [Необходимо исправить]
• Строго последовательные задачи, такие как массовое удаление, не должны поддерживаться. [Хорошо для исправления]

К началу страницы

Агент Copilot должен иметь действие или источник знаний

Ваш агент Copilot должен иметь узлы, определенные как действия или соединители Graph в манифесте приложения. Это гарантирует, что ответы агента Copilot зависят от источника данных. [Необходимо исправить]

К началу страницы

Правильная обработка ошибок

Все агенты Copilot должны корректно обрабатывать следующие сценарии, то есть агент должен отклонить запрос пользователя и предоставить путь вперед: [Необходимо исправить]

• Для неправильных параметров поиска

• За неправильное использование или неподобающее язык

• Для тем, в которых агент Copilot не специализируется

  Например, корректное сообщение об ошибке с путем пересылки для декларативного агента:

  

К началу страницы

Требования к безопасности для URL-адреса спецификации OpenAPI

Агенты Copilot, использующие спецификации OpenAPI, должны обеспечивать следующие стандарты безопасности:

• Все вызовы API должны использовать ПРОТОКОЛ HTTPS с TLS 1.2 или более поздней версии. [Необходимо исправить]
• Вызовы API не должны приводить к перенаправлению URL-адресов. Фактические вызовы API должны обслуживаться из того же домена или поддомена, что и корневой домен, проверенный разработчиком. [Необходимо исправить]

К началу страницы

См. также

• Инструкции магазина Teams по проверке приложений
• Рекомендации по созданию и обновлению агентов Copilot
• Расширение расширения сообщений на основе бота в качестве подключаемого модуля для Microsoft 365 Copilot
• Расширение Microsoft 365 Copilot