플러그 인은 호환되는 Copilot 표면용 사용자 지정을 패키지화합니다. 플러그인 형식, 구성 요소 및 지원되는 위치는 화면에 따라 다릅니다. 플러그인을 설치하려는 환경에 대한 설명서를 사용합니다.
플러그인 매니페스트
플러그인은 plugin.json 매니페스트에 의해 설명됩니다. Agent Plugins는 호환되는 환경을 위한 이식 가능한 플러그 인 형식을 정의합니다. 매니페스트는 플러그 인 디렉터리의 루트에 있으며 에이전트 플러그 인 스키마를 선언합니다. 에이전트 플러그인 1.0의 경우 https://agent-plugins.org/schemas/1.0.0/plugin.schema.json을 사용하세요.
Copilot CLI 는 1.1.0 스키마도 인식합니다.
공유 에이전트 플러그 인 형식은 일부 구성 요소의 표준 위치를 정의합니다. 이러한 구성 요소에 대한 지원은 서피스마다 다를 수 있습니다.
| Component | 에이전트 플러그인 위치 | Notes |
|---|---|---|
| 기술 | skills/ | 호환되는 인터페이스는 이 위치에서 기능을 찾을 수 있습니다. |
| MCP 서버 | ||
mcp.json 플러그인 루트에 | 호환되는 환경은 이 위치에서 MCP 서버 구성을 검색할 수 있습니다. | |
| 표면별 구성 요소 | ||
com.github.copilot/와 같은 네임스페이스 디렉터리 | 가용성 및 지원되는 구성 요소는 플랫폼에 따라 달라집니다. |
에이전트 플러그 인 1.0 디렉터리에서는 다음 구조를 사용할 수 있습니다.
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 에이전트 플러그 인 스키마를 선언합니다.
mcp.json 위치 및 루트 skills/ 위치는 에이전트 플러그인에 의해 정의됩니다. 디렉터리에는 com.github.copilot/ 이식 가능한 에이전트 플러그 인 구성 요소가 아닌 Copilot 관련 구성 요소가 포함되어 있습니다. 표면이 이 디렉터리에서 로드하는 구성 요소는 표면에 따라 다릅니다. 자세한 내용은 Copilot CLIGitHub Copilot CLI 플러그 인 참조을 참조하세요.
Copilot CLI 는 레거시 Copilot 플러그 인 형식도 지원합니다. 서로 다른 구성 요소 검색 동작과 구성 가능한 구성 요소 경로를 가집니다. 매니페스트 필드, 유효성 검사, 파일 위치 및 CLI 관련 동작은 GitHub Copilot CLI 플러그 인 참조을 참조하세요.
에이전트 플러그인 작성 참조에서 Visual Studio Code의 플러그인 작성 형식 및 지원되는 동작을 문서화합니다. 한 화면에서 지원되는 구성 요소 또는 매니페스트 동작이 다른 화면에서 지원된다고 가정하지 마세요.
Marketplace 카탈로그
카탈로그는 marketplace.json 마켓플레이스에 대한 메타데이터를 제공하고 최상위 plugins 배열의 플러그 인을 나열합니다. 각 플러그인 항목에는 이름, 설명, 버전 및 출처가 포함될 수 있습니다. 소스는 플러그 인 파일이 있는 위치를 식별합니다.
marketplace.json의 경우 Copilot CLI 구성 요소만이 유일한 필수 마켓플레이스 구성 요소입니다. 다른 표면에는 추가 요구 사항이 있을 수 있습니다.
마켓플레이스 이름은 리포지토리 이름이 아니라 name 필드에서 가져옵니다. 플러그인 식별자는 플러그인 이름과 마켓플레이스 이름을 결합한 것입니다.
PLUGIN-NAME@MARKETPLACE-NAME
설정에서 이를 참조할 때 마켓플레이스 및 플러그인 이름을 안정적으로 유지합니다. 마켓플레이스 이름을 변경하면 해당 설정에서 사용하는 플러그 인 식별자가 변경됩니다.
카탈로그 필드 및 지원되는 파일 위치는 플랫폼에 따라 달라질 수 있습니다. Copilot CLI의 전체 마켓플레이스 카탈로그 필드 및 위치는 GitHub Copilot CLI 플러그 인 참조을 참조하세요. 리포지토리에 카탈로그를 GitHub 게시하는 단계는 GitHub 플러그 인 마켓플레이스 만들기 및 공유을 참조하세요.
플러그인 사용
마켓플레이스를 추가하면 플러그 인을 찾아볼 수 있습니다. 플러그인을 설치하면 작업 영역에 추가됩니다. 플러그 인을 사용하도록 설정하면 해당 표면의 세션에서 해당 구성 요소를 사용할 수 있습니다. 표면별 지침은 다음을 참조하세요.