Os plug-ins empacotam personalizações relacionadas para que você possa instalá-las e gerenciá-las juntas em vez de configurar cada uma separadamente. Por exemplo, um plug-in de teste pode combinar uma habilidade para executar testes, um agente para revisão de código e um servidor MCP para um serviço de relatório de teste.
Onde você pode usar plug-ins
Os plug-ins estão disponíveis nestas Copilot superfícies:
- Visual Studio Code. Navegue e instale plug-ins em Customize no painel lateral do Chat ou na janela Agentes. Para obter detalhes do formato de plug-in do VS Code, consulte a referência de criação do Agent Plugins.
- GitHub Copilot CLI. Navegue e instale plug-ins de um marketplace registrado.
- O GitHub Copilot app. Navegue e instale plug-ins a partir de Personalizar.
- Copilot in the cloud. Configure plug-ins por meio de configurações de repositório.
Um plug-in pode conter componentes que funcionam apenas em um contexto específico. Verifique se o plug-in dá suporte ao material que você usa. Por exemplo, a configuração do servidor LSP descrita nesta categoria é para Copilot CLI. Para obter mais informações, consulte Referência de plug-in e marketplace.
O que os plug-ins contêm
Um plug-in pode empacotar alguns ou todos esses componentes. Os componentes disponíveis e seus locais dependem do formato do plug-in e da superfície:
- Agentes personalizados – assistentes de IA especializados (
*.agent.mdarquivos emagents/) - Habilidades – instruções, scripts e recursos específicos da tarefa (subdiretórios de
skills/habilidades, contendo umSKILL.mdarquivo) - Hooks — manipuladores de eventos que respondem a ações do agente (um arquivo
hooks.jsonna raiz do plug-in ou emhooks/) - Extensões — código Surface específico que adiciona recursos como ferramentas e comandos de barra
- Configurações do servidor MCP — integrações do Model Context Protocol (raiz
mcp.jsonno Agent Plugins 1.0) - Configurações do servidor LSP — integrações do Language Server Protocol (LSP) em superfícies com suporte
Formatos de plug-in
Agent Plugins são um formato para compartilhar manifestos de plug-in, habilidades e configurações de servidor MCP em superfícies compatíveis. Os plug-ins do Agent Plug-ins 1.0 declaram o esquema plugin.jsoncanônico; seus locais de esquema e componente não são compatíveis com todas as superfícies da mesma maneira.
Copilot CLI também dá suporte a um formato de plug-in herdado Copilot . Na CLI, um manifest sem o Agent Plugins schema usa esse formato herdado.
Escolha Agent Plugins quando quiser compartilhar habilidades e servidores MCP em interfaces compatíveis. Use o formato da CLI herdada quando precisar de caminhos de componente configuráveis ou se estiver mantendo um plug-in específico do Copilot existente.
Para um novo plug-in, use o Agent Plug-ins 1.0, a menos que você exija caminhos de componente configuráveis. Use o formato herdado principalmente para plug-ins herdados existentes.
Como os plug-ins são estruturados
Um plug-in é um diretório com uma estrutura específica e um arquivo de plugin.json manifesto. O Agent Plugins 1.0 requer o arquivo de manifesto na raiz do plug-in. Plugins legados oferecem suporte a locais adicionais de manifesto. O manifesto fornece ao plug-in um nome e metadados. Dependendo do formato, ele também pode apontar para componentes. Junto com o manifesto, o diretório pode conter agentes, habilidades, ganchos, configurações de servidor MCP e configurações de servidor LSP.
Estrutura dos plug-ins do agente 1.0
O Agent Plugins 1.0 armazena habilidades e servidores MCP em locais padrão para que clientes compatíveis possam descobri-los. Outros componentes, incluindo agentes, ganchos, comandos e servidores LSP, são específicos do cliente.
Copilot lê esses componentes do com.github.copilot diretório. Outros clientes ignoram esse diretório, assim o mesmo plugin pode combinar habilidades compartilhadas e servidores MCP com componentes específicos de Copilot.
Um diretório do Agent Plug-ins 1.0 pode ter esta aparência:
my-plugin/
├── plugin.json # Required manifest
├── skills/ # Skills (optional)
│ └── deploy/
│ └── SKILL.md
├── mcp.json # MCP server config (optional)
└── com.github.copilot/ # Copilot components (optional)
├── agents/
│ └── helper.agent.md
├── commands/
├── rules/
├── hooks/
│ └── hooks.json
└── lsp.json
O manifesto deve incluir o Agent Plugins 1.0 $schema. Para campos compatíveis de nível superior do manifesto, requisitos de nomenclatura e locais dos componentes, consulte campos do manifesto do Agent Plugins 1.0.
Estrutura de plugin legada
Um diretório legado de plugin Copilot pode ser assim:
my-plugin/
├── plugin.json # Required manifest
├── agents/ # Custom agents (optional)
│ └── helper.agent.md
├── skills/ # Skills (optional)
│ └── deploy/
│ └── SKILL.md
├── hooks.json # Hook configuration (optional)
├── .mcp.json # MCP server config (optional)
└── lsp.json # LSP server config (optional)
Para obter o conjunto completo de campos que você pode incluir no manifesto, consulte referência de plugin da CLI GitHub Copilot. Para obter orientações passo a passo sobre como criar um plug-in, consulte Criando um plug-in para GitHub Copilot CLI.
Por que usar plug-ins?
Os plug-ins oferecem os seguintes benefícios:
- Reutilização entre projetos
- Configuração compartilhada Copilot entre repositórios
- Compartilhar conhecimentos de domínio (por exemplo, fornecendo as habilidades de um especialista em Rails ou um especialista em Kubernetes)
- Encapsular configurações complexas do servidor MCP
De onde vêm os plug-ins
O marketplace interno em Visual Studio Code, Copilot CLI e o GitHub Copilot app é awesome-copilot. Outros marketplaces devem ser adicionados antes que seus plug-ins possam ser usados.
Adicionar um marketplace disponibiliza seus plug-ins para serem explorados. Ele não os instala nem habilita. O identificador de um plug-in combina o nome do plug-in com o nome do marketplace como PLUGIN-NAME@MARKETPLACE-NAME. O nome do marketplace vem do name campo em seu marketplace.json arquivo, não do nome do repositório.
O que decide se um plug-in está habilitado
Os plug-ins podem estar disponíveis, instalados ou habilitados. Adicionar um marketplace disponibiliza seus plug-ins para serem explorados. Instalar um plug-in o adiciona a uma superfície e habilitá-lo disponibiliza seus componentes em sessões nessa superfície. A configuração compartilhada pode definir um valor padrão ou impor se um plug-in está habilitado:
| Origem da configuração | Effect | Um membro pode desativar o plug-in? |
|---|---|---|
| Configurações gerenciadas pela empresa | Exigir ou bloquear um plug-in em todas as superfícies compatíveis. | No. Managed policy sempre vence. |
| Configurações gerenciadas pela equipe empresarial | Adicione os plug-ins necessários por meio de enabledPlugins nos arquivos da equipe corporativa, sobre a linha de base empresarial. | No. Essas entradas são gerenciadas por política. |
| Padrões de repositório | Habilite um plug-in para todos que trabalham em um repositório. | Sim, onde a superfície dá suporte a uma sobrescrita local. |
Os padrões do repositório não tornam um plug-in obrigatório. Eles não podem habilitar um plug-in que é bloqueado por uma política gerenciada ou usar um marketplace que a política não permite. As configurações gerenciadas não podem habilitar um plug-in opcional por padrão. Eles só exigem ou bloqueiam plug-ins.
Os arquivos da equipe empresarial adicionam entradas gerenciadas enabledPlugins à linha de base da empresa. Os membros não podem desativar os plug-ins necessários. Consulte Sobrescrevendo as configurações gerenciadas pela empresa para equipes empresariais.
Os padrões de repositório usam .github/copilot/settings.json. Para configuração e substituições locais específicas da interface, consulte Diretório de configuração do GitHub Copilot CLI.
Os administradores corporativos podem especificar marketplaces e plug-ins adicionais que devem ser obrigatórios ou bloqueados. Consulte Gerenciando marketplaces de plug-in e plug-ins com configurações gerenciadas pela empresa.
Como funcionam os marketplaces de plug-in
Um marketplace de plug-ins é um registro de plug-ins dos quais você pode navegar e instalar. Um marketplace pode ser hospedado em um repositório em GitHub.com, outro host Git ou em um diretório local. Como os plug-ins em um marketplace são versionados, os marketplaces facilitam a descoberta, instalação e atualização de plug-ins.
Um marketplace é definido por um marketplace.json arquivo, que fornece metadados sobre o marketplace e lista seus plug-ins.
Para obter instruções específicas da plataforma para usar plug-ins ou publicar um marketplace em um repositório GitHub, consulte Mais leitura.
Plug-ins comparados com a configuração manual
Qualquer funcionalidade que você possa adicionar com um plug-in, você também pode adicionar configurando Copilot manualmente, por exemplo, adicionando perfis de agente personalizados ou servidores MCP. No entanto, os plug-ins fornecem várias vantagens em relação à configuração manual:
| Feature | Configuração manual em um repositório | Plug-in |
|---|---|---|
| Scope | Repositório único | Qualquer projeto |
| Sharing | Copiar/colar manualmente | Comando de instalação ou entrada enabledPlugins |
| Versioning | Histórico do Git | Versões do Marketplace |
| Discovery | Pesquisando repositórios | Navegação no Marketplace |