Упаковка подключаемого модуля для Microsoft 365 Copilot

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

Важно

Файл .zip не является автоматически поддерживаемым пакетом подключаемого модуля. Используйте способ упаковки, только если он поддерживает компоненты подключаемого модуля и возможности Microsoft 365, которые вы планируете опубликовать.

В этой статье описывается пакет приложения Microsoft 365, используемый задокументированным рабочим процессом подключаемого модуля Copilot Cowork. Некоторые инструменты создают пакет за вас; Другие рабочие процессы позволяют собирать его вручную. Используйте руководство по выбору продукта в отношении поддерживаемых компонентов, версии манифеста и маршрута публикации. Формат общего пакета не гарантирует, что все продукты поддерживают одинаковые возможности.

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

Подготовка

Полное интеграционное тестирование. Подтвердите следующее.

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

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

Общие сведения о пакете приложений Microsoft 365

Пакет представляет собой ZIP-файл со manifest.json ссылками на значки в корневой папке. Схема манифеста приложения Microsoft 365 определяет объявления его удостоверений, метаданных и возможностей.

Содержимое пакета Цель
manifest.json Определяет приложение, версию, разработчика, имена, описания, значки и поддерживаемые возможности.
Значки Файлы изображений цвета и контура, на которые ссылается манифест приложения. Рабочий процесс Cowork документирует color.png и outline.png.
Навыки агента При включении папки навыков содержат SKILL.md и поддерживаемые сопутствующие файлы. Манифест приложения ссылается на папки через agentSkills.
Удаленная настройка соединителя Записи в манифесте приложения (при включении) agentConnectors определяют удаленные конечные точки MCP и применимую конфигурацию авторизации. Сам сервер не упакован.
Ссылочные файлы компонентов Включите файлы, необходимые для выбранных компонентов, например файл описания инструмента, если конфигурация соединителя ссылается на него, или определения агентов в поддерживаемый пакет агентов.

Например, в документации по Cowork показан пакет с таким макетом:

manifest.json
color.png
outline.png
skills/
  contract-analysis/
    SKILL.md
    references/
      clause-taxonomy.md
tools/
  contoso-legal-tools.json

Папки навыков присутствуют, только если плагин включает навыки. Файл описания инструмента нужен только в том случае, если на него ссылается конфигурация соединителя. Следите за подключаемыми модулями сборки для Copilot Cowork для получения требований к текущему файлу, версии схемы, значку и навыкам, а не рассматривайте пример как шаблон для каждого продукта.

Примечание

Схема манифеста подключаемого модуля 2.4 описывает компонент действия API или MCP для декларативного агента, а не внешний пакет приложения Microsoft 365. Эти действия доступны только содержащему их агенту. Используйте схему манифеста приложения для внешнего пакета.

Выберите поддерживаемый путь упаковки

Маршрут пакета плагина Создание пакета Result (Результат)
Проект подключаемого модуля средств разработчика Work IQ (рекомендуемый путь прокода для поддерживаемых сценариев) Выполните задокументированные действия по проверке и подготовке источника для выбранной среды, а затем запустите wiqd plugin package. См. раздел "Создание подключаемого модуля с помощью средств разработчика для Work IQ". Пакет приложения с управлением версиями, который необходимо проверить перед предоставлением общего доступа или публикацией.
Пакет подключаемого модуля, созданный с помощью набора средств агентов Microsoft 365, если выбранный рабочий процесс поддерживает компоненты и целевые интерфейсы подключаемого модуля Выберите пакет приложения Zip для Teams или используйте действие жизненного teamsApp/zipAppPackage цикла. См. раздел Настройка манифеста приложения в наборе средств Agents. Пакет плагинов, созданный поддерживаемым рабочим процессом.
Собранный вручную пакет подключаемого модуля Cowork Следуйте инструкциям по макету манифеста, навыка, соединителя, значка и ZIP в статье Создание подключаемых модулей для Copilot Cowork. Пакет приложений Microsoft 365 для задокументированного маршрута Cowork.

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

Для навыков, используемых непосредственно в Copilot Chat, упаковка навыков уровня подключаемого модуля через свойство agentSkills манифеста приложения. Это отличается от свойства манифеста декларативного агента agent_skills . Автономный SKILL.md ZIP-архив или ZIP-архив навыков, принимаемый Chat, не является полным пакетом подключаемого модуля. См. статью Упаковка навыка в плагин.

Инструкции по автоматизации проверок источника WIQD, упаковки кандидатов и проверки первого пакета см. в статье Настройка подключаемого модуля CI/CD с помощью средств разработчика Work IQ.

Примечание

Проверка источника WIQD не является полной проверкой собранного пакета. Проверьте точный ZIP-файл после упаковки, используя текущую процедуру проверки пакета в статье Тестирование и проверка подключаемого модуля.

Определение пакета и его зависимостей

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

  • Идентификация: Идентификатор приложения, версия пакета и идентификаторы компонентов.
  • Метаданные: Имена, описания, информация для разработчиков и значки, а также соответствующие ссылки на конфиденциальность и условия.
  • Проверка подлинности: Модель удостоверений, поддерживаемая конфигурация авторизации, требования к разрешениям и согласию, а также ссылки на учетные данные.
  • Соединения: Конечные точки, ссылки на подключения и конфигурация для конкретной среды.
  • Внешние зависимости: Удаленные службы, источники данных, владельцы и настройка, необходимые вне пакета.

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

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

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

Создание пакета

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

Проверьте созданный артефакт

Проверьте следующее.

  • Идентификатор плагина и версия пакета верны.
  • Пакет содержит ожидаемые манифесты, метаданные, конфигурацию и ресурсы.
  • Объявления компонентов, файлы, идентификаторы, конечные точки и ссылки на службы соответствуют протестированным версиям.
  • Пакет использует нужную конфигурацию среды.
  • Требования проверки подлинности, разрешения, согласия и подключения декларируются без использования учетных данных, маркеров или секретов.
  • Пакет не содержит временных файлов, журналов, тестовых данных или несвязанных артефактов.

Запись готовности к публикации

Вывод записи о готовности к публикации на тестирование и проверку и заполнение ее перед публикацией. Рекорд:

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

Следующий этап