{"meta":{"title":"Sobre plug-ins GitHub Copilot","intro":"Os plugins são pacotes instaláveis que ampliam Copilot com agentes, habilidades, ganchos e integrações reutilizáveis.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/concepts","title":"Conceitos"},{"href":"/pt/copilot/concepts/agents","title":"Agentes"},{"href":"/pt/copilot/concepts/agents/about-plugins","title":"Plugins"}],"documentType":"article"},"body":"# Sobre plug-ins GitHub Copilot\n\nOs plugins são pacotes instaláveis que ampliam Copilot com agentes, habilidades, ganchos e integrações reutilizáveis.\n\nOs 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.\n\n## O que é um plug-in?\n\n* Um pacote distribuível que estende a funcionalidade de Copilot.\n* Um pacote de componentes em uma única unidade instalável.\n\n## O que os plug-ins contêm\n\nUm plug-in pode conter alguns ou todos os seguintes componentes:\n\n* **Agentes personalizados** – assistentes de IA especializados (`*.agent.md` arquivos em `agents/`)\n* **Habilidades** – funcionalidades discretas que podem ser chamadas (subdiretórios de habilidades `skills/`, contendo um `SKILL.md` arquivo)\n* **Ganchos** – manipuladores de eventos que interceptam o comportamento do agente (um arquivo `hooks.json` no diretório raiz do plug-in ou em `hooks/`)\n* **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/`)\n* **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/`)\n\n## Como os plug-ins são estruturados\n\nUm 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.\n\nUm diretório de plug-in típico tem esta aparência:\n\n```text\nmy-plugin/\n├── plugin.json           # Required manifest\n├── agents/               # Custom agents (optional)\n│   └── helper.agent.md\n├── skills/               # Skills (optional)\n│   └── deploy/\n│       └── SKILL.md\n├── hooks.json            # Hook configuration (optional)\n├── .mcp.json             # MCP server config (optional)\n└── lsp.json              # LSP server config (optional)\n```\n\nPara 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).\n\n## Por que usar plug-ins?\n\nOs plug-ins oferecem os seguintes benefícios:\n\n* Reutilização entre projetos\n* Padronização da configuração da equipe Copilot\n* Compartilhar conhecimentos de domínio (por exemplo, fornecendo as habilidades de um especialista em Rails ou um especialista em Kubernetes)\n* Encapsular configurações complexas do servidor MCP\n\n## Onde posso obter plug-ins?\n\nVocê pode instalar plug-ins de:\n\n* Um mercado online\n* Um repositório\n* Um caminho local\n\nUm 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.\n\nExemplos de marketplaces incluem:\n\n* [copilot-plugins](https://github.com/github/copilot-plugins) (adicionados por padrão)\n* [awesome-copilot](https://github.com/github/awesome-copilot) (adicionado por padrão)\n* [claude-code-plugins](https://github.com/anthropics/claude-code)\n* [claudeforge-marketplace](https://github.com/claudeforge/marketplace)\n\nComo você instala um plug-in depende de qual cliente você está usando:\n\n* 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).\n* 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.\n* Na caixa GitHub Copilot app, clique em **Personalizar** e clique **em Plug-ins** para procurar marketplaces e instalar plug-ins.\n\nOs 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).\n\n## Como funcionam os marketplaces de plug-in\n\nUm 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.\n\nUm 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.\n\nComo 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).\n\n## Plug-ins comparados com a configuração manual\n\nQualquer 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:\n\n| Característica | Configuração manual em um repositório | Plug-in                                           |\n| -------------- | ------------------------------------- | ------------------------------------------------- |\n| Scope          | Repositório único                     | Qualquer projeto                                  |\n| Sharing        | Copiar/colar manualmente              | Comando de instalação ou entrada `enabledPlugins` |\n| Versioning     | Histórico do Git                      | Versões do Marketplace                            |\n| Discovery      | Pesquisando repositórios              | Navegação no Marketplace                          |\n\n## Leitura adicional\n\n* [Sobre as habilidades do agente](/pt/copilot/concepts/agents/about-agent-skills)\n* [Sobre ganchos para GitHub Copilot](/pt/copilot/concepts/agents/hooks)\n* [Sobre agentes personalizados](/pt/copilot/concepts/agents/copilot-cli/about-custom-agents)"}