# Справочник по подключаемым модулям и Marketplace

Поиск общих подключаемых модулей и терминов Marketplace, форматов файлов и ссылок на документацию по конкретным поверхностям.

Настройки пакетов подключаемых модулей для совместимых 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/NAME/SKILL.md`                                                                   | Совместимые поверхности могут обнаруживать навыки в этом расположении. |
| Серверы MCP                                         |                                                                                          |                                                                        |
| `mcp.json` в корневом каталоге подключаемого модуля | Совместимые поверхности могут обнаруживать конфигурацию сервера MCP в этом расположении. |                                                                        |
| компоненты Surface                                  | Каталог пространства имен, например `com.github.copilot/`                                | Доступность и поддерживаемые компоненты зависят от поверхности.        |

Каталог подключаемых модулей агента 1.0 может использовать эту структуру:

```text
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](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference#components).

Copilot CLI также поддерживает устаревший формат подключаемого Copilot модуля. В нем используются различные способы обнаружения компонентов и настраиваемые пути к компонентам. Сведения о полях манифеста, проверке, расположениях файлов и поведении интерфейса командной строки см. в разделе [Ссылка на плагин GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference).

Visual Studio Code документирует формат разработки подключаемых модулей и поддерживается в [справочнике по разработке подключаемых модулей агента](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference). Не предполагайте, что на одной поверхности поддерживается поведение компонента или манифеста.

## Каталог Marketplace

Каталог `marketplace.json` предоставляет метаданные о Marketplace и перечисляет подключаемые модули в своем массиве верхнего уровня `plugins` . Каждая запись подключаемого модуля может включать его имя, описание, версию и источник. Источник определяет расположение файлов подключаемого модуля. Для Copilot CLIэтого `marketplace.json` является единственным обязательным компонентом Marketplace. Другие поверхности могут иметь дополнительные требования.

Имя Marketplace исходит из его `name` поля, а не из имени репозитория. Идентификатор подключаемого модуля объединяет имя подключаемого модуля с именем Marketplace:

```text
PLUGIN-NAME@MARKETPLACE-NAME
```

Сохраняйте имена marketplace и подключаемых модулей стабильными, если параметры ссылаются на них. Изменение имени Marketplace изменяет идентификаторы подключаемого модуля, используемые этими параметрами.

Поля каталога и поддерживаемые расположения файлов могут отличаться по поверхности. Полные поля и расположения каталога Marketplace см. в Copilot CLIразделе [Ссылка на плагин GitHub Copilot CLI](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference#marketplacejson). Инструкции по публикации каталога в репозитории см. в GitHub разделе [Создание и совместное использование подключаемого модуля Marketplace на GitHub](/ru/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces).

## Использование подключаемых модулей

Добавление Marketplace делает его подключаемые модули доступными для просмотра. Установка подключаемого модуля добавляет его в поверхность. Включение подключаемого модуля делает его компоненты доступными в сеансах на этой поверхности. Инструкции, относящиеся к поверхности, см. в следующих статье:

* [Использование подключаемых модулей в Visual Studio Code](/ru/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/using-plugins)
* [Поиск и установка плагинов для GitHub Copilot CLI](/ru/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)
* [Настройка приложения GitHub приложение Copilot](/ru/copilot/how-tos/github-copilot-app/customize-github-copilot-app)
* [Настройка параметров для GitHub Copilot в облаке](/ru/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings)