GitHub Copilot oferece vários recursos de personalização que permitem adaptar seu comportamento ao fluxo de trabalho, aos padrões da sua equipe e às necessidades do projeto. Use as tabelas abaixo para encontrar a correta para seu caso de uso.
Visão geral do recurso
Esta tabela mostra o que é cada recurso de personalização e onde ele reside.
| Característica | O que é | Nome e local do arquivo |
|---|---|---|
| Instruções personalizadas | Contexto sempre ativo que se aplica automaticamente a cada interação dentro de seu escopo definido | .github/ (nível do repositório), .github/ (específico por caminho), AGENTS.md (agentes de terceiros) ou configurações pessoais/da organização via interface no GitHub |
| Arquivos de prompt | Modelo de prompt autônomo reutilizável com variáveis de entrada | .github/ |
| Agentes personalizados | Persona especializada com suas próprias instruções, restrições de ferramenta e contexto | .github/ (repositório), / no repositório .github ou .github-private da organização (nível da organização), / em um repositório designado .github-private (nível da empresa) ou no perfil do usuário |
| Subagents | Agente separado gerado pelo agente principal para lidar com o trabalho delegado em um contexto isolado | N/A (processo de runtime, não um arquivo configurado pelo usuário) |
| Habilidades do agente | Pasta de instruções, scripts e recursos que Copilot carrega quando for relevante para uma tarefa | .github/, .claude/ou .agents/ (projeto); ~/ ou ~/ (pessoal) |
| Ganchos | Comandos de shell personalizados que são executados deterministicamente em pontos específicos no fluxo de trabalho de um agente | .github/ |
| Protocolo MCP (Model Context Protocol) | Conexão com sistemas externos, APIs e bancos de dados | mcp.json (o caminho varia de acordo com o IDE), configurações de MCP do repositório em GitHub (aplica-se a Copilot in the cloud e Copilot code review), ou a propriedade mcp-servers nas configurações de custom agent |
Comparação de uso
Esta tabela ajuda você a decidir qual recurso de personalização usar.
| Característica | Como acionar | Mais adequado para | Exemplos de casos de uso |
|---|---|---|---|
| Instruções personalizadas | Automático | Padrões, diretrizes ou expectativas que se aplicam amplamente em um contexto | Impor padrões de codificação, regras de acessibilidade, listas de verificação de revisão |
| Arquivos de prompt | Manual: referenciar diretamente no chat ou usar o seletor de arquivos de prompt | Tarefas individuais focadas que você executa uma vez com entradas diferentes a cada vez | Gerar testes de unidade, executar uma lista de verificação de revisão de código |
| Agentes personalizados | Manual: selecione no menu suspenso de agentes na sua IDE, no GitHub ou no Copilot CLI | Projetos ou processos com estágios distintos que precisam de recursos especializados ou entregas estritas | Agente revisor do React, agente de auditoria em modo somente leitura |
| Subagents | Automático ou faça referência a um subagent diretamente no seu prompt | Subtarefas complexas que devem ser executadas isoladamente do agente principal | Pesquisa da base de código, executando suítes de testes |
| Habilidades do agente | Automático: será escolhido pelo Copilot quando for relevante para o seu prompt. | Fluxos de trabalho de várias etapas com ativos empacotados que devem ser carregados conforme necessário | GitHub Actions depuração de falhas, procedimentos de implantação, redação de nota de versão |
| Ganchos | Automático: em eventos de ciclo de vida configurados | Tarefas que precisam ser executadas em um ponto específico no ciclo de vida do agente, com execução garantida | Executar um formatador após cada edição de arquivo, aprovar ou negar execuções de ferramenta, evitar vazamentos de credenciais com secret scanning |
| Protocolo MCP (Model Context Protocol) | Automático ou peça uma ferramenta específica por nome | Tarefas que exigem acesso a ferramentas externas ou dados em tempo real | Gerenciar problemas e PRs (servidor MCP GitHub), automatizar o teste de navegador (servidor MCP Playwright) |
| Copilot conectores | Automático quando relevante ou solicite um serviço conectado | Tarefas que combinam o contexto do repositório com informações externas do projeto | Localizar requisitos em documentos conectados e, em seguida, propor alterações de código e testes |
Suporte a IDE e Surface
Esta tabela mostra quais recursos de personalização têm suporte em cada IDE e superfície. Para obter a matriz de recursos completa Copilot , consulte matriz de recursos Copilot.
GitHub recomenda usar a versão mais recente e estável do IDE Copilot CLI e da extensão Copilot para obter a melhor experiência Copilot.
Chave:
- ✓ = com suporte
- ✗ = sem suporte
- P = em versão prévia
| Característica | VS Code | Visual Studio | IDEs JetBrains | Eclipse | Xcode | GitHub .com | Copilot CLI | |---------|:-------:|:-------------:|:---------:|:-------:|:-----:|:-------:|:---:| | Instruções personalizadas | ✓ | ✓ | P | P | P | ✓ | ✓ | | Arquivos de prompt | ✓ | ✓ | P | ✗ | P | ✗ | ✗ | | Custom agents | ✓ | ✓ | P | P | P | ✓ | ✓ | | Subagents | ✓ | ✗ | P | P | P | ✗ | ✓ | | Habilidades do agente | ✓ | ✓ | P | ✗ | ✗ | ✓ | ✓ | | Ganchos | P | ✗ | ✗ | ✗ | ✗ | ✓ | ✓ | | Servidores MCP | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Os conectores estão em prévia pública no GitHub Copilot CLI, Visual Studio Code, Copilot in the cloud, GitHub Mobile e GitHub Copilot app. Em Copilot in the cloud, eles operam em sessões em execução em uma área restrita da nuvem, mas não em sessões em execução no GitHub Actions. Consulte Conectores do Copilot.
Para obter um detalhamento de quais tipos de instruções personalizadas têm suporte em cada IDE e superfície, consulte Suporte para diferentes tipos de instruções personalizadas.
Editor de Personalizações de Agente nos IDEs do JetBrains
Nos IDEs do JetBrains, você pode usar o editor de Personalizações do Agente para gerenciar várias Copilot personalizações de um só lugar. GitHub Copilot Chat No painel, clique no ícone de configurações no canto superior direito e clique em Personalizações.
A partir do editor, você pode:
- Exibir e editar custom agents
- Gerenciar habilidades reutilizáveis
- Configurar o workspace ou instruções pessoais
- Gerenciar arquivos de prompt
- Escolha personalizações de workspace para o projeto atual ou personalizações pessoais que o seguem entre projetos
Para obter etapas para criar instruções de repositório e arquivos de prompt em IDEs do JetBrains, consulte Adicionando instruções personalizadas de repositório para o GitHub Copilot em seu IDE.
Leitura adicional
- Biblioteca de personalização — uma coleção de exemplos curada