Agent Plugins 소개
요약
AI 에이전트 확장을 위한 개방형 및 벤더 중립적 플러그인 표준인 Agent Plugins 1.0.0이 공개되었습니다. 이 표준은 Agent Skills와 MCP 서버를 포함한 재사용 가능한 구성 요소를 클라이언트 간에 일관된 방식으로 연결하고 탐색할 수 있도록 돕습니다.
핵심 포인트
- AI 에이전트 확장을 위한 벤더 중립적 플러그인 표준 제공
- Agent Skills 및 MCP 서버를 통합하는 공통 매니페스트 형식 지원
- 클라이언트 간 구성 요소 재사용성 증대 및 개발 복잡도 감소
- 최소한의 JSON 매니페스트를 통한 가볍고 구현하기 쉬운 설계
오늘, Agent Plugins 1.0.0이 공개되었습니다. 이는 AI 에이전트 (AI agents)를 확장하기 위한 개방형이자 벤더 중립적인 (vendor-neutral) 플러그인 표준입니다. Agent Plugins
AI 에이전트에게 재사용 가능한 지침과 리소스를 제공합니다. 에이전트를 도구 및 서비스에 연결합니다. 두 가지 모두 클라이언트 (clients) 간에 재사용될 수 있지만, 클라이언트는 종종 이를 다르게 패키징하고 탐색합니다. Agent Skills MCP servers
Agent Plugins는 호환 가능한 클라이언트에게 공통된 형식, 즉 매니페스트 (manifest)가 포함된 디렉토리와 구성 요소들을 위한 고정된 위치를 제공합니다. 이 형식은 의도적으로 작고 구현하기 쉽게 설계되었으며, 설치, 배포, 정책, 사용자 경험 및 클라이언트별 기능은 각 클라이언트의 몫으로 남겨둡니다. plugin.json
확장 기능 제작자들은 종종 동일한 구성 요소를 여러 클라이언트 형식에 맞춰 조정하곤 합니다. 기반이 되는 Skill 또는 MCP 서버가 동일하더라도, 클라이언트는 종종 서로 다른 최상위 메타데이터, 탐색 경로 또는 MCP 설정을 요구합니다.
Agent Plugins는 이러한 공유 구성 요소들에게 예측 가능하고 구조화된 하나의 집을 제공합니다:
최소한의 JSON 매니페스트 (plugin.json)가 사양 버전을 식별하고 플러그인의 이름을 지정합니다.
이 두 필드는 매니페스트의 최소 요구 사항이며, 계약의 나머지 부분은 디렉토리 자체의 파일 구조로 표현됩니다. 재사용 가능한 구성 요소는 매번 클라이언트마다 다시 패키징될 필요가 없어야 하므로, 이 형식은 클라이언트가 내부 내용을 탐색하고 로드하는 데 필요한 사항만을 명시합니다.
모든 호환 가능한 클라이언트는 플러그인 루트에서 plugin.json을 확인합니다. Skills를 지원하는 클라이언트는 skills/ 아래에서 이를 탐색합니다. MCP 서버를 지원하는 클라이언트는 mcp.json에서 설정을 읽습니다. 클라이언트는 한 가지 구성 요소 유형을 지원하거나 두 가지 모두를 지원할 수 있습니다. 클라이언트가 매니페스트를 검증한 후에는 구성 요소들이 독립적으로 검증되므로, 하나의 잘못된 구성 요소가 관련 없는 다른 구성 요소들을 비활성화하지는 않습니다.
플러그인 개발자들에게 이는 동일한 구성 요소에 대해 클라이언트별로 서로 다른 관례를 따를 필요가 줄어든다는 것을 의미합니다. 클라이언트 구현자들에게는 이 사양(specification)이 발견(discovery), 검증(validation), 로딩(loading)을 위한 작고 결정론적인(deterministic) 계약(contract)을 정의해 줍니다.
Agent Plugins는 플러그인을 위한 이식 가능한 계약(portable contract)을 정의하며, 클라이언트의 동작 방식은 각 클라이언트의 자율에 맡깁니다.
버전 1은 이 계약을 두 가지 구성 요소 유형인 Agent Skills와 MCP 서버에 집중합니다. 이 두 가지는 이미 자체적인 사양과 유의미한 채택 사례를 가지고 있으며, Agent Plugins는 이를 재정의하려 시도하지 않습니다. Agent Plugins는 클라이언트가 배포 가능한 플러그인 내에서 어떻게 구성 요소들을 함께 찾을 수 있는지에 대한 공유된 정의를 제공합니다.
명령(commands), 훅(hooks), 에이전트(agents)와 같은 다른 구성 요소들은 클라이언트에 그대로 남습니다. 기술 운영 위원회(Technical Steering Committee)는 향후 의미론(semantics)이 수렴하고 이식성에 대한 필요성이 입증됨에 따라 추가적인 구성 요소 유형을 고려할 수 있습니다.
경계를 작게 유지함으로써 포맷을 구현하기 더 쉽게 만들고, 더 많은 이식 가능한 표면적(surface area)을 추가하기 전에 생태계가 수렴할 수 있는 여유를 제공합니다.
공유 포맷이 진화하는 동안 클라이언트에게는 혁신할 수 있는 자유가 필요하므로, Agent Plugins는 클라이언트별 데이터와 파일을 위한 네임스페이스 기반 확장(namespaced extension) 메커니즘을 포함합니다.
확장 기능은 이식 가능한 계약(portable contract) 외부에 머뭅니다. 각 클라이언트는 자신만의 네임스페이스를 정의하며, 다른 클라이언트들은 이를 무시합니다. 이는 클라이언트별 동작이 공통 포맷으로 유출되거나 공유 구성 요소의 채택을 방해하는 것을 방지합니다. 클라이언트별 기능은 이를 표준화할 이유와 합의가 생길 때까지 클라이언트 전용으로 유지될 수 있습니다.
Vercel이 제안을 시작했으며, Amazon Web Services (AWS), Anysphere, GitHub, Microsoft, OpenAI, 그리고 Vercel의 대표들이 협력하여 이를 Agent Plugins 1.0.0으로 정교화했습니다.
초기 기술 운영 위원회(Technical Steering Committee)에는 AWS, Cursor, Microsoft, OpenAI, 그리고 Vercel의 핵심 유지 관리자(Core Maintainers)들이 포함되어 있습니다.
이 프로젝트는 오픈 라이선스(Openly licensed)로 운영되며, 유지 관리자(Maintainers), 기여 프로세스(Contribution process), 그리고 기술적 결정 사항들이 모두 공개되어 있습니다. 특정 기업의 제품 로드맵(Product roadmap)이 이 포맷의 방향성을 결정하지 않습니다.
사양(Specification), JSON 스키마(JSON Schemas), 그리고 플러그인 제작자 및 클라이언트 구현자를 위한 가이드는 agent-plugins.org에서 확인할 수 있습니다. 거버넌스(Governance)와 기여 프로세스는 GitHub의 Agent Plugins specification repository에서 이루어집니다.
만약 에이전트 확장 기능(Agent extensions)을 제작하는 개발자라면, 이 사양을 사용하여 스킬(Skills)과 MCP 서버를 하나의 휴대 가능한 매니페스트(Portable manifest)로 패키징할 수 있습니다. 에이전트 클라이언트(Agent client)를 구축하는 경우라면, 사양의 준수 체크리스트(Conformance checklist)가 에이전트 플러그인(Agent Plugins)을 발견하고 로드하기 위한 최소 요구 사항을 정의합니다.
출시 시점에 Agent Plugins는 다음 환경에서 지원됩니다:
- ChatGPT와 Codex
- Cursor
- GitHub Copilot
- Kiro
- VS Code
플러그인 제작자는 컴포넌트를 한 번만 패키징하면 되며, 제작된 플러그인은 지원되는 클라이언트 간에 자동으로 전달됩니다.
Agent Plugins는 에이전트용 확장 기능을 구축하는 제작자와 이를 로드하는 클라이언트 사이의 계약(Contract)입니다. 이제 그 계약은 정의되었으며, 양측 모두가 함께 만들어갈 수 있도록 공개되었습니다.
휴대 가능한 구성 요소를 위한 하나의 패키지
의도된 경량화
클라이언트의 유연성 유지
개방형 멀티 벤더(Multi-vendor) 프로젝트
Agent Plugins 1.0.0으로 구축하기
AI 자동 생성 콘텐츠
본 콘텐츠는 Vercel AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기