Os plug-ins empacotam personalizações para superfícies compatíveis Copilot. Formatos de plug-in, componentes e locais com suporte variam de acordo com a plataforma. Use a documentação da plataforma em que você planeja instalar o plug-in.
Arquivos de manifesto do plug-in
Um plug-in é descrito por um plugin.json manifest. Agent Plugins define um formato de plug-in portátil para superfícies compatíveis. O manifest está na raiz do diretório do plug-in e declara o esquema Agent Plugins. Para plug-ins de agente 1.0, use https://agent-plugins.org/schemas/1.0.0/plugin.schema.json.
Copilot CLI também reconhece o esquema 1.1.0.
O formato compartilhado de plug-ins do agente define locais padrão para alguns componentes. O suporte para esses componentes pode ser diferente por superfície:
| Component | Localização dos plug-ins do agente | Notes |
|---|---|---|
| Habilidades | skills/ | Dispositivos Surface compatíveis podem detectar recursos neste local. |
| Servidores MCP | ||
mcp.json na raiz do plug-in | Superfícies compatíveis podem descobrir a configuração do servidor MCP neste local. | |
| componentes específicos para Surface | Um diretório com namespace, como com.github.copilot/ | A disponibilidade e os componentes com suporte dependem da plataforma. |
Um diretório do Agent Plug-ins 1.0 pode usar esta estrutura:
my-plugin/
├── plugin.json
├── skills/
│ └── deploy/
│ └── SKILL.md
├── mcp.json
└── com.github.copilot/
├── agents/
│ └── helper.agent.md
├── commands/
├── rules/
├── hooks/
│ └── hooks.json
└── lsp.json
O plugin.json manifest declara o esquema de plug-ins do agente. Os locais skills/ e os locais raiz mcp.json são definidos pelos Plug-ins do Agente. O com.github.copilot/ diretório contém componentes específicos Copilot, não componentes de plug-ins de agente portáteis. Os componentes que uma superfície carrega deste diretório dependem dessa superfície. Para o Copilot CLI, consulte referência de plugin da CLI GitHub Copilot.
Copilot CLI também dá suporte a um formato de plug-in herdado Copilot . Ele usa diferentes comportamentos de descoberta de componentes e caminhos de componente configuráveis. Para campos de manifesto, validação, locais de arquivo e comportamento específico da CLI, consulte referência de plugin da CLI GitHub Copilot.
Visual Studio Code documenta o formato de criação do plug-in e os comportamentos compatíveis na Agent Plugins authoring reference. Não suponha que um componente ou comportamento do manifesto com suporte em uma superfície tenha suporte em outra.
Catálogo do Marketplace
Um marketplace.json catálogo fornece metadados sobre um marketplace e lista plug-ins em seu array plugins de nível superior. Cada entrada de plug-in pode incluir seu nome, descrição, versão e origem. A fonte identifica onde os arquivos de plug-in estão localizados. Para Copilot CLI, marketplace.json é o único componente do marketplace necessário. Outras superfícies podem ter requisitos adicionais.
O nome do marketplace vem do campo name, não do nome do repositório. Um identificador de plug-in combina o nome do plug-in com o nome do marketplace:
PLUGIN-NAME@MARKETPLACE-NAME
Mantenha os nomes do marketplace e do plug-in estáveis quando as configurações se referem a eles. Alterar um nome do marketplace altera os identificadores de plug-in usados por essas configurações.
Os campos de catálogo e os locais de arquivo com suporte podem variar de acordo com a plataforma. Para obter os campos e locais completos do catálogo do marketplace de Copilot CLI, consulte referência de plugin da CLI GitHub Copilot. Para obter etapas para publicar um catálogo em um GitHub repositório, consulte Criando e compartilhando um marketplace de plug-in no GitHub.
Usar plugins
Adicionar um marketplace disponibiliza seus plug-ins para serem explorados. Ao instalar um plug-in, ele é adicionado a uma superfície. Habilitar um plug-in disponibiliza seus componentes em sessões nessa área. Para obter instruções específicas da superfície, consulte: