Настройки пакетов подключаемых модулей для совместимых Copilot поверхностей. Форматы подключаемых модулей, компоненты и поддерживаемые расположения зависят от поверхности. Используйте документацию по поверхности, в которой планируется установить подключаемый модуль.
Манифесты подключаемого модуля
Подключаемый модуль описывается манифестом plugin.json . Подключаемые модули агента определяют переносимый формат подключаемого модуля для совместимых поверхностей. Манифест находится в корневом каталоге подключаемого модуля и объявляет схему подключаемых модулей агента. Для подключаемых модулей агента 1.0 используйте https://agent-plugins.org/schemas/1.0.0/plugin.schema.json.
Copilot CLI также распознает схему 1.1.0.
Формат подключаемых модулей общего агента определяет стандартные расположения для некоторых компонентов. Поддержка этих компонентов может отличаться по поверхности:
| Component | Расположение подключаемых модулей агента | Notes |
|---|---|---|
| Skills | skills/ | Совместимые поверхности могут обнаруживать навыки в этом расположении. |
| Серверы MCP | ||
mcp.json в корневом каталоге подключаемого модуля | Совместимые поверхности могут обнаруживать конфигурацию сервера MCP в этом расположении. | |
| компоненты Surface | Каталог пространства имен, например com.github.copilot/ | Доступность и поддерживаемые компоненты зависят от поверхности. |
Каталог подключаемых модулей агента 1.0 может использовать эту структуру:
my-plugin/
├── plugin.json
├── skills/
│ └── deploy/
│ └── SKILL.md
├── mcp.json
└── com.github.copilot/
├── agents/
│ └── helper.agent.md
├── commands/
├── rules/
├── hooks/
│ └── hooks.json
└── lsp.json
Манифест plugin.json объявляет схему подключаемых модулей агента. Расположения skills/ и корневые расположения определяются подключаемыми модулями mcp.json агента. Каталог com.github.copilot/ содержит компоненты Copilot, а не переносимые компоненты подключаемых модулей агента. Какие компоненты загружает поверхность из этого каталога, зависят от этой поверхности. Дополнительные сведения см. в Copilot CLIразделе Ссылка на плагин GitHub Copilot CLI.
Copilot CLI также поддерживает устаревший формат подключаемого Copilot модуля. В нем используются различные способы обнаружения компонентов и настраиваемые пути к компонентам. Сведения о полях манифеста, проверке, расположениях файлов и поведении интерфейса командной строки см. в разделе Ссылка на плагин GitHub Copilot CLI.
Visual Studio Code документирует формат разработки подключаемых модулей и поддерживается в справочнике по разработке подключаемых модулей агента. Не предполагайте, что на одной поверхности поддерживается поведение компонента или манифеста.
Каталог Marketplace
Каталог marketplace.json предоставляет метаданные о Marketplace и перечисляет подключаемые модули в своем массиве верхнего уровня plugins . Каждая запись подключаемого модуля может включать его имя, описание, версию и источник. Источник определяет расположение файлов подключаемого модуля. Для Copilot CLIэтого marketplace.json является единственным обязательным компонентом Marketplace. Другие поверхности могут иметь дополнительные требования.
Имя Marketplace исходит из его name поля, а не из имени репозитория. Идентификатор подключаемого модуля объединяет имя подключаемого модуля с именем Marketplace:
PLUGIN-NAME@MARKETPLACE-NAME
Сохраняйте имена marketplace и подключаемых модулей стабильными, если параметры ссылаются на них. Изменение имени Marketplace изменяет идентификаторы подключаемого модуля, используемые этими параметрами.
Поля каталога и поддерживаемые расположения файлов могут отличаться по поверхности. Полные поля и расположения каталога Marketplace см. в Copilot CLIразделе Ссылка на плагин GitHub Copilot CLI. Инструкции по публикации каталога в репозитории см. в GitHub разделе Создание и совместное использование подключаемого модуля Marketplace на GitHub.
Использование подключаемых модулей
Добавление Marketplace делает его подключаемые модули доступными для просмотра. Установка подключаемого модуля добавляет его в поверхность. Включение подключаемого модуля делает его компоненты доступными в сеансах на этой поверхности. Инструкции, относящиеся к поверхности, см. в следующих статье: