{"meta":{"title":"referência de comando da CLI GitHub Copilot","intro":"Encontre comandos e atalhos de teclado para ajudá-lo a usar CLI do Copilot com eficiência.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/reference","title":"Referência"},{"href":"/pt/copilot/reference/copilot-cli-reference","title":"\n CLI do Copilot referência"},{"href":"/pt/copilot/reference/copilot-cli-reference/cli-command-reference","title":"Referência de comandos da CLI"}],"documentType":"article"},"body":"# referência de comando da CLI GitHub Copilot\n\nEncontre comandos e atalhos de teclado para ajudá-lo a usar CLI do Copilot com eficiência.\n\n## Comandos de linha de comando\n\n| Command | Propósito |\n| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `copilot` | Inicie a interface interativa do usuário. |\n| `copilot help [TOPIC]` | Exibir informações de ajuda. Os tópicos de ajuda incluem: `config`, , `commands`, `environment`, `logging`, `monitoring`, e `permissions``providers`. |\n| `copilot init` | Inicialize Copilot instruções personalizadas para este repositório. |\n| `copilot login` | Autentique-se com Copilot por meio do fluxo do dispositivo OAuth. Aceita `--host HOST` para especificar a URL do host GitHub (padrão: `https://github.com`). |\n| `copilot login` \\[OPÇÃO] | Autentique-se com Copilot por meio do fluxo do dispositivo OAuth. Veja [`copilot login` as opções](#copilot-login-options). |\n| `copilot mcp` | Gerencie as configurações do servidor MCP na linha de comando. |\n| `copilot plugin` | Gerenciar plug-ins e mercados de plug-ins. |\n| `copilot update` | Baixe e instale a versão mais recente. |\n| `copilot version` | Exibir informações de versão e verificar se há atualizações. |\n\n###\n\n```\n `copilot login` opções\n```\n\n| Opção | Propósito |\n| ------------- | --------- |\n| `--host HOST` | |\n\n```\n GitHub URL do host (padrão: `https://github.com`). Use isso para autenticar com uma GitHub Enterprise Cloud instância que usa residência de dados (por exemplo, `https://example.ghe.com`). |\n```\n\n\\| `--config-dir PATH` | Defina o diretório de configuração (padrão: `~/.copilot`). |\n\nO modo de autenticação padrão é um fluxo de navegador baseado na Web. Após a conclusão, um token de autenticação é armazenado com segurança no repositório de credenciais do sistema. Se um repositório de credenciais não for encontrado, o token será armazenado em um arquivo de configuração de texto sem formatação em `~/.copilot/`.\n\nComo alternativa, CLI do Copilot usará um token de autenticação encontrado em variáveis de ambiente. Os seguintes são verificados em ordem de precedência: `COPILOT_GITHUB_TOKEN`, , `GH_TOKEN`. `GITHUB_TOKEN` Esse método é mais adequado para uso sem cabeça, como automação.\n\nOs tipos de token com suporte incluem fine-grained personal access tokens (PATs v2) com a permissão \"Solicitações do Copilot\", tokens OAuth do aplicativo Copilot CLI e tokens OAuth do aplicativo GitHub CLI (`gh`). Clássicos personal access tokens (`ghp_`) não são suportados.\n\n```\n **Exemplos:**\n```\n\n```shell\n# Authenticate with github.com\ncopilot login\n\n# Authenticate with GitHub Enterprise Cloud (data residency)\ncopilot login --host https://example.ghe.com\n\n# Use a fine-grained PAT via environment variable\nCOPILOT_GITHUB_TOKEN=github_pat_... copilot\n```\n\n## Atalhos globais na interface interativa\n\n| Atalho | Propósito |\n| ------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `@ FILENAME` | Inclua o conteúdo do arquivo no contexto. |\n| `# NUMBER` | Inclua um GitHub problema ou solicitação de pull no contexto. |\n| `! COMMAND` | Execute um comando no shell local, ignorando Copilot. |\n| `?` | Abra ajuda rápida (em um prompt vazio). |\n| Esc | Cancele a operação atual. |\n| Ctrl+C | Cancelar a operação/limpar a entrada. Pressione duas vezes para sair. |\n| Ctrl+D | Desligamento. |\n| CTRL+G | Edite o prompt em um editor externo (`$EDITOR`). |\n| Ctrl+L | Limpar a tela. |\n| Ctrl+Enter ou Ctrl+Q | Coloca na fila uma mensagem para enviar enquanto o agente está ocupado. |\n| Ctrl+R | Pesquisa inversa por meio do histórico de comandos. |\n| Ctrl+V | Cole o conteúdo da área de transferência como anexo. |\n| Ctrl+X , em seguida, `/` | Depois de começar a digitar um prompt, isso permite que você execute um comando de barra , por exemplo, se você quiser alterar o modelo sem precisar digitar novamente o prompt. |\n| Ctrl+X , em seguida, `e` | Edite o prompt em um editor externo (`$EDITOR`). |\n| Ctrl+X , em seguida, `o` | Abra o link mais recente da linha do tempo. |\n| Ctrl+Z | Suspenda o processo em segundo plano (Unix). |\n| Shift+Enter ou Option+Enter (Mac) / Alt+Enter (Windows/Linux) | Insira uma nova linha na entrada. |\n| Shift+Tab | Ciclo entre o modo padrão, plano e piloto automático. |\n\n## Atalhos de linha do tempo na interface interativa\n\n| Atalho | Propósito |\n| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |\n| Ctrl+O | Embora não haja nada na entrada do prompt, isso expande os itens recentes na linha do tempo de resposta do Copilot para mostrar mais detalhes. |\n| Ctrl+E | Embora não haja nada na entrada do prompt, isso expande todos os itens na linha do tempo de resposta do Copilot. |\n| CTRL+T | Expanda/recolha a exibição de raciocínio nas respostas. |\n| Página Para Cima/Página Para Baixo | Role a linha do tempo para cima ou para baixo em uma página. |\n\n## Atalhos de navegação na interface interativa\n\n| Atalho | Propósito |\n| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |\n| Ctrl+A | Ir para o início da linha (ao digitar). |\n| Ctrl+B | Mova para o caractere anterior. |\n| Ctrl+E | Mover para o final da linha (quando se está digitando). |\n| Ctrl+F | Mova para o próximo caractere. |\n| CTRL+H | Exclua o caractere anterior. |\n| Ctrl+K | Apague desde o cursor até o final da linha. Se o cursor estiver no final da linha, exclua a quebra de linha. |\n| Ctrl+U | Apague desde o cursor até o início da linha. |\n| Ctrl+W | Exclua a palavra anterior. |\n| Início | Vá para o início do texto. |\n| End | Mova para o final do texto. |\n| Alt+←/→ (Windows/Linux)
| |\n\n```\n Opção+←/→ (Mac) | Mova o cursor uma palavra por vez. |\n```\n\n\\| ↑/↓ | Navegue pelo histórico de comandos. |\n\n## Comandos de barra na interface interativa\n\n| Command | Propósito |\n| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `/add-dir PATH` | Adicione um diretório à lista de permissões para acesso ao arquivo. |\n| `/agent` | Navegue e selecione entre os agentes disponíveis (se houver). Consulte [Sobre agentes personalizados](/pt/copilot/concepts/agents/copilot-cli/about-custom-agents). |\n| `/ask QUESTION` | Faça uma pergunta rápida sem adicionar ao histórico da conversa. Disponível apenas no modo experimental. |\n| `/allow-all [on\\|off\\|show]`, `/yolo [on\\|off\\|show]` | Habilite todas as permissões (ferramentas, caminhos e URLs). |\n| `/changelog [summarize] [VERSION\\|last N\\|since VERSION]`, `/release-notes [summarize] [VERSION\\|last N\\|since VERSION]` | Exiba o registro de alterações da CLI. Opcionalmente, especifique uma versão, uma contagem de versões recentes ou uma versão inicial. Adicione a palavra-chave `summarize` para um resumo gerado por IA. |\n| `/chronicle ` | Ferramentas e insights sobre o histórico de sessões. Disponível apenas no modo experimental. |\n| `/clear [PROMPT]` | |\n\n```\n `/new [PROMPT]`\n `/reset [PROMPT]`\n | Inicie uma nova conversa. |\n```\n\n\\| `/compact` | Resumir o histórico de conversas para reduzir o uso da janela de contexto. Consulte [Gerenciando o contexto em CLI do GitHub Copilot](/pt/copilot/concepts/agents/copilot-cli/context-management#compaction). |\n\\| `/context` | Mostrar o uso e a visualização do token da janela de contexto. Consulte [Gerenciando o contexto em CLI do GitHub Copilot](/pt/copilot/concepts/agents/copilot-cli/context-management#checking-your-context-usage). |\n\\| `/copy` | Copie a última resposta para a área de transferência. |\n\\| `/cwd`, `/cd [PATH]` | Altere o diretório de trabalho ou exiba o diretório atual. |\n\\| `/delegate [PROMPT]` | Delegar alterações em um repositório remoto com uma solicitação de pull gerada por IA. Consulte [Delegando tarefas para CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli/use-copilot-cli-agents/delegate-tasks-to-cca). |\n\\| `/diff` | Examine as alterações feitas no diretório atual. |\n\\| `/env` | Mostrar detalhes do ambiente carregado (instruções, servidores MCP, habilidades, agentes, plug-ins, LSPs, extensões). |\n\\| `/exit`, `/quit` | Saia da CLI. |\n\\| `/experimental [on\\|off\\|show]` | Alterne, defina ou mostre recursos experimentais. |\n\\| `/feedback`, `/bug` | Forneça comentários sobre a CLI. |\n\\| `/fleet [PROMPT]` | Habilite a execução de subagentes paralelos de partes de uma tarefa. Consulte [Executando tarefas em paralelo com o \\`/fleet\\` comando](/pt/copilot/concepts/agents/copilot-cli/fleet). |\n\\| `/help` | Mostrar a ajuda para comandos interativos. |\n\\| `/ide` | Conecte-se a um workspace do IDE. Consulte [Conectando CLI do GitHub Copilot a VS Code](/pt/copilot/how-tos/copilot-cli/connecting-vs-code#managing-the-connection-with-the-ide-slash-command). |\n\\| `/init` | Inicialize instruções personalizadas e recursos de agentes do Copilot para este repositório. Consulte [Inicialização do Projeto para Copilot](#project-initialization-for-copilot). |\n\\| `/instructions` | Exibir e alternar arquivos de instrução personalizados. |\n\\| `/keep-alive [on\\|busy\\|NUMBERm\\|NUMBERh]` | Impedir que o computador durma: enquanto uma sessão da CLI estiver ativa, enquanto o agente estiver ocupado ou por um período de tempo definido. Disponível apenas no modo experimental. |\n\\| `/list-dirs` | Exiba todos os diretórios para os quais o acesso ao arquivo foi permitido. |\n\\| `/login` | Faça login em Copilot. |\n\\| `/logout` | Faça logoff do Copilot. |\n\\| `/lsp [show\\|test\\|reload\\|help] [SERVER-NAME]` | Gerencie a configuração do servidor de idiomas. |\n\\| `/mcp [show\\|add\\|edit\\|delete\\|disable\\|enable\\|auth\\|reload] [SERVER-NAME]` | Gerenciar a configuração do servidor MCP. Consulte [Adicionando servidores MCP para CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers#managing-mcp-servers). |\n\\| `/model`, `/models [MODEL]` | Selecione o modelo de IA que você deseja usar. |\n\\| `/plan [PROMPT]` | Crie um plano de implementação antes da codificação. |\n\\| `/plugin [marketplace\\|install\\|uninstall\\|update\\|list] [ARGS...]` | Gerenciar plug-ins e mercados de plug-ins. Consulte [Sobre plug-ins para CLI do GitHub Copilot](/pt/copilot/concepts/agents/copilot-cli/about-cli-plugins). |\n\\| `/pr [view\\|create\\|fix\\|auto]` | Gerenciar solicitações de pull para o branch atual. Consulte [Gerenciando solicitações de pull com o comando /pr](/pt/copilot/how-tos/copilot-cli/manage-pull-requests). |\n\\| `/remote` | Habilite o acesso remoto a esta sessão a partir de GitHub.com e GitHub Mobile. Consulte [Controlando uma CLI do GitHub Copilot sessão de outro dispositivo](/pt/copilot/how-tos/copilot-cli/steer-remotely). |\n\\| `/rename [NAME]` | Renomeie a sessão atual (gera automaticamente um nome caso a opção não seja especificada; alias para `/session rename`). |\n\\| `/research TOPIC` | Execute uma investigação aprofundada usando fontes de busca e web do GitHub. Consulte [Pesquisando com CLI do GitHub Copilot](/pt/copilot/concepts/agents/copilot-cli/research). |\n\\| `/reset-allowed-tools` | Redefina a lista de ferramentas permitidas. |\n\\| `/restart` | Reinicie a CLI, preservando a sessão atual. |\n\\| `/resume [SESSION-ID]`, `/continue [SESSION-ID]` | Alterne para uma sessão diferente escolhendo em uma lista (opcionalmente, especifique uma ID de sessão). |\n\\| `/review [PROMPT]` | Execute o agente de revisão de código para analisar as alterações. Consulte [Solicitando uma revisão de código com CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli/use-copilot-cli-agents/agentic-code-review). |\n\\| `/session [checkpoints [n]\\|files\\|plan\\|rename NAME]`, `/sessions [checkpoints [n]\\|files\\|plan\\|rename NAME]` | Mostrar informações de sessão e um resumo do workspace. Use os subcomandos para obter detalhes. |\n\\| `/share [file\\|html\\|gist] [session\\|research] [PATH]`, `/export [file\\|html\\|gist] [session\\|research] [PATH]` | Compartilhe a sessão em um arquivo Markdown, arquivo HTML interativo ou GitHub gist. |\n\\| `/skills [list\\|info\\|add\\|remove\\|reload] [ARGS...]` | Gerenciar habilidades para funcionalidades aprimoradas. Consulte [Adicionando habilidades de agente para CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli/customize-copilot/create-skills). |\n\\| `/statusline`, `/footer` | Configure quais itens aparecem na linha de status. |\n\\| `/tasks` | Exibir e gerenciar tarefas em segundo plano (subagentes e sessões de shell). |\n\\| `/terminal-setup` | Configure o terminal para suporte de entrada multilinha (Shift+Enter e Ctrl+Enter). |\n\\| `/theme [default\\|dim\\|high-contrast\\|colorblind]` | Exibir ou definir o modo de cor. |\n\\| `/undo`, `/rewind` | Refaça a última ação e reverta as alterações no arquivo. |\n\\| `/update`, `/upgrade` | Atualize a CLI para a versão mais recente. |\n\\| `/usage` | Exibir estatísticas e métricas de uso de sessão. |\n\\| `/user [show\\|list\\|switch]` | Gerencie o usuário atual GitHub . |\n\\| `/version` | Exibir informações de versão e verificar se há atualizações. |\n\nPara obter uma lista completa dos comandos slash disponíveis, insira `/help` na interface interativa da CLI.\n\n## Opções de linha de comando\n\n| Opção | Propósito |\n| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `--add-dir=PATH` | Adicione um diretório à lista de permissões para acesso a arquivos (pode ser usado várias vezes). |\n| `--add-github-mcp-tool=TOOL` | Adicione uma ferramenta para habilitar para o GitHub servidor MCP, em vez do subconjunto padrão da CLI (pode ser usado várias vezes). Use `*` para todas as ferramentas. |\n| `--add-github-mcp-toolset=TOOLSET` | Adicione um conjunto de ferramentas para habilitar para o GitHub servidor MCP, em vez do subconjunto padrão da CLI (pode ser usado várias vezes). Use `all` para todos os conjuntos de ferramentas. |\n| `--additional-mcp-config=JSON` | Adicione apenas um servidor MCP para esta sessão. A configuração do servidor pode ser fornecida como uma cadeia de caracteres JSON ou um caminho de arquivo (prefixo com `@`). Amplia a configuração de `~/.copilot/mcp-config.json`. Substitui qualquer configuração de servidor MCP instalada com o mesmo nome. Consulte [Adicionando servidores MCP para CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers). |\n| `--agent=AGENT` | Especifique um agente personalizado a ser usado. Consulte [Sobre agentes personalizados](/pt/copilot/concepts/agents/copilot-cli/about-custom-agents). |\n| `--allow-all` | Habilitar todas as permissões (equivalente a `--allow-all-tools --allow-all-paths --allow-all-urls`). |\n| `--allow-all-paths` | Desabilite a verificação do caminho do arquivo e permita o acesso a qualquer caminho. |\n| `--allow-all-tools` | Permitir que todas as ferramentas sejam executadas automaticamente sem confirmação. Necessário ao usar a CLI programaticamente (env: `COPILOT_ALLOW_ALL`). |\n| `--allow-all-urls` | Permitir acesso a todas as URLs sem confirmação. |\n| `--allow-tool=TOOL ...` | Ferramentas que a CLI tem permissão para usar. Não solicitará permissão. Para várias ferramentas, use uma lista entre aspas e separada por vírgulas. Consulte [Permitir e negar o uso da ferramenta](/pt/copilot/how-tos/copilot-cli/allowing-tools#allowing-or-denying-permission-for-specific-tools). |\n| `--allow-url=URL ...` | Permitir o acesso a URLs ou domínios específicos. Para várias URLs, use uma lista entre aspas e separada por vírgulas. |\n| `--autopilot` | Habilite a continuação do piloto automático no modo de prompt. Consulte [Permitindo que GitHub Copilot CLI funcione de forma autônoma](/pt/copilot/concepts/agents/copilot-cli/autopilot). |\n| `--available-tools=TOOL ...` | Somente essas ferramentas estarão disponíveis para o modelo. Para várias ferramentas, use uma lista entre aspas e separada por vírgulas. Consulte [Permitir e negar o uso da ferramenta](/pt/copilot/how-tos/copilot-cli/allowing-tools). |\n| `--banner`, `--no-banner` | Mostrar ou ocultar o banner de inicialização. |\n| `--bash-env` | Habilitar o suporte de `BASH_ENV` para shells bash. |\n| `--config-dir=PATH` | Defina o diretório de configuração (padrão: `~/.copilot`). |\n| `--connect[=SESSION-ID]` | Conecte-se diretamente a uma sessão remota (opcionalmente, especifique uma ID de sessão ou ID da tarefa). Conflitos com `--resume` e `--continue`. |\n| `--continue` | Retome a sessão mais recente. |\n| `--deny-tool=TOOL ...` | Ferramentas que a CLI não tem permissão para usar. Não solicitará permissão. Para várias ferramentas, use uma lista entre aspas e separada por vírgulas. |\n| `--deny-url=URL ...` | Negar acesso a URLs ou domínios específicos, tem precedência sobre `--allow-url`. Para várias URLs, use uma lista entre aspas e separada por vírgulas. |\n| `--disable-builtin-mcps` | Desabilitar todos os servidores MCP internos (atualmente: `github-mcp-server`). |\n| `--disable-mcp-server=SERVER-NAME` | Desabilite um servidor MCP específico (pode ser usado várias vezes). |\n| `--disallow-temp-dir` | Impedir o acesso automático ao diretório temporário do sistema. |\n| `--effort=LEVEL`, `--reasoning-effort=LEVEL` | Definir o nível de esforço de raciocínio (`low`, `medium`, ). `high` |\n| `--enable-all-github-mcp-tools` | Habilite todas as GitHub ferramentas do servidor MCP, em vez do subconjunto padrão da CLI. Substitui as opções `--add-github-mcp-toolset` e `--add-github-mcp-tool`. |\n| `--enable-reasoning-summaries` | Solicite resumos de raciocínio para modelos OpenAI que dão suporte a ele. |\n| `--excluded-tools=TOOL ...` | Essas ferramentas não estarão disponíveis para o modelo. Para várias ferramentas, use uma lista entre aspas e separada por vírgulas. |\n| `--experimental` | Habilitar recursos experimentais (use `--no-experimental` para desabilitar). |\n| `-h`, `--help` | Exibir ajuda. |\n| `-i PROMPT`, `--interactive=PROMPT` | Inicie uma sessão interativa e execute esse prompt automaticamente. |\n| `--log-dir=DIRECTORY` | Defina o diretório do arquivo de log (padrão: `~/.copilot/logs/`). |\n| `--log-level=LEVEL` | Defina o nível de log (opções: `none`, , , `error`, `warning`, `info`, , `debug`). `all``default` |\n| `--max-autopilot-continues=COUNT` | Número máximo de mensagens de continuação no modo de piloto automático (padrão: ilimitado). Consulte [Permitindo que GitHub Copilot CLI funcione de forma autônoma](/pt/copilot/concepts/agents/copilot-cli/autopilot). |\n| `--mode=MODE` | Defina o modo de agente inicial (opções: `interactive`, `plan`, ). `autopilot` Não é possível combinar com `--autopilot` ou `--plan`. |\n| `--model=MODEL` | Defina o modelo de IA que você deseja usar. Passe `auto` para permitir Copilot a escolha do melhor modelo disponível automaticamente. |\n| `--mouse[=VALUE]` | Habilite o suporte ao mouse no modo de tela alternativa. VALUE pode ser `on` (padrão) ou `off`. Quando habilitada, a CLI captura eventos do mouse no modo de tela alt — roda de rolagem, cliques etc. Quando desabilitado, o comportamento do mouse nativo do terminal é preservado. Depois de definir a configuração, ela será salva no arquivo de configuração. |\n| `--no-ask-user` | Desabilite a `ask_user` ferramenta (o agente funciona de forma autônoma sem fazer perguntas). |\n| `--no-auto-update` | Desabilite o download de atualizações da CLI automaticamente. |\n| `--no-bash-env` | Desative o suporte de `BASH_ENV` para shells bash. |\n| `--no-color` | Desative toda a saída de cor. |\n| `--no-custom-instructions` | Desabilite o carregamento de instruções personalizadas de `AGENTS.md` e arquivos relacionados. |\n| `--no-experimental` | Desabilitar recursos experimentais. |\n| `--no-mouse` | Desabilite o suporte ao mouse. |\n| `--no-remote` | Desabilite o acesso remoto para esta sessão. |\n| `--output-format=FORMAT` | FORMAT pode ser `text` (padrão) ou `json` (saídas JSONL: um objeto JSON por linha). |\n| `-p PROMPT`, `--prompt=PROMPT` | Execute um prompt programaticamente (sai após a conclusão). Consulte [Executando CLI do GitHub Copilot programaticamente](/pt/copilot/how-tos/copilot-cli/automate-copilot-cli/run-cli-programmatically). |\n| `--plan` | Inicie no modo plano. Abreviação de `--mode plan`. Não é possível combinar com `--mode` ou `--autopilot`. |\n| `--plain-diff` | Desative a renderização de diferenças avançadas (realce de sintaxe através da ferramenta de diff especificada na sua configuração do Git). |\n| `--plugin-dir=DIRECTORY` | Carregue um plug-in de um diretório local (pode ser usado várias vezes). |\n| `--remote` | Habilite o acesso remoto a esta sessão a partir de GitHub.com e GitHub Mobile. Consulte [Controlando uma CLI do GitHub Copilot sessão de outro dispositivo](/pt/copilot/how-tos/copilot-cli/steer-remotely). |\n| `--resume=SESSION-ID` | Retome uma sessão interativa anterior escolhendo em uma lista (opcionalmente, especifique uma ID de sessão ou um prefixo exclusivo de mais de 7 caracteres hexadecimais). |\n| `-s`, `--silent` | Gerar somente a resposta do agente (sem estatísticas de uso), útil para scripts com `-p`. |\n| `--screen-reader` | Habilitar otimizações de leitor de tela. |\n| `--secret-env-vars=VAR ...` | Redigir uma variável de ambiente do shell e do servidor MCP (pode ser usada várias vezes). Para várias variáveis, use uma lista entre aspas e separada por vírgulas. Os valores nas variáveis de ambiente `GITHUB_TOKEN` e `COPILOT_GITHUB_TOKEN` são omitidos do resultado por padrão. |\n| `--share=PATH` | Compartilhe uma sessão em um arquivo Markdown após a conclusão de uma sessão programática (caminho padrão: `./copilot-session-.md`). |\n| `--share-gist` | Compartilhe uma sessão em um gist secreto do GitHub após a conclusão de uma sessão programática. |\n| `--stream=MODE` | Habilitar ou desabilitar o modo de streaming (opções de modo: `on` ou `off`). |\n| `-v`, `--version` | Mostrar informações de versão. |\n| `--yolo` | Habilitar todas as permissões (equivalente a `--allow-all`). |\n\nPara obter uma lista completa de comandos e opções, execute `copilot help`.\n\n> \\[!NOTE]\n> As opções `--remote`, `--no-remote` e `--connect` exigem que o recurso de sessões remotas esteja disponível em sua conta.\n\n## Valores de disponibilidade da ferramenta\n\nAs opções `--available-tools` e `--excluded-tools` dão suporte a estes valores:\n\n### Ferramentas do Shell\n\n| Nome da ferramenta | Descrição |\n| --------------------------------- | --------------------------------------- |\n| `bash` / `powershell` | Executar comandos |\n| `read_bash` / `read_powershell` | Ler a saída de uma sessão de shell |\n| `write_bash` / `write_powershell` | Enviar entrada para uma sessão de shell |\n| `stop_bash` / `stop_powershell` | Encerrar uma sessão de shell |\n| `list_bash` / `list_powershell` | Listar sessões ativas do shell |\n\n### Ferramentas de operação de arquivo\n\n| Nome da ferramenta | Descrição |\n| ------------------ | --------------------------------------------------------------------- |\n| `view` | Ler arquivos ou diretórios |\n| `create` | Criar novos arquivos |\n| `edit` | Editar arquivos por meio da substituição de cadeia de caracteres |\n| `apply_patch` | Aplicar patches (usados por alguns modelos em vez de `edit`/`create`) |\n\n### Ferramentas de delegação de agente e tarefas\n\n| Nome da ferramenta | Descrição |\n| ------------------ | --------------------------------------------- |\n| `task` | Executar subagentes |\n| `read_agent` | Verificar o status do agente em segundo plano |\n| `list_agents` | Listar agentes disponíveis |\n\n### Outras ferramentas\n\n| Nome da ferramenta | Descrição |\n| ------------------ | ------------------------------------------------ |\n| `grep`(ou `rg`) | Pesquisar texto em arquivos |\n| `glob` | Localizar padrões de correspondência de arquivos |\n| `web_fetch` | Buscar e analisar o conteúdo da Web |\n| `skill` | Invocar habilidades personalizadas |\n| `ask_user` | Faça uma pergunta ao usuário |\n\n## Padrões de permissão de ferramenta\n\nAs opções `--allow-tool` e `--deny-tool` aceitam padrões de permissão no formato `Kind(argument)`. O argumento é opcional: omiti-lo corresponde a todas as ferramentas desse tipo.\n\n| Variante | Descrição | Padrões de exemplo |\n| -------- | ---------------------------- | ------------------ |\n| `shell` | Execução de comando do Shell | |\n\n```\n `shell(git push)`\n `shell(git:*)`\n `shell`\n |\n```\n\n\\| `write` | Criação ou modificação de arquivo |\n`write`, `write(src/*.ts)` |\n\\| `read` | Leituras de arquivo ou diretório |\n`read`, `read(.env)` |\n\\| SERVER-NAME | Invocação da ferramenta de servidor MCP |\n`MyMCP(create_issue)`, `MyMCP` |\n\\| `url` | Acesso à URL por meio de web-fetch ou shell |\n`url(github.com)`, `url(https://*.api.com)` |\n\\| `memory` | Armazenando fatos na memória do agente | `memory` |\n\nPara as `shell` regras, o sufixo `:*` corresponde ao comando principal seguido por um espaço, impedindo correspondências parciais. Por exemplo, `shell(git:*)` corresponde `git push` e `git pull` não corresponde `gitea`.\n\nAs regras de negação sempre têm precedência sobre as regras de permissão, mesmo quando `--allow-all` estão definidas.\n\n```shell\n# Allow all git commands except git push\ncopilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'\n\n# Allow a specific MCP server tool\ncopilot --allow-tool='MyMCP(create_issue)'\n\n# Allow all tools from a server\ncopilot --allow-tool='MyMCP'\n```\n\n## Variáveis de ambiente\n\n| Variable | Descrição |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `COPILOT_MODEL` | Defina o modelo de IA. |\n| `COPILOT_ALLOW_ALL` | Configure para `true` permitir todas as permissões automaticamente (equivalente a `--allow-all`). |\n| `COPILOT_AUTO_UPDATE` | Defina como `false` para desabilitar atualizações automáticas. |\n| `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | Lista separada por vírgulas de diretórios adicionais para instruções personalizadas. |\n| `COPILOT_SKILLS_DIRS` | Lista separada por vírgulas de diretórios adicionais para habilidades. |\n| `COPILOT_EDITOR` | Comando do editor para edição interativa (checado após `$VISUAL` e `$EDITOR`). Assume o valor padrão de `vi` se nenhum for definido. |\n| `COPILOT_GITHUB_TOKEN` | Token de autenticação. Tem precedência sobre `GH_TOKEN` e `GITHUB_TOKEN`. |\n| `COPILOT_HOME` | Sobrescreva a configuração e o diretório de estado. Padrão: `$HOME/.copilot`. |\n| `COPILOT_CACHE_HOME` | Substitua o diretório de cache (usado para caches do marketplace, pacotes de atualização automática e outros dados efêmeros). Consulte [Diretório de configuração do GitHub Copilot CLI](/pt/copilot/reference/copilot-cli-reference/cli-config-dir-reference#changing-the-location-of-the-configuration-directory) para ver os padrões da plataforma. |\n| `COPILOT_SUBAGENT_MAX_DEPTH` | Profundidade máxima de aninhamento de subagente. Padrão: `6`. Intervalo: `1`–`256`. |\n| `COPILOT_SUBAGENT_MAX_CONCURRENT` | Máximo de subagentes simultâneos em toda a árvore de sessão. Padrão: `32`. Intervalo: `1`–`256`. |\n| `GH_TOKEN` | Token de autenticação. Tem precedência sobre `GITHUB_TOKEN`. |\n| `GITHUB_TOKEN` | Token de autenticação. |\n| `USE_BUILTIN_RIPGREP` | Defina como `false` para usar o ripgrep do sistema em vez da versão agrupada. |\n| `PLAIN_DIFF` | Definir para `true` para desativar a renderização de diferenças avançadas. |\n| `COLORFGBG` | Fallback para detecção de plano de fundo do terminal escuro/claro. |\n\n## Configurações do arquivo de configuração\n\nAs configurações são aplicadas em cascata, do usuário para o repositório e depois para o local, com níveis mais específicos substituindo os mais gerais. Sinalizadores de linha de comando e variáveis de ambiente sempre têm a precedência mais alta.\n\n| Scope | Localidade | Propósito |\n| ----------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |\n| Usuário | `~/.copilot/config.json` | Padrões globais para todos os repositórios. Use a variável de `COPILOT_HOME` ambiente para especificar um caminho alternativo. |\n| Repositório | `.github/copilot/settings.json` | Configuração do repositório compartilhado (confirmada no repositório). |\n| Local | `.github/copilot/settings.local.json` | Substituições pessoais (adicione-as a `.gitignore`). |\n\n### Configurações do usuário (`~/.copilot/config.json`)\n\n| Chave | Tipo | Default | Descrição |\n| ------------- | ---------- | ------- | --------------------------------------------- |\n| `allowedUrls` | `string[]` | `[]` | URLs ou domínios permitidos sem solicitação. |\n| `autoUpdate` | `boolean` | `true` | Baixe automaticamente as atualizações da CLI. |\n| `banner` | | | |\n\n```\n `\"always\"`\n \\|\n `\"once\"`\n \\|\n `\"never\"`\n | `\"once\"` | Frequência de exibição de banner animado. |\n```\n\n\\| `bashEnv` | `boolean` | `false` | Habilitar o suporte de `BASH_ENV` para shells bash. |\n\\| `beep` | `boolean` | `true` | Reproduza um bipe audível quando a atenção é necessária. |\n\\| `compactPaste` | `boolean` | `true` | Compactar conteúdos grandes em tokens compactos. |\n\\| `custom_agents.default_local_only` | `boolean` | `false` | Use apenas agentes personalizados locais. |\n\\| `denied_urls` | `string[]` | `[]` | URLs ou domínios bloqueados (tem precedência sobre `allowed_urls`). |\n\\| `experimental` | `boolean` | `false` | Habilitar recursos experimentais. |\n\\| `includeCoAuthoredBy` | `boolean` | `true` | Adicione um trailer `Co-authored-by` às confirmações do git feitas pelo agente. |\n\\| `companyAnnouncements` | `string[]` | `[]` | Mensagens personalizadas mostradas aleatoriamente na inicialização. |\n\\| `logLevel` |\n`\"none\"`\n|\n`\"error\"`\n|\n`\"warning\"`\n|\n`\"info\"`\n|\n`\"debug\"`\n|\n`\"all\"`\n|\n`\"default\"`\n\\| `\"default\"` | Verbosidade de registro em log. |\n\\| `model` | `string` | varies | Modelo de IA a ser usado (consulte o `/model` comando). Defina para `\"auto\"` para que Copilot selecione automaticamente o melhor modelo disponível. |\n\\| `powershellFlags` | `string[]` | `[\"-NoProfile\", \"-NoLogo\"]` | Sinalizadores passados para o PowerShell (`pwsh`) na inicialização. Windows apenas. |\n\\| `effortLevel` | `string` | `\"medium\"` | Nível de esforço de raciocínio para o pensamento estendido (por exemplo, `\"low\"`, `\"medium\"`, `\"high\"`, `\"xhigh\"`). Níveis mais altos usam mais computação. |\n\\| `mergeStrategy` |\n`\"rebase\"`\n|\n`\"merge\"`\n\\| — | Estratégia de resolução de conflitos para `/pr fix conflicts`. Quando definido como `\"rebase\"`, os conflitos são resolvidos fazendo rebase para o branch base. Quando definido como `\"merge\"`, o ramo base é mesclado no ramo de funcionalidade. Se não estiver configurado, uma caixa de diálogo de seleção será mostrada. |\n\\| `renderMarkdown` | `boolean` | `true` | Renderizar Markdown na saída do terminal. |\n\\| `screenReader` | `boolean` | `false` | Habilitar otimizações de leitor de tela. |\n\\| `stream` | `boolean` | `true` | Habilitar respostas de streaming. |\n\\| `storeTokenPlaintext` | `boolean` | `false` | Armazene tokens de autenticação em texto sem formatação no arquivo de configuração quando nenhum conjunto de chaves do sistema estiver disponível. |\n\\| `streamerMode` | `boolean` | `false` | Ocultar os nomes de modelos de versão preliminar e detalhes de cotas (é útil ao demonstrar CLI do Copilot). |\n\\| `theme` |\n`\"auto\"`\n|\n`\"dark\"`\n|\n`\"light\"`\n\\| `\"auto\"` | Tema de cor do terminal. |\n\\| `mouse` | `boolean` | `true` | Habilite o suporte ao mouse no modo de tela alternativa. |\n\\| `respectGitignore` | `boolean` | `true` | Excluir os arquivos ignorados pelo git do `@` seletor de arquivos. |\n\\| `disableAllHooks` | `boolean` | `false` | Desabilite todos os ganchos. |\n\\| `hooks` | `object` | — | Definições de ganchos em linha no nível do usuário. |\n\\| `copyOnSelect` | `boolean` |\n`true` (macOS), `false` (outros) | Copie automaticamente o texto selecionado pelo mouse para a área de transferência do sistema no modo de tela alternativa. |\n\\| `statusLine` | `object` | — | Exibição da linha de status personalizada.\n`type`: deve ser `\"command\"`.\n`command`: caminho para um script que recebe JSON de sessão através do stdin e imprime o conteúdo de status para o stdout.\n`padding`: espaços opcionais de preenchimento esquerdo. |\n\\| `suppress_init_folders` | `string[]` | `[]` | Pastas em que a `/init` sugestão foi ignorada. Gerenciado automaticamente por `/init suppress`. |\n\\| `updateTerminalTitle` | `boolean` | `true` | Mostrar a intenção atual no título do terminal. |\n\n### Configurações do repositório (`.github/copilot/settings.json`)\n\nAs configurações do repositório se aplicam a todos que trabalham no repositório. Somente as chaves listadas na tabela a seguir têm suporte no nível do repositório. Todas as outras chaves, incluindo chaves válidas no arquivo de configuração do usuário, são ignoradas silenciosamente.\n\n| Chave | Tipo | Comportamento de mesclagem | Descrição |\n| ------------------------ | ------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |\n| `companyAnnouncements` | `string[]` | Substituído — o repositório assume precedência | Mensagens mostradas aleatoriamente na inicialização. |\n| `disableAllHooks` | `boolean` | Repositório tem precedência | Desabilite todos os ganchos. |\n| `enabledPlugins` | `Record` | Mesclado — o repositório tem prioridade sobre o usuário para a mesma chave | Instalação automática do plug-in declarativo. |\n| `extraKnownMarketplaces` | `Record` | Mesclado — o repositório tem prioridade sobre o usuário para a mesma chave | Marketplaces de plug-in disponíveis neste repositório. |\n| `hooks` | `object` | Concatenados — gatilhos do repositório são executados após os gatilhos do usuário | Definições de gancho destinadas a este repositório. Consulte a [referência de Hooks](#hooks-reference). |\n| `mergeStrategy` | | | |\n\n```\n `\"rebase\"`\n \\|\n `\"merge\"`\n | Repositório tem precedência | Estratégia de resolução de conflitos para `/pr fix conflicts`. |\n```\n\n### Configurações locais (`.github/copilot/settings.local.json`)\n\nCrie `.github/copilot/settings.local.json` no repositório para configurações pessoais que não devem ser confirmadas. Adicione este arquivo a `.gitignore`.\n\nO arquivo de configuração local usa o mesmo esquema que o arquivo de configuração do repositório (`.github/copilot/settings.json`) e tem precedência sobre ele.\n\n## inicialização do projeto Copilot\n\nQuando você usa o comando `copilot init` ou o comando barra `/init` em uma sessão interativa, Copilot analisa sua base de código e grava ou atualiza um arquivo `.github/copilot-instructions.md` no repositório. Este arquivo de instruções personalizado contém diretrizes específicas do projeto que melhorarão as sessões futuras da CLI.\n\nNormalmente, você usará `copilot init`, ou `/init`, quando iniciar um novo projeto ou quando começar a usar CLI do Copilot em um repositório existente.\n\nO `copilot-instructions.md` arquivo que é criado ou atualizado normalmente documenta:\n\n* Comandos de compilação, teste e lint.\n* Arquitetura de alto nível.\n* Convenções específicas do Codebase.\n\nSe o arquivo já existir, Copilot sugerirá melhorias que você pode optar por aplicar ou rejeitar.\n\nA CLI procura o `copilot-instructions.md` arquivo na inicialização e, se ele estiver ausente, ele exibirá a mensagem:\n\n>\n\n```\n 💡 Nenhuma instrução de co-piloto foi encontrada. Execute /init para gerar um arquivo copilot-instructions.md para este projeto.\n```\n\nSe você não quiser criar esse arquivo, poderá ocultar permanentemente essa mensagem de inicialização usando o `/init suppress` comando barra, que adiciona uma `suppress_init_folders` configuração para esse repositório ao arquivo Copilot de configuração.\n\nPara obter mais informações, consulte [Adicionando instruções personalizadas do repositório para GitHub Copilot](/pt/copilot/how-tos/configure-custom-instructions/add-repository-instructions).\n\n## Referência de ganchos\n\nGanchos são comandos externos que são executados em pontos de ciclo de vida específicos durante uma sessão, permitindo automação personalizada, controles de segurança e integrações. Os arquivos de configuração de gancho são carregados automaticamente a partir do `.github/hooks/*.json` em seu repositório.\n\n### Formato de configuração do gancho\n\nOs arquivos de configuração do gancho usam o formato JSON com a versão `1`.\n\n#### Ganchos de comando\n\nOs ganchos de comando executam scripts de shell e têm suporte em todos os tipos de gancho.\n\n```json\n{\n \"version\": 1,\n \"hooks\": {\n \"preToolUse\": [\n {\n \"type\": \"command\",\n \"bash\": \"your-bash-command\",\n \"powershell\": \"your-powershell-command\",\n \"cwd\": \"optional/working/directory\",\n \"env\": { \"VAR\": \"value\" },\n \"timeoutSec\": 30\n }\n ]\n }\n}\n```\n\n| Campo | Tipo | Obrigatório | Descrição |\n| ------------ | ----------- | -------------------------- | ---------------------------------------------------------------------------------- |\n| `type` | `\"command\"` | Sim | Deve ser `\"command\"`. |\n| `bash` | cadeia | Um dos `bash`/`powershell` | Comando shell para Unix. |\n| `powershell` | cadeia | Um dos `bash`/`powershell` | Comando shell para Windows. |\n| `cwd` | cadeia | No | Diretório de trabalho para o comando (relativo à raiz do repositório ou absoluto). |\n| `env` | objeto | No | Variáveis de ambiente a serem definidas (dá suporte à expansão variável). |\n| `timeoutSec` | número | No | Tempo limite em segundos. Padrão: `30`. |\n\n#### Ganchos de prompt\n\nPrompt hooks enviam automaticamente o texto como se o usuário tivesse digitado. Eles têm suporte apenas em `sessionStart` e são executados antes que qualquer prompt inicial seja passado via `--prompt`. O texto pode ser uma solicitação em linguagem natural ou um comando de barra.\n\n```json\n{\n \"version\": 1,\n \"hooks\": {\n \"sessionStart\": [\n {\n \"type\": \"prompt\",\n \"prompt\": \"Your prompt text or /slash-command\"\n }\n ]\n }\n}\n```\n\n| Campo | Tipo | Obrigatório | Descrição |\n| -------- | ---------- | ----------- | ---------------------------------------------------------------------------------------- |\n| `type` | `\"prompt\"` | Sim | Deve ser `\"prompt\"`. |\n| `prompt` | cadeia | Sim | O texto a ser enviado pode ser uma mensagem de linguagem natural ou um comando de barra. |\n\n### Eventos de gancho\n\n| Acontecimento | Acionado quando | A saída foi processada |\n| --------------------- | ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `sessionStart` | Uma sessão nova ou retomada começa. | No |\n| `sessionEnd` | A sessão é encerrada. | No |\n| `userPromptSubmitted` | O usuário envia um prompt. | No |\n| `preToolUse` | Antes de executar cada ferramenta. | Sim — pode permitir, negar ou modificar. |\n| `postToolUse` | Depois que cada ferramenta for executada com sucesso. | Sim, pode substituir o resultado bem-sucedido (somente ganchos programáticos do SDK). |\n| `postToolUseFailure` | Depois que uma ferramenta termina com falha. | Sim – pode fornecer diretrizes de recuperação por meio de `additionalContext` (código de saída `2` para hooks de comando). |\n| `agentStop` | O agente principal conclui um turno. | Sim – pode bloquear e forçar a continuação. |\n| `subagentStop` | Um subagente completa. | Sim – pode bloquear e forçar a continuação. |\n| `subagentStart` | Um subagente é gerado (antes de ser executado). Retorna `additionalContext` prefixado ao prompt do subagente. | |\n\n```\n `matcher` Dá suporte para filtrar pelo nome do agente. | Não — não é possível bloquear a criação. |\n```\n\n\\| `preCompact` | A compactação de contexto está prestes a começar (manual ou automática).\n`matcher` Dá suporte para filtrar por gatilho (`\"manual\"` ou `\"auto\"`). | Não — somente notificação. |\n\\| `permissionRequest` | Antes de mostrar uma caixa de diálogo de permissão para o usuário, após verificações baseadas em regra, não encontre nenhuma regra de permissão ou negação correspondente.\n`matcher` Dá suporte ao regex em `toolName`. | Sim – pode permitir ou negar programaticamente. |\n\\| `errorOccurred` | Ocorre um erro durante a execução. | No |\n\\| `notification` | É acionado de forma assíncrona quando a CLI emite uma notificação do sistema (conclusão do shell, conclusão do agente ou estado ocioso, prompts de permissão, caixas de diálogo para elicitação). Disparar e esquecer: nunca bloqueia a sessão.\n`matcher` Dá suporte ao regex em `notification_type`. | Opcional – pode injetar `additionalContext` na sessão. |\n\n### Cargas de entrada de evento do gancho\n\nCada evento de gancho fornece uma carga JSON para o manipulador de gancho. Há suporte para dois formatos de conteúdo, selecionados pelo nome do evento usado na configuração do gancho:\n\n* **formato camelCase** — Configure o nome do evento em camelCase (por exemplo, `sessionStart`). Os campos usam camelCase.\n\n***\n\n```\n VS Code Formato compatível** — configure o nome do evento em PascalCase (por exemplo, `SessionStart`). Os campos usam snake_case para corresponder ao formato de extensão VS CodeCopilot.\n```\n\n#### `sessionStart` / `SessionStart`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number; // Unix timestamp in milliseconds\n cwd: string;\n source: \"startup\" | \"resume\" | \"new\";\n initialPrompt?: string;\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\n```typescript\n{\n hook_event_name: \"SessionStart\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n source: \"startup\" | \"resume\" | \"new\";\n initial_prompt?: string;\n}\n```\n\n#### `sessionEnd` / `SessionEnd`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n reason: \"complete\" | \"error\" | \"abort\" | \"timeout\" | \"user_exit\";\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\n```typescript\n{\n hook_event_name: \"SessionEnd\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n reason: \"complete\" | \"error\" | \"abort\" | \"timeout\" | \"user_exit\";\n}\n```\n\n#### `userPromptSubmitted` / `UserPromptSubmit`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n prompt: string;\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\n```typescript\n{\n hook_event_name: \"UserPromptSubmit\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n prompt: string;\n}\n```\n\n#### `preToolUse` / `PreToolUse`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n toolName: string;\n toolArgs: unknown;\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\nQuando configurado com o nome do evento `PreToolUse` PascalCase, o conteúdo usa nomes de campo em snake\\_case para corresponder ao formato de extensão VS CodeCopilot.\n\n```typescript\n{\n hook_event_name: \"PreToolUse\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n tool_name: string;\n tool_input: unknown; // Tool arguments (parsed from JSON string when possible)\n}\n```\n\n#### `postToolUse` / `PostToolUse`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n toolName: string;\n toolArgs: unknown;\n toolResult: {\n resultType: \"success\";\n textResultForLlm: string;\n }\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\n```typescript\n{\n hook_event_name: \"PostToolUse\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n tool_name: string;\n tool_input: unknown;\n tool_result: {\n result_type: \"success\" | \"failure\" | \"denied\" | \"error\";\n text_result_for_llm: string;\n }\n}\n```\n\n#### `postToolUseFailure` / `PostToolUseFailure`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n toolName: string;\n toolArgs: unknown;\n error: string;\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\n```typescript\n{\n hook_event_name: \"PostToolUseFailure\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n tool_name: string;\n tool_input: unknown;\n error: string;\n}\n```\n\n#### `agentStop` / `Stop`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n transcriptPath: string;\n stopReason: \"end_turn\";\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\n```typescript\n{\n hook_event_name: \"Stop\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n transcript_path: string;\n stop_reason: \"end_turn\";\n}\n```\n\n#### `subagentStart`\n\n```\n **Entrada:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n transcriptPath: string;\n agentName: string;\n agentDisplayName?: string;\n agentDescription?: string;\n}\n```\n\n#### `subagentStop` / `SubagentStop`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n transcriptPath: string;\n agentName: string;\n agentDisplayName?: string;\n stopReason: \"end_turn\";\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\n```typescript\n{\n hook_event_name: \"SubagentStop\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n transcript_path: string;\n agent_name: string;\n agent_display_name?: string;\n stop_reason: \"end_turn\";\n}\n```\n\n#### `errorOccurred` / `ErrorOccurred`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n error: {\n message: string;\n name: string;\n stack?: string;\n };\n errorContext: \"model_call\" | \"tool_execution\" | \"system\" | \"user_input\";\n recoverable: boolean;\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\n```typescript\n{\n hook_event_name: \"ErrorOccurred\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n error: {\n message: string;\n name: string;\n stack?: string;\n };\n error_context: \"model_call\" | \"tool_execution\" | \"system\" | \"user_input\";\n recoverable: boolean;\n}\n```\n\n#### `preCompact` / `PreCompact`\n\n```\n **entrada camelCase:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n transcriptPath: string;\n trigger: \"manual\" | \"auto\";\n customInstructions: string;\n}\n```\n\n```\n **\n VS Code entrada compatível:**\n```\n\n```typescript\n{\n hook_event_name: \"PreCompact\";\n session_id: string;\n timestamp: string; // ISO 8601 timestamp\n cwd: string;\n transcript_path: string;\n trigger: \"manual\" | \"auto\";\n custom_instructions: string;\n}\n```\n\n###\n\n```\n `preToolUse` controle de decisão\n```\n\nO `preToolUse` gancho pode controlar a execução da ferramenta escrevendo um objeto JSON para stdout.\n\n| Campo | Valores | Descrição |\n| -------------------- | ------- | --------- |\n| `permissionDecision` | | |\n\n```\n `\"allow\"`\n `\"deny\"`\n `\"ask\"`\n | Se a ferramenta é executada. A saída vazia usa o comportamento padrão. |\n```\n\n\\| `permissionDecisionReason` | cadeia | Motivo mostrado ao agente. Obrigatório quando a decisão é `\"deny\"`. |\n\\| `modifiedArgs` | objeto | Substitua os argumentos da ferramenta para serem usados no lugar dos originais. |\n\n###\n\n```\n `agentStop`\n / \n `subagentStop` controle de decisão\n```\n\n| Campo | Valores | Descrição |\n| ---------- | ------- | --------- |\n| `decision` | | |\n\n```\n `\"block\"`, `\"allow\"` | \n `\"block\"` obriga outro agente a fazer um turno usando `reason` como prompt. |\n```\n\n\\| `reason` | cadeia | Solicite a próxima rodada quando `decision` for `\"block\"`. |\n\n###\n\n```\n `permissionRequest` controle de decisão\n```\n\nO `permissionRequest` gancho é acionado quando uma caixa de diálogo de permissão no nível da ferramenta está prestes a ser mostrada. Ele é acionado após verificações de permissão baseadas em regras não encontrarem nenhuma regra correspondente de \"permitir\" ou \"negar\". Use-o para aprovar ou negar chamadas de ferramentas de forma programática, especialmente útil no modo de pipe (`-p`) e em ambientes de CI onde nenhum prompt interativo está disponível.\n\n```\n **Matcher:** Regex opcional testado contra `toolName`. Quando definido, o gancho é acionado apenas para nomes de ferramentas correspondentes.\n```\n\nPara controlar a decisão de permissão, exibir JSON no stdout:\n\n| Campo | Valores | Descrição |\n| ---------- | ------- | --------- |\n| `behavior` | | |\n\n```\n `\"allow\"`, `\"deny\"` | Aprovar ou negar a chamada da ferramenta. |\n```\n\n\\| `message` | cadeia | Motivo para voltar à LLM ao negar. |\n\\| `interrupt` | boolean | Quando `true` é combinado com `\"deny\"`, interrompe totalmente o agente. |\n\nRetornar saída vazia ou `{}` para cair no comportamento padrão (mostrar a caixa de diálogo do usuário ou negar no modo pipe). O código `2` de saída é tratado como uma negação; se o gancho também gerar JSON no stdout, esses campos serão mesclados com a decisão de negação.\n\n### Gancho `notification`\n\nO `notification` gancho é acionado de forma assíncrona quando a CLI emite uma notificação do sistema. Esses ganchos são fire-and-forget: eles nunca bloqueiam a sessão, e quaisquer erros são registrados no log e ignorados.\n\n```\n **Entrada:**\n```\n\n```typescript\n{\n sessionId: string;\n timestamp: number;\n cwd: string;\n hook_event_name: \"Notification\";\n message: string; // Human-readable notification text\n title?: string; // Short title (e.g., \"Permission needed\", \"Shell completed\")\n notification_type: string; // One of the types listed below\n}\n```\n\n```\n **Tipos de notificação:**\n```\n\n| Tipo | Quando é acionado |\n| -------------------------- | ---------------------------------------------------------------------------------------------- |\n| `shell_completed` | Um comando de shell em segundo plano (assíncrono) termina |\n| `shell_detached_completed` | Uma sessão de shell desconectada é concluída |\n| `agent_completed` | Um subagente em execução em segundo plano é finalizado (completo ou com falha) |\n| `agent_idle` | Um agente em segundo plano conclui um ciclo e entra em modo inativo (aguardando `write_agent`) |\n| `permission_prompt` | O agente solicita permissão para executar uma ferramenta |\n| `elicitation_dialog` | O agente solicita informações adicionais do usuário |\n\n```\n **Saída:**\n```\n\n```typescript\n{\n additionalContext?: string; // Injected into the session as a user message\n}\n```\n\nSe `additionalContext` for retornado, o texto será injetado na sessão como uma mensagem de usuário prefixada. Isso pode disparar um processamento adicional do agente se a sessão estiver ociosa. Retornar `{}` ou esvaziar a saída para não executar nenhuma ação.\n\n```\n **Matcher:** Regex opcional em `notification_type`. O padrão é ancorado como `^(?:pattern)$`. Omita `matcher` para receber todos os tipos de notificação.\n```\n\n### Nomes de ferramentas para correspondência de ganchos\n\n| Nome da ferramenta | Descrição |\n| ------------------ | ------------------------------------ |\n| `bash` | Execute comandos de shell (Unix). |\n| `powershell` | Execute comandos de shell (Windows). |\n| `view` | Ler o conteúdo do arquivo. |\n| `edit` | Modificar o conteúdo do arquivo. |\n| `create` | Crie novos arquivos. |\n| `glob` | Localizar arquivos por padrão. |\n| `grep` | Pesquisar conteúdo do arquivo. |\n| `web_fetch` | Recuperar páginas da Web. |\n| `task` | Executar tarefas de subagente. |\n\nSe vários ganchos do mesmo tipo forem configurados, eles serão executados em ordem. Para `preToolUse`, se algum gancho retornar `\"deny\"`, a ferramenta será bloqueada. Para `postToolUseFailure` ganchos de comando, sair com código `2` faz com que stderr seja retornado como diretriz de recuperação para o assistente. As falhas de gancho (códigos de saída ou tempos limite diferentes de zero) são registradas e ignoradas, elas nunca bloqueiam a execução do agente.\n\n## Configuração do servidor MCP\n\nOs servidores MCP fornecem ferramentas adicionais para o agente da CLI. Configurar servidores persistentes em `~/.copilot/mcp-config.json`. Use `--additional-mcp-config` para adicionar servidores para uma única sessão.\n\n###\n\n```\n `copilot mcp` Subcomando\n```\n\nUse `copilot mcp` para gerenciar as configurações do servidor MCP da linha de comando sem iniciar uma sessão interativa.\n\n| Subcommand | Descrição |\n| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `list [--json]` | Listar todos os servidores MCP configurados agrupados por origem. |\n| `get [--json]` | Mostrar configuração e ferramentas para um servidor específico. |\n| `add ` | Adicione um servidor à configuração do usuário. Grava em `~/.copilot/mcp-config.json`. |\n| `remove ` | Remova um servidor no nível do usuário. Os servidores de espaço de trabalho devem ser editados diretamente em seus arquivos de configuração. |\n\n```\n **\n `copilot mcp add` Opções:**\n```\n\n| Opção | Descrição |\n| ------------------------ | -------------------------------------------------------------------------------------------- |\n| `-- [args...]` | Comandos e argumentos para servidores locais (stdio). |\n| `--url ` | URL para servidores remotos. |\n| `--type ` | Tipo de transporte: `local`, , `stdio`, `http`ou `sse`. |\n| `--env KEY=VALUE` | Variável de ambiente (repetível). |\n| `--header KEY=VALUE` | Cabeçalho HTTP para servidores remotos (repetível). |\n| `--tools ` | Filtro de ferramenta: `\"*\"` para todos, uma lista separada por vírgulas ou `\"\"` para nenhum. |\n| `--timeout ` | Tempo limite em milissegundos. |\n| `--json` | A saída adicionou a configuração como JSON. |\n| `--show-secrets` | Mostrar valores completos de variável de ambiente e cabeçalho. |\n| `--config-dir ` | Caminho para o diretório de configuração. |\n\n> \\[!CAUTION]\n\n```\n `--show-secrets` é capaz de imprimir valores confidenciais de variáveis de ambiente e de cabeçalho no seu terminal ou nos arquivos de log. Use essa opção apenas em ambientes confiáveis e evite copiar, colar ou capturar a saída em logs ou histórico compartilhados.\n```\n\n### Tipos de transporte\n\n| Tipo | Descrição | Campos obrigatórios |\n| ----------------- | ------------------------------------------------------- | ------------------- |\n| `local` / `stdio` | Processo local comunicando-se por meio de stdin/stdout. | |\n\n```\n `command`, `args` |\n```\n\n\\| `http` | Servidor remoto utilizando transporte HTTP transmissível. | `url` |\n\\| `sse` | Servidor remoto usando o transporte de eventos Server-Sent. | `url` |\n\n### Campos de configuração do servidor local\n\n| Campo | Obrigatório | Descrição |\n| --------- | ----------- | ------------------------------------------------------------------------------------------------ |\n| `command` | Sim | Comando para iniciar o servidor. |\n| `args` | Sim | Argumentos de comando (matriz). |\n| `tools` | Sim | Ferramentas para habilitar: `[\"*\"]` para todos ou uma lista de nomes de ferramentas específicos. |\n| `env` | No | Variáveis de ambiente. Dá suporte a `$VAR`, `${VAR}` e `${VAR:-default}` expansão. |\n| `cwd` | No | Diretório de trabalho para o servidor. |\n| `timeout` | No | Tempo limite de chamada de ferramenta em milissegundos. |\n| `type` | No | |\n\n```\n `\"local\"` ou `\"stdio\"`. Padrão: `\"local\"`. |\n```\n\n### Campos de configuração de servidor remoto\n\n| Campo | Obrigatório | Descrição |\n| ------ | ----------- | --------- |\n| `type` | Sim | |\n\n```\n `\"http\"` ou `\"sse\"`. |\n```\n\n\\| `url` | Sim | URL do servidor. |\n\\| `tools` | Sim | Ferramentas para habilitar. |\n\\| `headers` | No | Cabeçalhos HTTP. Dá suporte à expansão variável. |\n\\| `oauthClientId` | No | ID do cliente OAuth estático (ignora o registro dinâmico). |\n\\| `oauthPublicClient` | No | Se o cliente OAuth é público. Padrão: `true`. |\n\\| `oidc` | No | Habilitar a injeção de token OIDC. Quando `true`, injeta uma `GITHUB_COPILOT_OIDC_MCP_TOKEN` variável de ambiente (servidores locais) ou um `Bearer``Authorization` cabeçalho (servidores remotos). |\n\\| `timeout` | No | Tempo limite de chamada de ferramenta em milissegundos. |\n\n### Autenticação nova do OAuth\n\nServidores MCP remotos que usam OAuth podem mostrar um `needs-auth` status quando um token expira ou quando uma conta diferente é necessária. Use `/mcp auth ` para disparar um fluxo OAuth novo. Isso abre um prompt de autenticação do navegador, permitindo que você entre ou alterne contas. Depois de concluir o fluxo, o servidor se reconecta automaticamente.\n\n### Mapeamento de filtro\n\nControlar como a saída da ferramenta MCP é processada usando o `filterMapping` campo na configuração de um servidor.\n\n| Modo | Descrição |\n| ------------------- | ------------------------------------------------- |\n| `none` | Sem filtragem. |\n| `markdown` | Formatar saída como Markdown. |\n| `hidden_characters` | Remova caracteres ocultos ou de controle. Padrão. |\n\n### Servidores MCP internos\n\nA CLI inclui servidores MCP internos que estão disponíveis sem configuração adicional.\n\n| Servidor | Descrição |\n| ------------------- | --------- |\n| `github-mcp-server` | |\n\n```\n GitHub Integração de API: problemas, solicitações de pull, confirmações, pesquisa de código e GitHub Actions. |\n```\n\n\\| `playwright` | Automação do navegador: navegar, clicar, digitar, captura de tela e manipulação de formulários. |\n\\| `fetch` | Solicitações HTTP pela ferramenta `fetch`. |\n\\| `time` | Utilitários de tempo: `get_current_time` e `convert_time`. |\n\nUse `--disable-builtin-mcps` para desabilitar todos os servidores internos ou `--disable-mcp-server SERVER-NAME` desabilitar um específico.\n\n### Níveis de confiança do servidor MCP\n\nOs servidores MCP são carregados de várias fontes, cada uma com um nível de confiança diferente.\n\n| Fonte | Nível de confiança | Revisão necessária |\n| ------------------------------------------------------ | ------------------ | --------------------------- |\n| Interna | Alto | No |\n| Repositório (`.github/mcp.json`) | Medium | Recomendado |\n| Espaço de Trabalho (`.mcp.json`) | Medium | Recomendado |\n| Configuração do usuário (`~/.copilot/mcp-config.json`) | User-defined | Responsabilidade do usuário |\n| Servidores remotos | Baixo | Sempre |\n\nTodas as invocações da ferramenta MCP exigem permissão explícita. Isso se aplica até mesmo a operações somente leitura em serviços externos.\n\n### Lista de permissões do MCP da Empresa\n\n```\n GitHub Enterprise as organizações podem impor uma lista de permissões de servidores MCP permitidos. Quando ativa, a CLI avalia cada servidor não padrão em relação à política corporativa antes de se conectar.\n```\n\nQuando uma GitHub Enterprise política do Registro é detectada (ou o `MCP_ENTERPRISE_ALLOWLIST` sinalizador de recurso experimental está habilitado), a CLI:\n\n1. Calcula uma impressão digital para cada servidor não padrão configurado com base em seu comando, argumentos e URL remota.\n2. Envia as impressões digitais para o endpoint de avaliação da lista de permissão da empresa.\n3. Permite apenas servidores cujas impressões digitais são aprovadas; todos os outros são bloqueados com uma mensagem nomeando a empresa.\n\nEssa verificação é encerrada por falha: se o ponto de extremidade de avaliação não for acessível ou retornar um erro, os servidores não padrão serão bloqueados até que a política possa ser verificada.\n\nQuando um servidor é bloqueado por uma lista de permissões da empresa, a CLI exibe:\n\n```text\nMCP server \"SERVER-NAME\" was blocked by your enterprise \"ENTERPRISE-NAME\".\nContact your enterprise administrator to add this server to the allowlist.\n```\n\nOs servidores padrão internos são sempre isentos da imposição da lista de permissões.\n\n### Migrando de `.vscode/mcp.json`\n\nSe o projeto usar `.vscode/mcp.json` (formato de configuração MCP do VS Code), migre para `.mcp.json`CLI do GitHub Copilot. A migração mapeia novamente a `servers` chave para `mcpServers`.\n\n```\n **Conchas POSIX (bash, zsh, peixe e outros):**\n```\n\n```shell\njq '{mcpServers: .servers}' .vscode/mcp.json > .mcp.json\n```\n\nRequer [`jq`](https://jqlang.github.io/jq/).\n\n```\n **PowerShell**:\n```\n\n```powershell\npwsh -NoProfile -Command \"`$json = Get-Content '.vscode/mcp.json' -Raw | ConvertFrom-Json; `$content = ([pscustomobject]@{ mcpServers = `$json.servers } | ConvertTo-Json -Depth 100); [System.IO.File]::WriteAllText('.mcp.json', `$content, (New-Object System.Text.UTF8Encoding `$false))\"\n```\n\nEm Windows, substitua `pwsh` por `powershell` se estiver usando Windows PowerShell em vez do PowerShell Core.\n\n## Referência de habilidades\n\nAs habilidades são arquivos markdown que estendem o que a CLI pode fazer. Cada habilidade reside em seu próprio diretório que contém um `SKILL.md` arquivo. Quando invocado (via `/SKILL-NAME` ou automaticamente pelo agente), o conteúdo da habilidade é injetado na conversa.\n\n### Campos de frontmatter de habilidades\n\n| Campo | Tipo | Obrigatório | Descrição |\n| -------------------------- | --------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `name` | cadeia | Sim | Identificador exclusivo para a habilidade. Somente letras, números e hifens. Máximo de 64 caracteres. |\n| `description` | cadeia | Sim | O que a habilidade faz e quando usá-la. Máximo de 1024 caracteres. |\n| `allowed-tools` | cadeia de caracteres ou string\\[] | No | Lista separada por vírgulas ou matriz yaml de ferramentas que são automaticamente permitidas quando a habilidade está ativa. Use `\"*\"` para todas as ferramentas. |\n| `user-invocable` | boolean | No | Se os usuários podem invocar a habilidade com `/SKILL-NAME`. Padrão: `true`. |\n| `disable-model-invocation` | boolean | No | Impedir que o agente invoque automaticamente essa habilidade. Padrão: `false`. |\n\n### Localizações de habilidades\n\nAs habilidades são carregadas desses locais em ordem de prioridade (o primeiro encontrado vence para nomes duplicados).\n\n| Localidade | Scope | Descrição |\n| --------------------- | ------------- | ---------------------------------------------------------------------------------------------- |\n| `.github/skills/` | Projeto | Habilidades específicas de projeto. |\n| `.agents/skills/` | Projeto | Local alternativo do projeto. |\n| `.claude/skills/` | Projeto | Local compatível com Claude. |\n| Pai `.github/skills/` | Herdado | Suporte para diretório raiz do Monorepo. |\n| `~/.copilot/skills/` | Pessoal | Habilidades pessoais para todos os projetos. |\n| `~/.agents/skills/` | Pessoal | Habilidades de agente compartilhadas em todos os projetos. |\n| `~/.claude/skills/` | Pessoal | Localização pessoal compatível com o sistema Claude. |\n| Diretórios de plug-in | Plug-in | Habilidades de complementos instalados. |\n| `COPILOT_SKILLS_DIRS` | Personalizado | Diretórios adicionais (separados por vírgula). |\n| (agrupado com a CLI) | Interna | Habilidades enviadas com a CLI. Prioridade mais baixa , substituível por qualquer outra fonte. |\n\n### Comandos (formato de habilidade alternativa)\n\nOs comandos são uma alternativa às habilidades armazenadas como arquivos individuais `.md` em `.claude/commands/`. O nome do comando é derivado do nome do arquivo. Os arquivos de comando usam um formato simplificado (nenhum `name` campo necessário) e dão suporte `description`, `allowed-tools`e `disable-model-invocation`. Os comandos têm prioridade menor do que as habilidades com o mesmo nome.\n\n## Referência de agentes personalizados\n\nAgentes personalizados são agentes de IA especializados definidos em arquivos Markdown. O nome do arquivo (extensão menos) torna-se a ID do agente. Use `.agent.md` ou `.md` como a extensão de arquivo.\n\n### Agentes integrados\n\n| Agente | Modelo padrão | Descrição |\n| ----------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `code-review` | claude-sonnet-4.5 | Revisão de código com alta relação sinal/ruído. Analisa as diferenças em busca de bugs, problemas de segurança e erros lógicos. |\n| `rubber-duck` | modelo complementar | Use um modelo complementar para fornecer uma crítica construtiva de propostas, designs, implementações ou testes. Identifica pontos fracos e sugere melhorias. Disponível apenas no modo experimental. |\n| `explore` | claude-haiku-4.5 | Exploração rápida da base de código. Pesquisa arquivos, lê código e responde a perguntas. Retorna respostas focadas em menos de 300 palavras. Seguro para ser executado em paralelo. |\n| `general-purpose` | claude-sonnet-4.5 | Agente de funcionalidade completa para tarefas complexas de várias etapas. É executado em uma janela de contexto separada. |\n| `research` | claude-sonnet-4.6 | Agente de pesquisa profunda. Gera um relatório com base em informações em sua base de código, em repositórios relevantes e na Web. |\n| `task` | claude-haiku-4.5 | Execução de comandos (testes, compilações, lints). Retorna um breve resumo em caso de sucesso, saída completa em caso de falha. |\n\n### Campos de frontmatter personalizados do agente\n\n| Campo | Tipo | Obrigatório | Descrição |\n| ------------- | ----------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `description` | cadeia | Sim | Descrição mostrada na lista de agentes e na ferramenta `task`. |\n| `infer` | boolean | No | Permitir a delegação automática pelo agente principal. Padrão: `true`. |\n| `mcp-servers` | objeto | No | Servidores MCP para conectar. Usa o mesmo esquema que `~/.copilot/mcp-config.json`. |\n| `model` | cadeia | No | Modelo de IA para este agente. Quando não definido, herda o modelo do agente externo. Quando o modelo de sessão é definido `Auto` como (selecionado pelo servidor), os subagentes sempre herdam o modelo de sessão resolvido, independentemente desse campo. |\n| `name` | cadeia | No | Nome de exibição. O padrão é o nome do arquivo. |\n| `tools` | cadeia de caracteres\\[] | No | Ferramentas disponíveis para o agente. Padrão: `[\"*\"]` (todas as ferramentas). |\n\n### Locais do agente personalizado\n\n| Scope | Localidade |\n| ------- | ---------- |\n| Projeto | |\n\n```\n `.github/agents/` ou `.claude/agents/` |\n```\n\n\\| Usuário |\n`~/.copilot/agents/` ou `~/.claude/agents/` |\n\\| Plug-in | `/agents/` |\n\nAgentes em nível de projeto têm precedência sobre agentes em nível de usuário. Os agentes de plug-in têm a prioridade mais baixa.\n\n### Limites de subagente\n\nA CLI impõe limites de profundidade e simultaneidade para impedir a geração de agente fugitivo.\n\n| Limit | Default | Variável de ambiente |\n| ------------------- | ------- | --------------------------------- |\n| Profundidade máxima | `6` | `COPILOT_SUBAGENT_MAX_DEPTH` |\n| Máximo simultâneo | `32` | `COPILOT_SUBAGENT_MAX_CONCURRENT` |\n\n```\n **A profundidade** conta quantos agentes estão aninhados dentro um do outro. Quando o limite de profundidade é atingido, o agente mais interno não pode gerar subagentes adicionais. \n **Concorrência** conta quantos subagentes estão sendo executados simultaneamente em toda a árvore de sessão. Quando o limite é atingido, novas solicitações de subagente são rejeitadas até que um agente ativo finalize sua tarefa. Os valores são limitados entre `1` e `256`.\n```\n\n## Respostas de aprovação de permissão\n\nQuando a CLI solicita permissão para executar uma operação, você pode responder com as seguintes chaves.\n\n| Chave | Efeito |\n| ----- | --------------------------------------------------------------------- |\n| `y` | Permitir essa solicitação específica uma vez. |\n| `n` | Negar essa solicitação específica uma vez. |\n| `!` | Permitir todas as solicitações semelhantes para o restante da sessão. |\n| `#` | Negar todas as solicitações semelhantes para o restante da sessão. |\n| `?` | Mostrar informações detalhadas sobre a solicitação. |\n\nAs aprovações de sessão são redefinidas quando você executa `/clear` ou inicia uma nova sessão.\n\n## Monitoramento do OpenTelemetry\n\n```\n CLI do Copilot pode exportar rastreamentos e métricas por meio do [OpenTelemetry](https://opentelemetry.io/) (OTel), proporcionando visibilidade das interações do agente, chamadas LLM, execuções de ferramentas e uso de token. Todos os nomes de sinal e atributos seguem as [Convenções Semânticas do OTel GenAI](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/).\n```\n\nO OTel está desativado por padrão sem sobrecarga. Ele é ativado quando qualquer uma das seguintes condições é atendida:\n\n* `COPILOT_OTEL_ENABLED=true`\n* `OTEL_EXPORTER_OTLP_ENDPOINT` está definido\n* `COPILOT_OTEL_FILE_EXPORTER_PATH` está definido\n\n### Variáveis de ambiente OTel\n\n| Variable | Default | Descrição |\n| ---------------------------------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |\n| `COPILOT_OTEL_ENABLED` | `false` | Habilite explicitamente o OTel. Não é necessário se `OTEL_EXPORTER_OTLP_ENDPOINT` estiver definido. |\n| `OTEL_EXPORTER_OTLP_ENDPOINT` | — | URL do ponto de extremidade OTLP. Definir isso habilita automaticamente o OTel. |\n| `COPILOT_OTEL_EXPORTER_TYPE` | `otlp-http` | Tipo de exportador: `otlp-http` ou `file`. Seleciona automaticamente `file` quando `COPILOT_OTEL_FILE_EXPORTER_PATH` está definido. |\n| `OTEL_SERVICE_NAME` | `github-copilot` | Nome do serviço em atributos de recurso. |\n| `OTEL_RESOURCE_ATTRIBUTES` | — | Atributos de recursos extras como pares separados por vírgula `key=value` . Use a codificação por porcentagem para caracteres especiais. |\n| `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` | `false` | Capture o conteúdo completo do prompt e da resposta. Consulte [a captura de conteúdo](#content-capture). |\n| `OTEL_LOG_LEVEL` | — | Nível do log de diagnóstico OTel: `NONE`, `ERROR`, `WARN`, `INFO`, `DEBUG`, `VERBOSE`, `ALL`. |\n| `COPILOT_OTEL_FILE_EXPORTER_PATH` | — | Escreva todos os sinais neste arquivo como linhas JSON. Definir isso habilita automaticamente o OTel. |\n| `COPILOT_OTEL_SOURCE_NAME` | `github.copilot` | Nome do escopo de instrumentação para rastreador e medidor. |\n| `OTEL_EXPORTER_OTLP_HEADERS` | — | Cabeçalhos de autenticação para o exportador OTLP (por exemplo, `Authorization=Bearer token`). |\n\n### Vestígios\n\nO runtime emite uma árvore de intervalo hierárquica para cada interação do agente. Cada árvore contém um `invoke_agent` intervalo raiz, com `chat` e `execute_tool` intervalos filho.\n\n####\n\n```\n `invoke_agent` atributos de 'span'\n```\n\nEncapsula toda a invocação do agente: todas as chamadas LLM e execuções de ferramentas para uma mensagem de usuário.\n\n* **As sessões de nível superior** usam o tipo de abrangência `CLIENT` (invocação de serviço remoto) com `server.address` e `server.port`.\n* **Invocação de subagente** (por exemplo, explorar, tarefa) usa o tipo de span `INTERNAL` (em processo) sem atributos de servidor.\n\n| Attribute | Descrição | Tipo de intervalo |\n| -------------------------------- | --------------------------------------------- | ----------------- |\n| `gen_ai.operation.name` | `invoke_agent` | Ambas |\n| `gen_ai.provider.name` | Provedor (por exemplo, `github`, `anthropic`) | Ambas |\n| `gen_ai.agent.id` | Identificador de sessão | Ambas |\n| `gen_ai.agent.name` | Nome do agente (quando disponível) | Ambas |\n| `gen_ai.agent.description` | Descrição do agente (quando disponível) | Ambas |\n| `gen_ai.agent.version` | Versão de execução | Ambas |\n| `gen_ai.conversation.id` | Identificador de sessão | Ambas |\n| `gen_ai.request.model` | Modelo solicitado | Ambas |\n| `gen_ai.response.finish_reasons` | | |\n\n```\n `[\"stop\"]` ou `[\"error\"]` | Ambas |\n```\n\n\\| `gen_ai.usage.input_tokens` | Total de tokens de entrada (todas as voltas) | Ambas |\n\\| `gen_ai.usage.output_tokens` | Total de tokens de saída (todos os turnos) | Ambas |\n\\| `gen_ai.usage.cache_read.input_tokens` | Leitura de tokens de entrada armazenados em cache | Ambas |\n\\| `gen_ai.usage.cache_creation.input_tokens` | Tokens de entrada em cache criados | Ambas |\n\\| `github.copilot.turn_count` | Número de viagens de ida e volta de LLM | Ambas |\n\\| `github.copilot.cost` | Custo monetário | Ambas |\n\\| `github.copilot.aiu` | Unidades de IA consumidas | Ambas |\n\\| `server.address` | Nome do host do servidor |\n`CLIENT` somente |\n\\| `server.port` | Porta do servidor |\n`CLIENT` somente |\n\\| `error.type` | Nome da classe de erro (em caso de erro) | Ambas |\n\\| `gen_ai.input.messages` | Mensagens de entrada completas como JSON (somente captura de conteúdo) | Ambas |\n\\| `gen_ai.output.messages` | Mensagens de saída completas como JSON (somente captura de conteúdo) | Ambas |\n\\| `gen_ai.system_instructions` | Conteúdo da solicitação do sistema como JSON (captura de conteúdo somente) | Ambas |\n\\| `gen_ai.tool.definitions` | Esquemas de ferramentas como JSON (somente captura de conteúdo) | Ambas |\n\n####\n\n```\n `chat` atributos de 'span'\n```\n\nUm intervalo por solicitação LLM. Tipo de intervalo: `CLIENT`.\n\n| Attribute | Descrição |\n| ------------------------------------------ | ----------------------------------------------------------------------------- |\n| `gen_ai.operation.name` | `chat` |\n| `gen_ai.provider.name` | Nome do provedor |\n| `gen_ai.request.model` | Modelo solicitado |\n| `gen_ai.conversation.id` | Identificador de sessão |\n| `gen_ai.response.id` | ID de resposta |\n| `gen_ai.response.model` | Modelo resolvido |\n| `gen_ai.response.finish_reasons` | Razões de parada |\n| `gen_ai.usage.input_tokens` | Tokens de entrada desta vez |\n| `gen_ai.usage.output_tokens` | Tokens de saída neste turno |\n| `gen_ai.usage.cache_read.input_tokens` | Leitura de tokens armazenados em cache |\n| `gen_ai.usage.cache_creation.input_tokens` | Tokens em cache criados |\n| `github.copilot.cost` | Custo de turno |\n| `github.copilot.aiu` | As unidades de IA foram consumidas neste turno |\n| `github.copilot.server_duration` | Duração no lado do servidor |\n| `github.copilot.initiator` | Iniciador de solicitação |\n| `github.copilot.turn_id` | Identificador de turno |\n| `github.copilot.interaction_id` | Identificador de interação |\n| `github.copilot.time_to_first_chunk` | Tempo para a primeira parte de transmissão, em segundos (somente transmissão) |\n| `server.address` | Nome do host do servidor |\n| `server.port` | Porta do servidor |\n| `error.type` | Nome da classe de erro (em caso de erro) |\n| `gen_ai.input.messages` | Mensagens completas de prompt como JSON (captura de conteúdo apenas) |\n| `gen_ai.output.messages` | Mensagens de resposta completas como JSON (somente captura de conteúdo) |\n| `gen_ai.system_instructions` | Conteúdo da solicitação do sistema como JSON (captura de conteúdo somente) |\n\n####\n\n```\n `execute_tool` atributos de 'span'\n```\n\nUm intervalo por chamada de ferramenta. Tipo de intervalo: `INTERNAL`.\n\n| Attribute | Descrição |\n| ---------------------------- | -------------------------------------------------------------------------- |\n| `gen_ai.operation.name` | `execute_tool` |\n| `gen_ai.provider.name` | Nome do provedor (quando disponível) |\n| `gen_ai.tool.name` | Nome da ferramenta (por exemplo, `readFile`) |\n| `gen_ai.tool.type` | `function` |\n| `gen_ai.tool.call.id` | Identificador de chamada de ferramenta |\n| `gen_ai.tool.description` | Descrição da ferramenta |\n| `error.type` | Nome da classe de erro (em caso de erro) |\n| `gen_ai.tool.call.arguments` | Argumentos de entrada da ferramenta como JSON (apenas captura de conteúdo) |\n| `gen_ai.tool.call.result` | Saída da ferramenta como JSON (somente captura de conteúdo) |\n\n### Métricas\n\n#### Métricas de convenção do GenAI\n\n| Métrica | Tipo | Unidade | Descrição |\n| ----------------------------------------------- | ---------- | ------- | ----------------------------------------------------- |\n| `gen_ai.client.operation.duration` | Histograma | s | Duração da chamada à API LLM e da invocação do agente |\n| `gen_ai.client.token.usage` | Histograma | tokens | Contagens de token por tipo (`input`/`output`) |\n| `gen_ai.client.operation.time_to_first_chunk` | Histograma | s | Hora de receber a primeira parte de streaming |\n| `gen_ai.client.operation.time_per_output_chunk` | Histograma | s | Latência entre partes após a primeira parte |\n\n#### Métricas específicas do fornecedor\n\n| Métrica | Tipo | Unidade | Descrição |\n| ----------------------------------- | ---------- | -------- | ----------------------------------------------------------- |\n| `github.copilot.tool.call.count` | Contador | chamadas | Invocações de ferramenta por `gen_ai.tool.name` e `success` |\n| `github.copilot.tool.call.duration` | Histograma | s | Latência de execução da ferramenta por `gen_ai.tool.name` |\n| `github.copilot.agent.turn.count` | Histograma | turnos | Ciclos de ida e volta de LLM por chamada de agente |\n\n### Eventos com intervalo\n\nEventos de ciclo de vida registrados no intervalo ativo entre `chat` e `invoke_agent`.\n\n| Acontecimento | Descrição | Atributos de chave |\n| --------------------------- | --------------------------------- | ------------------ |\n| `github.copilot.hook.start` | Um gancho começou a ser executado | |\n\n```\n `github.copilot.hook.type`, `github.copilot.hook.invocation_id` |\n```\n\n\\| `github.copilot.hook.end` | O hook foi concluído com êxito |\n`github.copilot.hook.type`, `github.copilot.hook.invocation_id` |\n\\| `github.copilot.hook.error` | Falha em um gancho |\n`github.copilot.hook.type`\n`github.copilot.hook.invocation_id`\n`github.copilot.hook.error_message`\n|\n\\| `github.copilot.session.truncation` | O histórico de conversas foi truncado |\n`github.copilot.token_limit`, `github.copilot.pre_tokens`, `github.copilot.post_tokens`, `github.copilot.pre_messages`, `github.copilot.post_messages`, `github.copilot.tokens_removed`, , `github.copilot.messages_removed`, , `github.copilot.performed_by` |\n\\| `github.copilot.session.compaction_start` | Compactação de histórico iniciada | Nenhum |\n\\| `github.copilot.session.compaction_complete` | Compactação de histórico concluída |\n`github.copilot.success`, `github.copilot.pre_tokens`, `github.copilot.post_tokens`, `github.copilot.tokens_removed`, , `github.copilot.messages_removed``github.copilot.message`(somente captura de conteúdo) |\n\\| `github.copilot.skill.invoked` | Uma habilidade foi invocada |\n`github.copilot.skill.name`, `github.copilot.skill.path`, , `github.copilot.skill.plugin_name``github.copilot.skill.plugin_version` |\n\\| `github.copilot.session.shutdown` | A sessão está sendo fechada |\n`github.copilot.shutdown_type`, `github.copilot.total_premium_requests`, `github.copilot.lines_added`, , `github.copilot.lines_removed``github.copilot.files_modified_count` |\n\\| `github.copilot.session.abort` | O usuário cancelou a operação atual | `github.copilot.abort_reason` |\n\\| `exception` | Erro de sessão |\n`github.copilot.error_type`\n`github.copilot.error_status_code`\n`github.copilot.error_provider_call_id`\n|\n\n### Atributos de recursos\n\nTodos os sinais carregam esses atributos de recurso.\n\n| Attribute | Valor |\n| -------------- | ----- |\n| `service.name` | |\n\n```\n `github-copilot` (configurável via `OTEL_SERVICE_NAME`) |\n```\n\n\\| `service.version` | Versão de execução |\n\n### Captura de conteúdo\n\nPor padrão, nenhum conteúdo de prompt, respostas ou argumentos de ferramenta são capturados– somente metadados como nomes de modelo, contagens de token e durações. Para capturar o conteúdo completo, defina `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true`.\n\n> \\[!WARNING]\n> A captura de conteúdo pode incluir informações confidenciais, como código, conteúdo de arquivo e prompts do usuário. Habilite isso apenas em ambientes confiáveis.\n\nQuando a captura de conteúdo é habilitada, os atributos a seguir são preenchidos.\n\n| Attribute | Conteúdo |\n| ---------------------------- | -------------------------------------- |\n| `gen_ai.input.messages` | Mensagens de prompt completo (JSON) |\n| `gen_ai.output.messages` | Mensagens de resposta completas (JSON) |\n| `gen_ai.system_instructions` | Conteúdo do prompt do sistema (JSON) |\n| `gen_ai.tool.definitions` | Esquemas de ferramentas (JSON) |\n| `gen_ai.tool.call.arguments` | Argumentos de entrada da ferramenta |\n| `gen_ai.tool.call.result` | Saída da ferramenta |\n\n## Leitura adicional\n\n* [CLI do GitHub Copilot](/pt/copilot/how-tos/copilot-cli)\n* [referência de plugin da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-plugin-reference)\n* [referência programática do GitHub Copilot CLI](/pt/copilot/reference/copilot-cli-reference/cli-programmatic-reference)\n* [Diretório de configuração do GitHub Copilot CLI](/pt/copilot/reference/copilot-cli-reference/cli-config-dir-reference)"}