Разработчики агентов на базе искусственного интеллекта столкнулись с типичной проблемой: полезные функции и интеграции с внешними сервисами, созданные для одной платформы, приходится переделывать для другой. Amazon, Cursor, Microsoft, OpenAI и Vercel объединились и разработали общую спецификацию. Теперь разработчики смогут собрать навыки агента и подключения к инструментам в единую папку и использовать её во всех совместимых приложениях.
Проект Agent Plugins был инициирован Vercel совместно с инженерами из Amazon, Cursor, Microsoft и OpenAI. Agentic AI Foundation, входящая в Linux Foundation, оказала поддержку, но сам проект получил независимую систему управления. Текущая версия 1.0.0 имеет статус Working Draft — рабочей редакции, которая ещё может изменяться. Хотя основная структура и правила совместимости уже определены, этот вариант нельзя считать окончательно утверждённым стандартом.
Назначение проекта очевидно даже без углубления в программирование. ИИ-агент значительно превосходит обычный чат-бот: он выполняет цепочки операций, активирует инструменты, обращается к сервисам и работает с файлами и информацией. Для каждой задачи требуются инструкции и доступ к необходимым ресурсам. Agent Plugins объединяет оба компонента в один переносимый пакет.
За описание функций отвечает формат Agent Skills. Навык содержит информацию о работе, которую должен выполнить агент, и указывает, когда эту возможность необходимо использовать. Основу составляет файл SKILL.md. Разработчик указывает название, описание и инструкции, а затем добавляет сценарии, справочные материалы, шаблоны и другие файлы. К примеру, отдельный навык может научить агента проверять код, анализировать документы PDF или выполнять конкретную последовательность шагов при запуске приложения.
Связь с внешними системами обеспечивает Model Context Protocol (MCP) — протокол контекста модели. Этот стандарт описывает, как ИИ-приложение подключается к инструментам и данным вне самой модели. Через MCP агент может получить доступ к веб-сервису, базе данных, локальной программе или другому ресурсу. При этом навык содержит указания по выполнению задачи, а MCP предоставляет агенту необходимые средства.
Agent Plugins объединяет навыки и конфигурацию MCP в чёткую файловую структуру. Каждый плагин размещается в отдельной папке. В корневой директории находится файл plugin.json, который описывает пакет и указывает версию спецификации. Папка skills/ содержит навыки, а файл mcp.json перечисляет MCP-серверы, доступные агенту. Клиенту не нужно искать каждый элемент в непредсказуемом месте или разбираться в структуре, придуманной автором расширения.
Файл манифеста plugin.json содержит ключевую информацию о плагине. Обязательны ссылка на схему спецификации и имя пакета. Разработчик может дополнительно указать версию, краткое описание, автора, веб-сайт, репозиторий, тип лицензии и теги. Agent Plugins использует фиксированную схему, поэтому клиент заранее знает допустимые поля и может проверить пакет перед установкой.
Навыки организованы в папке skills/ в отдельных подпапках. В каждой подпапке должен находиться файл SKILL.md. Agent Plugins не переопределяет структуру навыков, а использует существующую спецификацию Agent Skills. Этот подход защищает разработчиков от еще одного похожего формата и позволяет обновлять правила навыков независимо от общей упаковки плагинов.
Файл mcp.json выполняет другую функцию. Разработчик в нём указывает MCP-серверы и параметры подключения. Первая версия Agent Plugins поддерживает три варианта связи: локальное выполнение через стандартные потоки stdio, Streamable HTTP и устаревающий HTTP с Server-Sent Events. Клиенту не требуется поддерживать все варианты — достаточно хотя бы stdio или Streamable HTTP.
Поэтому переносимость не означает гарантию идентичной работы на любой платформе. Agent Plugins стандартизирует пакетирование переносимых компонентов, но не пользовательский интерфейс, установку, права доступа, хранение ключей или политики безопасности. Каждая платформа сама решает, как пользователь подключает плагин, какие действия разрешены агенту и как подтверждается доступ к внешним ресурсам. Общий формат избавляет разработчика от переделки структуры пакета, но различия между самими приложениями остаются.
Поддержку Agent Plugins обеспечивают VS Code, Cursor, GitHub Copilot, ChatGPT, Codex и Kiro. Все указанные приложения работают с Agent Skills. Поддержка MCP варьируется: VS Code, Cursor, GitHub Copilot и Kiro принимают stdio, Streamable HTTP и старый SSE-вариант, в то время как ChatGPT и Codex поддерживают stdio и Streamable HTTP. Плагин с неподдерживаемым типом подключения не сможет полностью передать свои функции в любое приложение, даже если структура пакета соответствует спецификации.
Авторы Agent Plugins намеренно ограничили первую версию двумя переносимыми компонентами: навыками Agent Skills и MCP-серверами. Разработчики современных агентов уже используют собственные команды, обработчики событий, специальные правила и другие расширения, но попытка стандартизировать всё сразу значительно усложнила бы формат. Экспериментальные функции на данном этапе можно хранить отдельно, не включая их в основное ядро.
Для платформо-специфичных расширений предусмотрены пространства имён. Приложение может создать свой раздел с названием, построенным из обратного домена, например com.example.client, и хранить там собственные настройки или файлы. Другое приложение, не знакомое с таким расширением, должно его пропустить и продолжить загрузку известных компонентов. Плагин при этом сохраняет общую часть, хотя функции, привязанные к особенностям конкретной программы, не обязаны работать на других платформах.
Новые типы компонентов могут быть добавлены в будущие версии, если разработчики продемонстрируют, что одна и та же функция действительно требуется нескольким клиентам и имеет общую ценность. Авторы стандарта не планируют включать каждую экспериментальную функцию из отдельных ИИ-продуктов. Первая версия специально определяет минимальный общий набор, который разные платформы могут поддерживать без полной переделки собственной инфраструктуры.
Развитием Agent Plugins руководит технический комитет с участием специалистов из Amazon, Cursor, Microsoft, OpenAI и Vercel. Предложения и решения обсуждаются открыто, а документация распространяется под лицензией Creative Commons Attribution 4.0. Независимая система управления необходима для общего формата: правила совместимости не должны зависеть исключительно от одной компании, если спецификацию одновременно используют конкурирующие платформы.
Agent Plugins решает проблему организации навыков и инструментов, но индустрия одновременно работает над несколькими другими аспектами ИИ-агентов. Google передала протокол Agent2Agent (A2A) под управление Linux Foundation. A2A отвечает за коммуникацию между агентами. Разработчики смогут создавать системы, которые обмениваются информацией и синхронизируют работу, независимо от того, на каких платформах и технологиях построены агенты.
Другой проект от Google — Agentic Resource Discovery (ARD). Эта спецификация предназначена для поиска инструментов, навыков и агентов в сети. Программе сначала нужно определить местоположение требуемой функции, понять её возможности и проверить подлинность. ARD предлагает единый формат публикации и обнаружения таких ресурсов независимо от конкретного провайдера или протокола.
Agentic AI Foundation разрабатывает также Skills Over MCP. Этот проект предусматривает передачу навыков через сам MCP-сервер. Сервер может предоставить агенту инструменты вместе с руководством по их использованию. Навыки остаются файлами формата Agent Skills, а MCP передаёт их как ресурсы. Для больших наборов предусмотрен каталог, благодаря которому агент сначала получает краткий список доступных навыков и загружает полные инструкции только при необходимости.
Agent Plugins предлагает альтернативный способ собрать те же компоненты. Навыки находятся в папке skills/, параметры MCP — в mcp.json, а единая папка объединяет компоненты в переносимый пакет. Если формат получит широкую поддержку, разработчику не придётся переделывать одни и те же инструкции и параметры подключения для каждого ИИ-клиента. Первая версия уже устанавливает чёткую структуру для двух наиболее распространённых типов расширений агентов, а всё остальное остаётся в компетенции отдельных платформ.
