Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Создайте именно тот пакет подключаемого модуля с нужной версией, который вы собираетесь протестировать и выпустить. Этот шаг происходит после того, как компоненты плагина начнут работать вместе в предполагаемой среде разработки или тестирования.
Важно
Файл .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-файл после упаковки, используя текущую процедуру проверки пакета в статье Тестирование и проверка подключаемого модуля.
Определение пакета и его зависимостей
Выберите предполагаемый маршрут публикации и распространения , прежде чем собирать артефакт выпуска. Для каждого маршрута определите:
- Идентификация: Идентификатор приложения, версия пакета и идентификаторы компонентов.
- Метаданные: Имена, описания, информация для разработчиков и значки, а также соответствующие ссылки на конфиденциальность и условия.
- Проверка подлинности: Модель удостоверений, поддерживаемая конфигурация авторизации, требования к разрешениям и согласию, а также ссылки на учетные данные.
- Соединения: Конечные точки, ссылки на подключения и конфигурация для конкретной среды.
- Внешние зависимости: Удаленные службы, источники данных, владельцы и настройка, необходимые вне пакета.
Помещайте в пакет только объявления и ссылки с поддержкой схемы. Сохраняйте оперативные сведения в записи о готовности к публикации, не указывая учетные данные или секреты.
| Маршрут распространения | Что нужно подтвердить для этого пакета |
|---|---|
| Прямой общий доступ для тестирования | Выбранная аудитория, тестовая среда, идентификаторы и метаданные пакета, а также проверка подлинности, подключения и внешние службы, необходимые тестировщикам. |
| Распределение по организации | Удостоверение пакета и метаданные для проверки администратором, а также проверка подлинности, подключение, разрешение и настройка внешней службы, необходимые в организации. |
| Общедоступное распространение | Удостоверение пакета и метаданные для выбранного маршрута отправки, а также проверка подлинности, подключения и внешние зависимости, которые должны настроить организации клиентов и пользователи. |
Предоставление общего доступа к пакету или его публикация не завершает установку, назначение, получение согласия или настройку подключения. Следуйте текущим требованиям выбранного маршрута; В этой статье не дается определение договора отправки.
Создание пакета
- Откройте процедуру упаковки для выбранного маршрута подключаемого модуля.
- Выберите нужную среду и точные версии протестированных компонентов.
- Выполните задокументированную команду, действие пользовательского интерфейса или автоматизированный рабочий процесс.
- Запишите имя артефакта, расположение, версию, среду и версию инструмента.
Проверьте созданный артефакт
Проверьте следующее.
- Идентификатор плагина и версия пакета верны.
- Пакет содержит ожидаемые манифесты, метаданные, конфигурацию и ресурсы.
- Объявления компонентов, файлы, идентификаторы, конечные точки и ссылки на службы соответствуют протестированным версиям.
- Пакет использует нужную конфигурацию среды.
- Требования проверки подлинности, разрешения, согласия и подключения декларируются без использования учетных данных, маркеров или секретов.
- Пакет не содержит временных файлов, журналов, тестовых данных или несвязанных артефактов.
Запись готовности к публикации
Вывод записи о готовности к публикации на тестирование и проверку и заполнение ее перед публикацией. Рекорд:
- Идентификатор пакета или артефакта и точная версия.
- Компоненты, удаленные службы и внешние ссылки.
- Средство упаковки и предполагаемый способ публикации.
- Протестированные возможности и среды Microsoft 365.
- Требования к проверке подлинности, разрешению, согласию и подключению.
- Доказательства и результат проверки.
- Известные ограничения, неподдерживаемые сочетания и принятые риски.
- Владелец выпуска и дата проверки.