{"meta":{"title":"referência de plugin da CLI GitHub Copilot","intro":"Encontre comandos e detalhes de configuração para plug-ins da CLI.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/pt/enterprise-cloud@latest/copilot/reference","title":"Referência"},{"href":"/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference","title":"Copilot CLI referência"},{"href":"/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-plugin-reference","title":"Referência do plugin CLI"}],"documentType":"article"},"body":"# referência de plugin da CLI GitHub Copilot\n\nEncontre comandos e detalhes de configuração para plug-ins da CLI.\n\n> \\[!NOTE]\n> Você pode encontrar ajuda para usar plug-ins entrando `copilot plugin [SUBCOMMAND] --help` no terminal.\n\nPara obter uma visão geral do que são plug-ins e como eles funcionam entre Copilot clientes, consulte [Sobre plug-ins GitHub Copilot](/pt/enterprise-cloud@latest/copilot/concepts/agents/about-plugins).\n\n## Comandos da CLI\n\nVocê pode usar os seguintes comandos no terminal para gerenciar plug-ins para Copilot CLI.\n`copilot plugin` e `copilot plugins` são equivalentes — use o que soar melhor para o subcomando.\n\n| Command | Descrição |\n| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `copilot plugin install SPECIFICATION` | Instale um plug-in. Consulte [Especificação do plugin para `install` o comando](#plugin-specification-for-install-command) abaixo. |\n| `copilot plugin uninstall NAME` | Remover um plug-in |\n| `copilot plugin list` | Listar plug-ins instalados |\n| `copilot plugin update NAME` | Atualize um plug-in nomeado. Use `--all` para atualizar todos os plug-ins instalados ao mesmo tempo. |\n| `copilot plugin enable NAME` | Habilitar um plug-in desabilitado anteriormente |\n| `copilot plugin disable NAME` | Desabilitar um plug-in sem desinstalá-lo |\n| `copilot plugin marketplace add SPECIFICATION` | Registre um mercado. O próprio nome do marketplace, a partir de seu `marketplace.json` manifesto, torna-se sua chave de registro— não há nenhuma opção para definir um nome local personalizado. |\n| `copilot plugin marketplace list` | Listar marketplaces registrados |\n| `copilot plugin marketplace browse NAME` | Navegue pelos plugins do marketplace |\n| `copilot plugin marketplace update [NAME]` (também conhecido como `refresh`) | Buscar novamente o catálogo de plug-ins do marketplace. Omita `NAME` para atualizar os catálogos de cada marketplace registrado. |\n| `copilot plugin marketplace remove NAME` | Cancelar o registro de um marketplace. Será recusado se plugins do Marketplace ainda estiverem instalados; passe `--force` para também desinstalar esses plugins. |\n\nDe forma não interativa, `copilot plugins enable NAME --plugin`, `copilot plugins disable NAME --plugin` e `copilot plugins remove NAME --plugin` fornecem as mesmas operações de habilitar, desabilitar e desinstalar.\n`--plugin` é o tipo padrão e pode ser omitido para esses três comandos. Consulte [referência de comando da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#using-copilot-plugins-list) para os tipos `--mcp` não interativos `--skill`, que estendem esses comandos para servidores MCP e habilidades.\n\n> \\[!NOTE]\n> Um plug-in ou marketplace definido por uma organização ou por uma política gerenciada por MDM (`enabledPlugins`, `extraKnownMarketplaces`) não pode ser reabilitado, desabilitado nem redirecionado localmente — o valor gerenciado prevalece para essa entrada. O `/plugin` painel marca essas linhas com um `Managed` indicador e não permite uma alternância conflitante. Consulte [Diretório de configuração do GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#mdm-managed-settings).\n\n### Especificação do plug-in para `install` comando\n\n| Formato | Exemplo | Descrição |\n| ---------------------------- | ---------------------------- | ------------------------------------ |\n| Marketplace | `plugin@marketplace` | Plug-in de um marketplace registrado |\n| GitHub | `OWNER/REPO` | Raiz de um GitHub repositório |\n| GitHub subdiretório | `OWNER/REPO:PATH/TO/PLUGIN` | Subdiretório em um repositório |\n| Git URL | `https://github.com/o/r.git` | Qualquer URL do Git |\n| Caminho local | | |\n| `./my-plugin` ou `/abs/path` | Diretório local | |\n\n### `copilot plugins install` opções\n\nAlém de instalar um plug-in a partir de uma especificação, o `copilot plugins install` pode instalar uma skill individual a partir de um arquivo, de uma URL ou de um diretório com `--skill`. A instalação de uma skill não é uma instalação de plug-in e não passa por uma loja — consulte [referência de comando da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#skills-reference) para ver detalhes sobre as skills em si.\n\n| Opção | Descrição | |\n| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------- |\n| `--plugin` | Instale um plug-in (padrão). | |\n| `--skill` | Instale uma habilidade de um caminho ou URL local. | |\n| `--scope SCOPE` | Para instalar um arquivo ou uma URL `--skill`: `user` (padrão) ou `project`. | |\n| `project` limita a instalação ao diretório `.github/skills` do repositório atual, em vez de à sua conta de usuário, e se aplica apenas a instalações de habilidades por arquivo ou URL. | | |\n| `--config-dir=DIRECTORY` | Caminho para o diretório de configuração. Essa opção foi preterida. Use `COPILOT_HOME` em seu lugar. | |\n\nInstalar um diretório registra-o como uma fonte de habilidade personalizada em vez de copiá-lo; A instalação de um arquivo ou URL copia o conteúdo da habilidade no diretório de habilidades pessoais ou de projeto.\n\nOs servidores MCP são instalados a partir de um registro configurado por política, que requer autenticação e entrada de segredo interativa. Use o painel `/mcp` ou `/plugin` (modo Online) para adicionar servidores MCP em vez de usar `copilot plugins install`.\n\n### `copilot plugins update` opções\n\n| Opção | Descrição |\n| ------- | -------------------------------- |\n| `--all` | Atualizar cada plug-in instalado |\n\n> \\[!NOTE]\n> Os plug-ins baseados em caminho em um marketplace local (baseado em diretório) são carregados diretamente do diretório real — ao editar um deles, a alteração passa a valer em `/restart` ou em uma nova sessão, sem precisar de `copilot plugin update`.\n\nOs plugins nativos — aqueles instalados das lojas integradas `copilot-plugins` e `awesome-copilot` — são atualizados automaticamente no início de cada sessão em um diretório de trabalho confiável. Desabilite esse comportamento com a `autoUpdate` configuração (definida como `false`) ou a variável de `COPILOT_AUTO_UPDATE=false` ambiente. A atualização automática também é ignorada por padrão na CI. Consulte [Diretório de configuração do GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#configuration-file-settings).\n\nUm marketplace que você mesmo adicionou pode ativar a mesma atualização automática no início da sessão definindo `autoUpdate: true` no item `extraKnownMarketplaces` correspondente nas suas configurações de usuário. Essa adesão se aplica somente a sessões interativas e `-p` — as sessões de SDK e de servidor não são atualizadas automaticamente. Essa configuração é respeitada nas suas próprias configurações de usuário ou nas configurações gerenciadas (MDM/servidor), mas uma configuração `autoUpdate` no nível do repositório é aceita e ignorada — ela não pode ativar nem redirecionar a atualização automática para um marketplace. Em um conflito entre nomes idênticos, um marketplace interno primário prevalece; em seguida, uma entrada gerenciada (que substitui toda a entrada do usuário com o mesmo nome, de modo que uma entrada gerenciada sem `\"autoUpdate\": true` remove a adesão do usuário); e, por fim, a entrada do próprio usuário. Consulte [as configurações do Repositório](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson).\n\nNo modo interativo, `/plugin` indica um plug-in instalado ou o marketplace quando uma versão mais recente está disponível na origem e oferece, no painel, a ação **Atualizar** para baixá-la.\n\n### `copilot plugins marketplace` Subcomandos\n\nOs marketplaces padrão integrados acompanham o runtime e não podem ser removidos.\n\n| Subcommand | Descrição |\n| ------------------------------------------------- | ---------------------------------------------------------------------------------------- |\n| `list [--json]` | Listar todos os marketplaces registrados, incluindo padrões internos |\n| `add SOURCE` | Adicionar um marketplace (`owner/repo`, `owner/repo#ref`uma URL ou um caminho local) |\n| `remove NAME [--force]` | Remover um marketplace; `--force` também desinstala plug-ins provenientes dele |\n| `browse NAME [--json]` | Listar os plug-ins oferecidos pelo catálogo de um marketplace |\n| `update [NAME]` (também conhecido como `refresh`) | Atualizar o catálogo de plugins para um marketplace ou para todos, se `NAME` for omitido |\n\nNo modo interativo, execute `/plugin marketplace update [NAME]` (alias `/plugin marketplace refresh`) ou pressione `r` na guia Marketplace do painel de plug-ins para atualizar o catálogo de cada marketplace registrado.\n\n## `plugin.json`\n\nTodos os plug-ins consistem em um diretório de plug-in contendo, no mínimo, um arquivo de manifesto chamado `plugin.json` localizado na raiz do diretório do plug-in. Consulte [Criando um plug-in para GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating).\n\n### Campo obrigatório\n\n| Campo | Tipo | Descrição |\n| ------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `name` | cadeia | Nome do plugin Kebab-case (apenas letras, números e hífens). Máximo de 64 chars. Plug-ins que optam pelo [suporte ao Open Plugin Spec](#open-plugin-spec-support) também podem usar os pontinhos (por exemplo, `acme.tools`). |\n\n### Campos de metadados opcionais\n\n| Campo | Tipo | Descrição |\n| ----------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `$schema` | cadeia | Defina para a URL canônica do esquema Agent Plugins (Especificação Aberta de Plug-ins) v1.0.0 para adotar a semântica da especificação. Consulte [o suporte ao Open Plugin Spec](#open-plugin-spec-support). |\n| `description` | cadeia | Breve descrição. Máximo de 1024 caracteres. |\n| `version` | cadeia | Versão semântica (por exemplo, `1.0.0`). |\n| `author` | objeto | |\n| `name` (obrigatório), `email` (opcional), `url` (opcional). | | |\n| `homepage` | cadeia | URL da página inicial do plugin. |\n| `repository` | cadeia | URL do repositório de origem. |\n| `license` | cadeia | Identificador de licença (por exemplo, `MIT`). |\n| `keywords` | cadeia de caracteres\\[] | Pesquisar palavras-chave. |\n| `category` | cadeia | Categoria de plug-in. |\n| `tags` | cadeia de caracteres\\[] | Etiquetas adicionais. |\n\n### Campos de caminho do componente\n\nElas indicam à CLI onde encontrar os componentes do seu plug-in. Todos são opcionais. A CLI usa convenções padrão se omitidas.\n\n| Campo | Tipo | Default | Descrição |\n| ------------ | ----------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `agents` | cadeia de caracteres \\| cadeia de caracteres\\[] | `agents/` | Caminhos para diretórios de agente (`.agent.md` arquivos). |\n| `skills` | cadeia de caracteres \\| cadeia de caracteres\\[] | `skills/` | Caminhos para diretórios de habilidades (`SKILL.md` arquivos). |\n| `commands` | cadeia de caracteres \\| cadeia de caracteres\\[] | — | Caminhos para diretórios de comando. |\n| `hooks` | objeto string \\| | — | Caminho para um arquivo de configuração de ganchos ou um objeto de ganchos embutido. |\n| `extensions` | string \\| string\\[] \\| object | — | Caminhos para diretórios de extensão. Use `{ paths: [...], exclusive: true }` para suprimir extensões internas. No [modo de Especificação do Plug-in Aberto](#open-plugin-spec-support), esse campo tem um significado diferente. |\n| `mcpServers` | objeto string \\| | — | Caminho para um arquivo de configuração MCP (por exemplo, `.mcp.json`) ou definições de servidor embutido. |\n| `lspServers` | objeto string \\| | — | Caminho para um arquivo de configuração do LSP, ou definições de servidor em linha. |\n\n### Arquivo de exemplo `plugin.json`\n\n```json copy\n{\n \"name\": \"my-dev-tools\",\n \"description\": \"React development utilities\",\n \"version\": \"1.2.0\",\n \"author\": {\n \"name\": \"Jane Doe\",\n \"email\": \"jane@example.com\"\n },\n \"license\": \"MIT\",\n \"keywords\": [\"react\", \"frontend\"],\n \"agents\": \"agents/\",\n \"skills\": [\"skills/\", \"extra-skills/\"],\n \"hooks\": \"hooks.json\",\n \"mcpServers\": \".mcp.json\"\n}\n```\n\n## Suporte à Especificação Aberta de Plugins\n\nDeclarar o `$schema` canônico em `plugin.json` faz com que um plug-in adote o formato [Agent Plugins (Open Plugin Spec)](https://agent-plugins.org) v1.0.0, de forma adicional ao carregamento padrão de plug-ins:\n\n### Configuração do servidor LSP\n\nPara incluir servidores LSP (Language Server Protocol) em um plug-in, crie um `lsp-config/servers.json` arquivo no diretório do plug-in ou especifique um caminho ou objeto embutido usando o `lspServers` campo em `plugin.json`.\n\nExemplo `lsp-config/servers.json` (ou em linha via `lspServers` em `plugin.json`):\n\n```json\n{\n \"lspServers\": {\n \"my-lsp\": {\n \"command\": \"my-language-server\",\n \"fileExtensions\": { \".myext\": \"mylang\" }\n }\n }\n}\n```\n\nPara suporte multiplataforma, use `bash` e `powershell` , em vez de `command`:\n\n```json\n{\n \"lspServers\": {\n \"my-lsp\": {\n \"bash\": \"${PLUGIN_ROOT}/scripts/start-lsp.sh\",\n \"powershell\": \"${PLUGIN_ROOT}/scripts/start-lsp.ps1\",\n \"fileExtensions\": { \".myext\": \"mylang\" }\n }\n }\n}\n```\n\n| Campo | Tipo | Obrigatório | Descrição |\n| ----------------------- | ----------------------- | ----------- | -------------------------------------------------------------------------------------------------------------- |\n| `command` | cadeia | \\* | Executável para iniciar o servidor de idiomas. |\n| `bash` | cadeia | \\* | Script bash para iniciar o servidor (Linux/macOS); executado por meio de `bash -c SCRIPT`. |\n| `powershell` | cadeia | \\* | Script do PowerShell para iniciar o servidor (Windows); executado por meio de `pwsh -c SCRIPT`. |\n| `cwd` | cadeia | No | Diretório de trabalho. Absoluto ou relativo ao arquivo de configuração. Oferece suporte para `${PLUGIN_ROOT}`. |\n| `args` | cadeia de caracteres\\[] | No | Argumentos a serem passados para `command` (ignorados para `bash` e `powershell`). |\n| `env` | objeto | No | Variáveis de ambiente a serem definidas ao gerar o servidor. |\n| `fileExtensions` | objeto | Sim | Mapa de extensões de arquivo para IDs de idioma (por exemplo, `{ \".ts\": \"typescript\" }`). |\n| `rootUri` | cadeia | No | Raiz do projeto em relação à raiz do Git (padrão: `.`). |\n| `initializationOptions` | any | No | Opções enviadas ao servidor na solicitação LSP `initialize` . |\n\n(\\*) Pelo menos um de `command`, `bash`ou `powershell` é necessário. Quando `bash` e `powershell` são especificados, o apropriado para a plataforma é selecionado automaticamente (PowerShell no Windows, Bash em outro lugar).\n\nUse `${PLUGIN_ROOT}` para referenciar caminhos no diretório do plug-in.\n\n## `marketplace.json`\n\nVocê pode criar um marketplace de plug-ins, que as pessoas podem usar para descobrir e instalar seus plug-ins, criando um `marketplace.json` arquivo e salvando-o no `.github/plugin/` diretório do repositório. Você também pode armazenar o `marketplace.json` arquivo em seu sistema de arquivos local. Por exemplo, salvar o arquivo como `/PATH/TO/my-marketplace/.github/plugin/marketplace.json` permite adicioná-lo à CLI usando o seguinte comando:\n\n```shell\ncopilot plugin marketplace add /PATH/TO/my-marketplace\n```\n\n> \\[!NOTE]\n> O Copilot CLI também procura o arquivo `marketplace.json` no diretório `.claude-plugin/`.\n\nPara obter mais informações, consulte [Criando um marketplace de plugin para GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace).\n\n### Arquivo de exemplo `marketplace.json`\n\n```json copy\n{\n \"name\": \"my-marketplace\",\n \"owner\": {\n \"name\": \"Your Organization\",\n \"email\": \"plugins@example.com\"\n },\n \"metadata\": {\n \"description\": \"Curated plugins for our team\",\n \"version\": \"1.0.0\"\n },\n \"plugins\": [\n {\n \"name\": \"frontend-design\",\n \"description\": \"Create a professional-looking GUI ...\",\n \"version\": \"2.1.0\",\n \"source\": \"./plugins/frontend-design\"\n },\n {\n \"name\": \"security-checks\",\n \"description\": \"Check for potential security vulnerabilities ...\",\n \"version\": \"1.3.0\",\n \"source\": \"./plugins/security-checks\"\n }\n ]\n}\n```\n\n> \\[!NOTE]\n> O valor do `source` campo para cada plug-in é o caminho para o diretório do plug-in, em relação à raiz do repositório. Não é necessário usar `./` no início do caminho. Por exemplo, `\"./plugins/plugin-name\"` e `\"plugins/plugin-name\"` resolvem para o mesmo diretório.\n\n### Campos `marketplace.json`\n\n#### Campos de nível superior\n\n| Campo | Tipo | Obrigatório | Descrição |\n| ---------------------------------------------------------------- | ------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `name` | cadeia | Sim | Nome do mercado de kebabs. Máximo de 64 chars. Pontos também são aceitos (por exemplo, `acme.tools`) para plug-ins da [Especificação Aberta de Plug-ins](#open-plugin-spec-support). |\n| `owner` | objeto | Sim | |\n| `{ name, email? }` — informações do proprietário do marketplace. | | | |\n| `plugins` | matriz | Sim | Lista de entradas de plug-in (consulte a tabela abaixo). |\n| `metadata` | objeto | No | `{ description?, version?, pluginRoot? }` |\n\n#### Campos de entrada de plug-in (objetos dentro da `plugins` matriz)\n\n| Campo | Tipo | Obrigatório | Descrição |\n| ------------- | ----------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `name` | cadeia | Sim | Nome do plugin Kebab-case. Máximo de 64 chars. Os pontos também são aceitos para [plug-ins Open Plugin Spec](#open-plugin-spec-support). |\n| `source` | objeto string \\| | Sim | Onde buscar o plug-in (caminho relativo GitHub ou URL). |\n| `description` | cadeia | No | Descrição do plug-in. Máximo de 1024 caracteres. |\n| `version` | cadeia | No | Versão do plug-in. |\n| `author` | objeto | No | `{ name, email?, url? }` |\n| `homepage` | cadeia | No | URL da página inicial do plugin. |\n| `repository` | cadeia | No | URL do repositório de origem. |\n| `license` | cadeia | No | Identificador de licença. |\n| `keywords` | cadeia de caracteres\\[] | No | Pesquisar palavras-chave. |\n| `category` | cadeia | No | Categoria de plug-in. |\n| `tags` | cadeia de caracteres\\[] | No | Etiquetas adicionais. |\n| `commands` | cadeia de caracteres \\| cadeia de caracteres\\[] | No | Caminhos para diretórios de comando. |\n| `agents` | cadeia de caracteres \\| cadeia de caracteres\\[] | No | Caminhos para diretórios de agente. |\n| `skills` | cadeia de caracteres \\| cadeia de caracteres\\[] | No | Caminhos para diretórios de habilidades. |\n| `hooks` | objeto string \\| | No | Caminho para a configuração de ganchos ou objeto de ganchos embutidos. |\n| `mcpServers` | objeto string \\| | No | Servidores MCP a serem ativados quando o plugin é instalado. Aceita um mapa de servidor embutido ou um caminho para um arquivo de configuração JSON. Usado quando a origem do plug-in não envia sua própria configuração de MCP. |\n| `lspServers` | objeto string \\| | No | Caminho para a configuração do LSP ou definições de servidor em linha. |\n| `strict` | boolean | No | Quando `true` (o padrão), os plug-ins devem estar em conformidade com o esquema completo e as regras de validação. Quando `false` a validação relaxada é usada, permite mais flexibilidade, especialmente para instalações diretas ou plugins legados. |\n\n#### Tipos de origem de plug-in\n\nO campo `source` em uma entrada de plugin aceita uma string de caminho relativo ou um objeto que descreve um repositório GitHub ou uma origem de URL do Git:\n\n```json\n{\n \"source\": {\n \"source\": \"github\",\n \"repo\": \"owner/repo\",\n \"ref\": \"v1.0.0\",\n \"path\": \"plugins/my-plugin\"\n }\n}\n```\n\nOs tipos de origem `github` e `url` aceitam um campo opcional `sha` para fixar as instalações em um commit exato, além de (ou em vez de) `ref`:\n\n```json\n{\n \"source\": {\n \"source\": \"github\",\n \"repo\": \"owner/repo\",\n \"sha\": \"a94a8fe5ccb19ba61c4c0873d391e987982fbbd3\",\n \"path\": \"plugins/my-plugin\"\n }\n}\n```\n\n`sha` deve ser um SHA completo de commit com 40 caracteres. Fixe em um `sha` para instalações reproduzíveis que são imunes a pushes forçados ou movimentos de marca/ramificação.\n\n## Locais de arquivos\n\n| Item | Caminho |\n| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Plug-ins instalados | |\n| `~/.copilot/installed-plugins/MARKETPLACE/PLUGIN-NAME` (instalado por meio de um marketplace) e `~/.copilot/installed-plugins/_direct/SOURCE-ID/` (instalado diretamente) | |\n| Cache do Marketplace | Diretório de cache de plataforma: `~/.cache/copilot/marketplaces/` (Linux) `~/Library/Caches/copilot/marketplaces/` (macOS). Substituível por `COPILOT_CACHE_HOME`. |\n| Manifesto do Plugin | |\n| `.plugin/plugin.json`, `plugin.json`ou `.github/plugin/plugin.json``.claude-plugin/plugin.json` (verificado nesta ordem) | |\n| Manifesto do Marketplace | |\n| `marketplace.json`, `.plugin/marketplace.json`ou `.github/plugin/marketplace.json``.claude-plugin/marketplace.json` (verificado nesta ordem) | |\n| Agentes | |\n| `agents/` (padrão, substituível no manifesto) | |\n| Habilidades | |\n| `skills/` (padrão, substituível no manifesto) | |\n| Configuração de ganchos | |\n| `hooks.json` ou `hooks/hooks.json` | |\n| Configuração do MCP | |\n| `.mcp.json`, `.github/mcp.json` | |\n| Configuração de LSP | |\n| `lsp.json` ou `.github/lsp.json` | |\n| Dados de plug-in | |\n| `${COPILOT_PLUGIN_DATA}` (também disponível como `${CLAUDE_PLUGIN_DATA}`). Aponta para um diretório persistente, com permissão de gravação, exclusivo para cada plug-in instalado. Use isso para dados de runtime específicos do plug-in em vez de caminhos dentro do diretório de cache de plug-ins instalados. | |\n\n## Ordem e precedência de carregamento\n\nSe você instalar vários plug-ins, é possível que alguns agentes personalizados, habilidades, servidores MCP ou ferramentas fornecidas por meio de servidores MCP tenham nomes duplicados. Nessa situação, a CLI determina qual componente usar com base em uma ordem de precedência.\n\n* **Agentes e habilidades** use a precedência do primeiro encontrado.\n\n Se você tiver um agente personalizado no nível do projeto ou uma habilidade cujo nome ou ID sejam iguais a os de um plug-in que você instalar, o agente ou habilidade do plug-in será ignorado sem aviso. O plug-in não pode substituir configurações pessoais ou no nível do projeto. Os agentes personalizados são desduplicados usando seu ID, que é derivado de seu nome de arquivo (por exemplo, se o arquivo for nomeado `reviewer.agent.md`, a ID do agente será `reviewer`). As habilidades são desduplicadas pelo campo do nome dentro do arquivo `SKILL.md`.\n\n* **Os servidores MCP** usam a precedência \"último a vencer\".\n\n Se você instalar um plug-in que define um servidor MCP com o mesmo nome de servidor que um servidor MCP já instalado, a definição do plug-in terá precedência. Você pode usar a opção `--additional-mcp-config` de linha de comando para substituir uma configuração de servidor MCP com o mesmo nome, instalado usando um plug-in. Se dois ou mais plug-ins declararem um servidor MCP com o mesmo nome, a CLI usará a versão do plug-in que carregou por último e mostrará um aviso nomeando cada plug-in anterior que o definiu.\n\n* **Ferramentas e agentes internos** estão sempre presentes e não podem ser substituídos por componentes definidos pelo usuário.\n\nO diagrama a seguir ilustra as regras de ordem e precedência de carregamento.\n\n```text\n┌──────────────────────────────────────────────────────────────────┐\n│ BUILT-IN - HARDCODED, ALWAYS PRESENT │\n│ • tools: bash, view, apply_patch, glob, rg, task, ... │\n│ • agents: explore, task, code-review, general-purpose, research │\n└────────────────────────┬─────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ CUSTOM AGENTS - FIRST LOADED IS USED (dedup by ID) │\n │ 1. ~/.copilot/agents/ (user, .github convention) │\n │ 2. /.github/agents/ (project) │\n │ 3. /.github/agents/ (inherited, monorepo) │\n │ 4. /.claude/agents/ (project) │\n │ 5. /.claude/agents/ (inherited, monorepo) │\n │ 6. PLUGIN: agents/ dirs (plugin, by install order) │\n │ 7. Remote org/enterprise agents (remote, via API) │\n └──────────────────────┬──────────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ AGENT SKILLS - FIRST LOADED IS USED (dedup by name) │\n │ 1. /.github/skills/ (project) │\n │ 2. /.agents/skills/ (project) │\n │ 3. /.claude/skills/ (project) │\n │ 4. /.github/skills/ etc. (inherited) │\n │ 5. ~/.copilot/skills/ (personal-copilot) │\n │ 6. ~/.agents/skills/ (personal-agents) │\n │ 7. PLUGIN: skills/ dirs (plugin) │\n │ 8. COPILOT_SKILLS_DIRS env + config (custom) │\n │ --- then commands (.claude/commands/), skills override commands ---│\n └──────────────────────┬──────────────────────────────────────────────┘\n │\n ┌──────────────────────▼──────────────────────────────────────────────┐\n │ MCP SERVERS - LAST LOADED IS USED (dedup by server name) │\n │ 1. ~/.copilot/mcp-config.json (lowest priority) │\n │ 2. PLUGIN: MCP configs (plugins) │\n │ 3. --additional-mcp-config flag (highest priority) │\n └─────────────────────────────────────────────────────────────────────┘\n```\n\n## Leitura adicional\n\n* [Sobre os padrões de plug-in gerenciados pela empresa](/pt/enterprise-cloud@latest/copilot/concepts/agents/about-enterprise-plugin-standards)\n* [GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/how-tos/copilot-cli)\n* [referência de comando da CLI GitHub Copilot](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [referência programática do GitHub Copilot CLI](/pt/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-programmatic-reference)"}