# Sobre plug-ins GitHub Copilot

Os plugins são pacotes instaláveis que ampliam Copilot com agentes, habilidades, ganchos e integrações reutilizáveis.

Os plug-ins fornecem uma maneira de distribuir a funcionalidade personalizada Copilot . Você pode usar um plug-in para adicionar um conjunto pré-configurado de recursos a Copilot, incluindo Copilot CLI, Copilot cloud agente a GitHub Copilot app.

## O que é um plug-in?

* Um pacote distribuível que estende a funcionalidade de Copilot.
* Um pacote de componentes em uma única unidade instalável.

## O que os plug-ins contêm

Um plug-in pode conter alguns ou todos os seguintes componentes:

* **Agentes personalizados** – assistentes de IA especializados (`*.agent.md` arquivos em `agents/`)
* **Habilidades** – funcionalidades discretas que podem ser chamadas (subdiretórios de habilidades `skills/`, contendo um `SKILL.md` arquivo)
* **Ganchos** – manipuladores de eventos que interceptam o comportamento do agente (um arquivo `hooks.json` no diretório raiz do plug-in ou em `hooks/`)
* **Configurações do servidor MCP** – Integrações do Protocolo de Contexto do Modelo (um arquivo `.mcp.json` na raiz do plug-in ou um arquivo `mcp.json` em `.github/`)
* **Configurações do servidor LSP** – integrações do Protocolo do Servidor de Idiomas (um `lsp.json` arquivo na raiz do plug-in ou em `.github/`)

## Como os plug-ins são estruturados

Um plug-in é um diretório com uma estrutura específica. No mínimo, ele contém um `plugin.json` arquivo de manifesto na raiz do diretório. O manifesto fornece um nome ao plug-in e aponta para os componentes fornecidos pelo plug-in. Junto com o manifesto, o diretório pode conter qualquer combinação de agentes, habilidades, ganchos, configurações de servidor MCP e configurações de servidor LSP.

Um diretório de plug-in típico tem esta aparência:

```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
* Padronização da configuração da equipe Copilot
* 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

## Onde posso obter plug-ins?

Você pode instalar plug-ins de:

* Um mercado online
* Um repositório
* Um caminho local

Um marketplace é um local onde os desenvolvedores podem publicar, descobrir, instalar e gerenciar plug-ins. É um pouco como uma loja de aplicativos, mas para plug-ins.

Exemplos de marketplaces incluem:

* [copilot-plugins](https://github.com/github/copilot-plugins) (adicionados por padrão)
* [awesome-copilot](https://github.com/github/awesome-copilot) (adicionado por padrão)
* [claude-code-plugins](https://github.com/anthropics/claude-code)
* [claudeforge-marketplace](https://github.com/claudeforge/marketplace)

Como você instala um plug-in depende de qual cliente você está usando:

* Em Copilot CLI, você pode instalar plug-ins de forma imperativa usando o comando `copilot plugin install` ou o comando de barra `/plugin install`, ou de forma declarativa adicionando o plug-in ao campo `enabledPlugins` de um arquivo `~/.copilot/settings.json` no nível do usuário ou de um arquivo `.github/copilot/settings.json` no nível do repositório. Consulte [Localizando e instalando plug-ins para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing).
* No Copilot cloud agent, você instala plugins declarativamente ao adicioná-los ao campo `enabledPlugins` do arquivo `.github/copilot/settings.json` do repositório. Para instalar plug-ins de um marketplace que não está registrado por padrão, você também pode adicionar o marketplace ao `extraKnownMarketplaces` campo no mesmo arquivo.
* Na caixa GitHub Copilot app, clique em **Personalizar** e clique **em Plug-ins** para procurar marketplaces e instalar plug-ins.

Os administradores corporativos podem definir padrões de plug-in que se aplicam aos usuários no plano da Copilot empresa, incluindo a especificação de marketplaces e plug-ins adicionais que são instalados automaticamente. Consulte [Sobre os padrões de plug-in gerenciados pela empresa](/pt/copilot/concepts/agents/about-enterprise-plugin-standards).

## 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 no GitHub.com, em qualquer outro serviço online de hospedagem Git ou no seu sistema de arquivos local ou compartilhado.

Um marketplace é definido por um `marketplace.json` arquivo, que fornece metadados sobre o marketplace e lista os plug-ins que ele disponibiliza. Cada entrada na matriz do `plugins` marketplace descreve um plug-in, incluindo seu nome, descrição, versão e o caminho para o diretório do plug-in.

Como os plug-ins em um marketplace são versionados, os marketplaces facilitam descobrir, instalar e atualizar plug-ins, além de compartilhá-los com uma equipe. Para obter orientações passo a passo sobre como criar um marketplace, consulte [Criando um marketplace de plugin para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace).

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

| Característica | 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

* [Sobre as habilidades do agente](/pt/copilot/concepts/agents/about-agent-skills)
* [Sobre ganchos para GitHub Copilot](/pt/copilot/concepts/agents/hooks)
* [Sobre agentes personalizados](/pt/copilot/concepts/agents/copilot-cli/about-custom-agents)