Один плагин для разных ИИ-агентов: стандарт Agent Plugins 1.0 готов
В журнале изменений GitHub от 12 августа поддержка Agent Plugins 1.0 названа общедоступной в VS Code, Copilot CLI, GitHub Copilot SDK и приложении Copilot на всех тарифах. Сам открытый стандарт был опубликован 6 августа: он объединяет навыки агента и конфигурации серверов протокола контекста модели (MCP) в один устанавливаемый пакет.
Для разработчика это означает, что одинаковое ядро плагина можно передавать между совместимыми клиентами без отдельной структуры для каждой программы. Однако открытая спецификация переносимого пакета оставляет распространение, установку, разрешения, пользовательский интерфейс и клиентские возможности под контролем конкретной программы.
Общая доступность не означает поддержку любого клиента
Объявление относится к четырём продуктам экосистемы Copilot, перечисленным в сообщении о выпуске. Формат при этом не привязан к одному поставщику: другие программы могут реализовать его независимо, но совместимость определяется тем, какие стандартные компоненты способен загрузить конкретный клиент.
Поэтому одного заявления о «поддержке плагинов» недостаточно. Клиент может распознавать навыки, но не выбранный способ запуска сервера протокола; либо загружать переносимое ядро, но игнорировать расширение, предназначенное для другой программы. Стандарт задаёт общую упаковку и правила обнаружения, а не тождественное поведение всех агентов.
Минимальный пакет состоит из трёх частей
Структура намеренно сделана небольшой. В корне обязателен только манифест, а каталог навыков и конфигурация серверов добавляются по необходимости:
- plugin.json — корневой манифест. Он указывает версию схемы и имя плагина; описание, версия самого пакета, автор, лицензия и адрес репозитория относятся к дополнительным метаданным.
- skills/ — каталог навыков. Каждый навык размещается в отдельной папке с файлом SKILL.md; рядом могут находиться сценарии, справочные материалы и другие используемые им ресурсы.
- mcp.json — корневая конфигурация серверов протокола. В ней описываются доступные серверы и способы соединения с ними.
Минимально допустимый пакет может содержать один манифест. Практическая ценность появляется после добавления навыка или сервера: именно эти два вида компонентов версия 1.0 определяет как переносимые.
Расположение компонентов фиксировано. Пути к каталогу навыков и конфигурации серверов не задаются произвольно через манифест, поэтому совместимый клиент знает, где их искать. Если необязательная часть отсутствует, это само по себе не делает пакет недействительным.
Граница переносимости проходит между содержимым и клиентом
Единый пакет не унифицирует всю систему плагинов. Границу возможностей можно представить как три группы:
- Переносимое ядро: идентификатор и метаданные пакета, навыки с вложенными ресурсами, а также конфигурации серверов в установленном формате.
- Возможности с разной реализацией: поддерживаемые способы соединения с сервером, запуск локальных процессов, показ навыков и инструментов, авторизация и хранение учётных данных.
- Клиентская область: магазины и каталоги, установка и обновление, запросы разрешений, корпоративные политики, элементы интерфейса, пользовательские агенты, команды, правила и обработчики событий.
Для функций третьей группы предусмотрены пространства имён, построенные из домена в обратном порядке. В них программа может хранить собственные данные и файлы, не меняя переносимое ядро. Клиент без поддержки соответствующего пространства должен пропустить его, а не считать весь пакет несовместимым.
Так один репозиторий сохраняет дополнительные возможности для конкретной экосистемы, но эти возможности не становятся частью общего стандарта. Заявлять совместимость корректнее отдельно для навыков, серверов и каждого клиентского расширения.
Как переносится уже существующий плагин
Переупаковка начинается с корневого манифеста: в него добавляют ссылку на каноническую схему версии 1.0 и имя пакета. Навыки переносят в установленный каталог, а конфигурацию серверов — в корневой файл без начальной точки в названии.
Команды, пользовательских агентов, правила и обработчики событий нельзя объявить стандартными компонентами первой версии. Их оставляют в прежнем клиентском формате или помещают в пространство имён нужной программы. В результате переносимая часть продолжит работать в других совместимых клиентах, а дополнительные функции загрузятся только там, где для них существует реализация.
Миграция не обязательна для уже работающих плагинов экосистемы Copilot: прежние форматы продолжают поддерживаться. Переход нужен разработчикам, которым важны единая структура репозитория и возможность передавать общие навыки и серверы между несколькими программами.
После переупаковки всё равно требуется проверка в каждом целевом клиенте. Спецификация ограничивает относительные пути корнем пакета, но не создаёт общей песочницы, не выравнивает ограничения операционных систем и не задаёт единый порядок выдачи разрешений.
Доверие к месту установки остаётся локальным
Одинаковая структура файлов не делает все способы распространения равноценными по риску. Плагин способен включать исполняемые сценарии и серверы, поэтому программа сама решает, когда запросить согласие пользователя и какие корпоративные ограничения применить.
Документация редактора о доверии указывает, что при первой установке из нового каталога появляется отдельный запрос. Входящие в установленный пакет серверы затем считаются доверенными вместе с ним и не показывают ещё один запрос при каждом запуске; администратор может отдельно ограничить доступные каталоги и плагины.
На 14 августа переносимой частью стандарта остаются навыки и конфигурации серверов. Общая доступность в основных клиентах Copilot снимает прежнюю необходимость дублировать их упаковку, но магазины, разрешения, интерфейс и расширенные возможности по-прежнему определяют программы. Дальнейшая совместимость будет зависеть от того, какие клиенты реализуют формат и какие типы компонентов они фактически поддержат.
Читайте также:
Подпишитесь на рассылку
Получайте свежие новости Web3, AI и криптовалют прямо на вашу почту.