# Подключаемые модули для GitHub Copilot

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

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

## Где можно использовать подключаемые модули

Подключаемые модули доступны на этих Copilot поверхностях:

* Visual Studio Code. Просмотрите и установите подключаемые модули из меню **"Настройка** " на боковой панели чата или в окне "Агенты". Сведения о формате подключаемого модуля VS Code см. [в справочнике по разработке подключаемых модулей агента](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference).
* GitHub Copilot CLI. Просматривайте и устанавливайте подключаемые модули из зарегистрированной платформы.
* GitHub Copilot app. Просматривайте и устанавливайте подключаемые модули из **настройки**.
* Copilot in the cloud. Настройте подключаемые модули с помощью параметров репозитория.

Подключаемый модуль может содержать компоненты, которые работают только в определенной поверхности. Убедитесь, что подключаемый модуль поддерживает используемую поверхность. Например, для конфигурации сервера LSP, описанной в этой категории Copilot CLI. Дополнительные сведения см. в разделе [Справочник по подключаемым модулям и Marketplace](/ru/copilot/reference/plugin-and-marketplace-reference).

## Что содержат плагины

Подключаемый модуль может упаковыть некоторые или все эти компоненты. Доступные компоненты и их расположения зависят от формата и поверхности подключаемого модуля:

* **Пользовательские агенты** — специализированные AI-ассистенты (`*.agent.md` файлы в архиве `agents/`)
* **Навыки** — инструкции, скрипты и ресурсы для конкретных задач (подкаталоги навыка в `skills/`, содержащий `SKILL.md` файл)
* **Перехватчики — обработчики** событий, реагирующие на действия агента ( `hooks.json` файл в корневом каталоге подключаемого модуля или в `hooks/`)
* **Расширения** — код, зависящий от Surface, который добавляет такие возможности, как инструменты и команды косой черты
* **Конфигурации сервера MCP** — интеграция протокола контекста модели (корневой каталог `mcp.json` в подключаемых модулях агента 1.0)
* **Конфигурации сервера LSP** — интеграция протокола языкового сервера на поддерживаемых поверхностях

## Форматы подключаемых модулей

Подключаемые модули агента — это формат для совместного использования манифестов подключаемых модулей, навыков и конфигураций сервера MCP в совместимых поверхностях. Подключаемые модули агента 1.0 объявляют каноническую схему `plugin.json`в; ее расположения схемы и компонентов не поддерживаются каждой поверхностью таким же образом.
Copilot CLI также поддерживает устаревший формат подключаемого Copilot модуля. В интерфейсе командной строки манифест без схемы подключаемых модулей агента использует этот устаревший формат.

Выберите подключаемые модули агента, если требуется предоставить общий доступ к навыкам и серверам MCP в совместимых поверхностях. Используйте устаревший формат ИНТЕРФЕЙСА командной строки, если вам нужны настраиваемые пути компонентов или поддерживает существующий подключаемый модуль Copilot.

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

## Как устроены плагины

Подключаемый модуль — это каталог с определенной структурой и файлом манифеста `plugin.json` . Для подключаемых модулей агента 1.0 требуется манифест в корневом каталоге подключаемого модуля. Устаревшие подключаемые модули поддерживают дополнительные расположения манифестов. Манифест предоставляет подключаемый модуль имя и метаданные. В зависимости от формата он также может указывать на компоненты. Наряду с манифестом каталог может содержать агенты, навыки, перехватчики, конфигурации сервера MCP и конфигурации сервера LSP.

### Структура подключаемых модулей агента 1.0

Подключаемые модули агента 1.0 хранят навыки и серверы MCP в стандартных расположениях, чтобы совместимые клиенты могли их обнаружить. Другие компоненты, включая агенты, перехватчики, команды и серверы LSP, зависят от клиента.
Copilot считывает эти компоненты из `com.github.copilot` каталога. Другие клиенты игнорируют этот каталог, поэтому один и тот же подключаемый модуль может объединять общие навыки и серверы MCP с Copilotкомпонентами с определенными компонентами.

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

```text
my-plugin/
├── plugin.json               # Required manifest
├── skills/                   # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── mcp.json                  # MCP server config (optional)
└── com.github.copilot/       # Copilot components (optional)
    ├── agents/
    │   └── helper.agent.md
    ├── commands/
    ├── rules/
    ├── hooks/
    │   └── hooks.json
    └── lsp.json
```

Манифест должен включать подключаемые модули агента 1.0 `$schema`. Поддерживаемые поля манифеста верхнего уровня, требования к имени и расположения компонентов см. в [полях манифеста подключаемого модуля агента 1.0](/ru/copilot/reference/copilot-cli-reference/cli-plugin-reference#agent-plugins-10-manifest-fields).

### Устаревшая структура подключаемого модуля

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

```text
my-plugin/
├── plugin.json           # Required manifest
├── agents/               # Custom agents (optional)
│   └── helper.agent.md
├── skills/               # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── hooks.json            # Hook configuration (optional)
├── .mcp.json             # MCP server config (optional)
└── lsp.json              # LSP server config (optional)
```

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

## Зачем использовать плагины?

Плагины предоставляют следующие преимущества:

* Повторное использование между проектами
* Общая Copilot конфигурация в репозиториях
* Делитесь экспертизой в области (например, предоставляя навыки эксперта по Rails или Kubernetes)
* Инкапсулировать сложные настройки сервера MCP

## Откуда приходят подключаемые модули

Встроенный marketplace в Visual Studio Code, Copilot CLIи GitHub Copilot app это [удивительный copilot](https://github.com/github/awesome-copilot?utm_source=customization-plugin-doc-awesome\&utm_medium=docs\&utm_campaign=universe-2026). Другие платформы необходимо добавить до того, как их подключаемые модули будут доступны.

Добавление Marketplace делает его подключаемые модули доступными для просмотра. Он не устанавливает или не включает их. Идентификатор подключаемого модуля объединяет имя подключаемого модуля с именем Marketplace как `PLUGIN-NAME@MARKETPLACE-NAME`. Имя Marketplace поступает из поля в файле`marketplace.json`, а не из `name` имени репозитория.

## Что определяет, включен ли подключаемый модуль

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

| Источник конфигурации                     | Effect                                                                                                                                | Может ли член отключить подключаемый модуль?                |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| Управляемые корпоративными настройками    | Требовать или блокировать подключаемый модуль в поддерживаемых поверхностях.                                                          | No. Управляемая политика всегда выигрывает.                 |
| Управляемые параметры команды предприятия | Добавьте необходимые подключаемые модули в корпоративные `enabledPlugins` файлы группы, наложенные на базовые показатели предприятия. | No. Эти записи являются управляемыми политиками.            |
| Стандарты репозитория                     | Включите подключаемый модуль для всех, кто работает в репозитории.                                                                    | Да, где поверхность поддерживает локальную переопределение. |

По умолчанию репозиторий не делает подключаемый модуль обязательным. Они не могут включить подключаемый модуль, который блокирует управляемые политики или использовать Marketplace, который запрещает политику. Управляемые параметры по умолчанию не могут включить необязательный подключаемый модуль. Им требуются только подключаемые модули или блокируются.

Корпоративные файлы группы добавляют управляемые `enabledPlugins` записи в базовые показатели предприятия. Участники не могут отключить необходимые подключаемые модули. См [. раздел AUTOTITLE](/ru/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/override-settings-for-teams).

Используется `.github/copilot/settings.json`репозиторий по умолчанию. Сведения о конфигурации и локальных переопределениях для конкретных поверхностей см. в разделе [Каталог конфигурации CLI GitHub Copilot](/ru/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson).

Администраторы предприятия могут указывать дополнительные платформы и подключаемые модули, необходимые или заблокированные. См [. раздел AUTOTITLE](/ru/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/manage-plugin-marketplaces-and-plugins).

## Как работают маркетплейсы плагинов

Маркетплейс плагинов — это реестр плагинов, с которых можно просматривать и устанавливать. Marketplace можно разместить в репозитории GitHub.com, другом узле Git или локальном каталоге. Так как подключаемые модули в Marketplace версии, marketplace упрощает обнаружение, установку и обновление подключаемых модулей.

Marketplace определяется файлом `marketplace.json` , который предоставляет метаданные о Marketplace и перечисляет его подключаемые модули.

Инструкции по использованию подключаемых модулей или публикации Marketplace в репозитории см. в GitHub статье ["Дополнительные сведения](#further-reading)".

## Плагины по сравнению с ручной конфигурацией

Любые функции, которые можно добавить с помощью плагина, можно также настраивать Copilot вручную — например, добавляя пользовательские профили агентов или MCP-серверы. Однако плагины дают несколько преимуществ по сравнению с ручной конфигурацией:

| Feature    | Ручная настройка в репозитории | Плагин                                        |
| ---------- | ------------------------------ | --------------------------------------------- |
| Scope      | Одиночный репозиторий          | Любой проект                                  |
| Sharing    | Копирование вручную            | Команда установки или `enabledPlugins` запись |
| Versioning | История гита                   | Версии на рынке                               |
| Открытие   | Поиск репозиториев             | Просмотр на рынке                             |

## Дополнительные материалы

* [Использование подключаемых модулей в 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#adding-plugins)
* [Настройка параметров для GitHub Copilot в облаке](/ru/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings#configuring-plugins-for-github-copilot-cloud-agent)
* [Создание и совместное использование подключаемого модуля Marketplace на GitHub](/ru/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces)