# Plug-ins para GitHub Copilot

Os plug-ins agrupam personalizações relacionadas para que você possa instalá-las juntas em superfícies Copilot compatíveis.

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](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference).
* 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](/pt/copilot/reference/plugin-and-marketplace-reference).

## 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.md` arquivos em `agents/`)
* **Habilidades** – instruções, scripts e recursos específicos da tarefa (subdiretórios de `skills/`habilidades, contendo um `SKILL.md` arquivo)
* **Hooks** — manipuladores de eventos que respondem a ações do agente (um arquivo `hooks.json` na raiz do plug-in ou em `hooks/`)
* **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.json` no 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.json`canô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:

```text
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](/pt/copilot/reference/copilot-cli-reference/cli-plugin-reference#agent-plugins-10-manifest-fields).

### Estrutura de plugin legada

Um diretório legado de plugin Copilot pode ser assim:

```text
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](/pt/copilot/reference/copilot-cli-reference/cli-plugin-reference). Para obter orientações passo a passo sobre como criar um plug-in, consulte [Criando um plug-in para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating).

## 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](https://github.com/github/awesome-copilot?utm_source=customization-plugin-doc-awesome\&utm_medium=docs\&utm_campaign=universe-2026). 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](/pt/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/override-settings-for-teams).

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](/pt/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson).

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](/pt/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/manage-plugin-marketplaces-and-plugins).

## 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](#further-reading).

## 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                          |

## Leitura adicional

* [Usando plug-ins em Visual Studio Code](/pt/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/using-plugins)
* [Localizando e instalando plug-ins para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)
* [Personalizando a aplicativo Copilot do GitHub](/pt/copilot/how-tos/github-copilot-app/customize-github-copilot-app#adding-plugins)
* [Configurando configurações para GitHub Copilot na nuvem](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings#configuring-plugins-for-github-copilot-cloud-agent)
* [Criando e compartilhando um marketplace de plug-in no GitHub](/pt/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces)