Introdução
Copilot code review revisa o código escrito em qualquer idioma e fornece comentários. Ele revisa seu código de vários ângulos para identificar problemas e sugerir correções. Você pode aplicar alterações sugeridas com alguns cliques.
Este artigo fornece uma visão geral de Copilot code review. Para saber como solicitar uma revisão de Copilotcódigo, consulte Usando o GitHub Copilot para revisão de código.
Disponibilidade
Copilot code review há suporte em:
- GitHub.com
- GitHub CLI
- GitHub Mobile
- VS Code
- Visual Studio
- Xcode
- IDEs JetBrains
- Azure DevOps (prévia pública)
Observação
Se você receber Copilot de uma organização, sua organização deverá habilitar a opção Copilot code review nas configurações de Copilot política. Isso se aplica a revisões em GitHub.com ou em GitHub Mobile. Confira Gerenciando políticas e recursos para GitHub Copilot em sua organização.
Copilot code review sem uma Copilot licença
Os membros da organização sem uma Copilot licença podem usar Copilot code review no GitHub.com. Um administrador corporativo ou proprietário da organização deve habilitá-lo. Essa funcionalidade está disponível para organizações nos planos Copilot Business e Copilot Enterprise.
Habilitando a revisão de código para usuários sem licença
Para permitir que membros da organização sem licença Copilot usem Copilot code review, você deve habilitar duas políticas:
- ** AI credits uso pago**. Habilite essa política primeiro. Isso permite que a empresa ou a organização tenha cobranças pelo uso de Copilot code reviewAI credits.
- Permitir que membros sem licença Copilot usem Copilot code review em GitHub.com. Essa sub-política habilita Copilot code review para usuários sem licença.
A segunda política tem estas características:
- Isso está desabilitado por padrão.
- Depois que essa política é definida no nível da empresa, ela se torna visível, mas não editável no nível da organização.
- A política é mais restritiva. Copilot code review só está disponível em repositórios de uma organização na qual você habilitou explicitamente a política.
Como funciona para usuários sem licença
Quando as duas políticas estão ativadas, usuários sem licença Copilot podem solicitar uma revisão de Copilot code review em suas pull requests nos repositórios da organização.
Em repositórios em que a revisão automática de código está habilitada, Copilot revisa automaticamente todas as solicitações de pull. Isso acontece independentemente de o autor ter uma Copilot licença. Para obter mais informações sobre como configurar a revisão automática de código, consulte Configurando a revisão automática de código GitHub Copilot.
Copilot code review para usuários sem licença não está disponível em IDEs.
Arquivos excluídos
Alguns tipos de arquivo são excluídos de Copilot code review:
- Arquivos de gerenciamento de dependência, como package.json e Gemfile.lock
- Arquivos de log
- Arquivos SVG
Se você incluir esses tipos de arquivo em uma solicitação de pull, Copilot code review não examinará o arquivo.
Para saber mais, confira Arquivos excluídos de GitHub Copilot code review.
Recursos de agente para Copilot code review
Copilot code review utiliza recursos agênticos para estender sua funcionalidade.
- Coleta de contexto de projeto completa. Isso fornece revisões de código mais específicas, precisas e contextualmente conscientes. Essa funcionalidade analisa todo o repositório para entender melhor o contexto das alterações de código.
- A capacidade de passar sugestões para Copilot cloud agent. Isso automatiza a criação de um nova solicitação de pull contra a sua ramificação com as correções sugeridas aplicadas. O envio de sugestões para Copilot cloud agent está em pré-visualização pública e sujeito a alterações.
Esses recursos são habilitados automaticamente para todos os planos que incluem Copilot code review. Consulte o nível de esforço de Revisão mais adiante neste artigo para obter informações sobre como escolher entre os níveis de análise Lite e Balanceado.
Se GitHub Actions estiver indisponível ou se os fluxos de trabalho de Ações usados por Copilot code review falhem, as revisões ainda serão geradas. No entanto, eles não incluirão os recursos adicionais fornecidos pelas capacidades agênticas.
Uso de executores GitHub Actions para recursos de agente na revisão de código.
Copilot code review usa GitHub Actions para executar as capacidades agênticas, incluindo a coleta de todo o contexto do projeto e o encaminhamento de sugestões para Copilot cloud agent. Por padrão, Copilot code review usa executores hospedados por GitHub padrão. Você também pode atualizar para executores hospedados por GitHub maiores para melhor desempenho ou usar executores auto-hospedados.
Observação
O uso de maiores executores hospedados por GitHub é cobrado a uma taxa por minuto mais alta. Os executores auto-hospedados não consomem GitHub Actions minutos.
Não é necessário que o GitHub Actions esteja habilitado em sua organização para usar os recursos de agente na revisão de código.
Se sua organização tiver desabilitado executores hospedados em GitHub, os recursos de agente não estarão disponíveis. Nesse caso, as revisões de código retornarão a uma revisão mais limitada. As organizações nessa situação podem usar executores auto-hospedados.
Para obter mais informações sobre como configurar executores, consulte Configurando executores para revisão de código do GitHub Copilot.
Você pode exibir os GitHub Actions minutos associados às execuções Copilot code review. Para obter mais informações, consulte GitHub Actions a ata da revisão de código.
Examinar o nível de esforço
Copilot code review dá suporte a vários níveis de esforço de revisão, para que você possa escolher o nível de profundidade que corresponde à criticidade do código.
- Lite: Revisão padrão. Fornece comentários rápidos e direcionados sobre problemas comuns, como bugs, vulnerabilidades de segurança e inconsistências de estilo (padrão).
- Equilibrado: direciona pull requests para um modelo com maior capacidade de raciocínio, para uma análise mais aprofundada de lógicas complexas, código sensível em termos de segurança e mudanças que afetam vários serviços. As revisões balanceadas usam mais AI credits e podem consumir marginalmente mais GitHub Actions minutos do que revisões Lite.
Use Balanceado para código sensível à segurança, solicitações pull de vários serviços ou repositórios com padrões de qualidade estritos. Use o Lite para alterações de rotina em que comentários rápidos são mais importantes do que análises exaustivas.
Você pode selecionar o nível de esforço de revisão ao solicitar uma revisão na solicitação de pull, na seção Revisores , em que Copilot aparece como um revisor. Os proprietários da organização podem definir um nível de esforço de revisão padrão para revisões automáticas de código em sua organização. Os administradores do repositório podem sobrescrever a configuração padrão da organização em um repositório específico.
Depois que Copilot code review analisa um pull request, o comentário de resumo do pull request mostra o nível de esforço usado em cada execução da revisão.
Consumo estimado
Uma revisão normalmente consome um valor estimado de US$ 0,05 a US$ 1 AI credits com esforço "Lite" e US$ 0,25 a US$ 5 AI credits com esforço "Balanceado".
O consumo geralmente aumenta com o tamanho do pull request e as instruções personalizadas do repositório, e as faixas podem mudar à medida que os modelos evoluem. Essas estimativas não incluem GitHub Actions minutos.
Os administradores do repositório e da organização podem definir o nível de esforço de revisão padrão para revisões automáticas de código. Para obter as etapas de configuração, consulte Configurando a revisão automática de código GitHub Copilot.
Uso de revisão de código
Cada vez que Copilot revisa uma solicitação de pull ou revisa o código em seu IDE, a interação consome AI credits. O valor depende do modelo usado e do número de tokens processados.
As revisões de código têm dois componentes de custo: AI credits para a interação com o modelo (a própria revisão) e GitHub Actions minutos para as capacidades agênticas (coleta de contexto e uso de ferramentas). Para obter mais informações sobre o uso de GitHub Actions, consulte Uso de executores GitHub Actions para capacidades baseadas em agentes na revisão de código.
Se um repositório estiver configurado para solicitar automaticamente a revisão de código de Copilot para todas as novas pull requests, o consumo de AI credits será atribuído ao autor da pull request. Se uma revisão for solicitada manualmente por outro usuário, o consumo será atribuído a esse usuário.
Se uma solicitação de pull for criada por GitHub Actions ou por um bot, o uso será aplicado a:
- O usuário que disparou o fluxo de trabalho, se esse usuário puder ser identificado.
- Um proprietário de cobrança designado.
O que acontece quando um orçamento é atingido
Para Copilot Business e Copilot Enterprise, o acesso de revisão de código é regido por controles de orçamento. Se um usuário atingir seu orçamento individual ou se o limite de gastos da empresa ou do centro de custos se esgotar, as revisões de código serão bloqueadas, juntamente com outros recursos que consomem AI credits. Confira Orçamentos para cobrança baseada em uso.
Usuários sem uma Copilot licença ou plano que inclua Copilot code review
Os usuários sem acesso a Copilot code review não têm uma franquia mensal de AI credits para isso. Isso inclui usuários que não têm Copilot licença e usuários no plano Copilot Free, que não inclui Copilot code review.
Quando Copilot code review está habilitado para esses usuários, quaisquer AI credits que eles consumirem são cobrados diretamente da organização ou corporação como uso adicional pago. Isso se aplica a revisões solicitadas manualmente e revisões automáticas de código.
AI credits consumidos por esses usuários não são atribuídos ao orçamento de qualquer usuário individual. Eles aparecem como uso adicional em relatórios de cobrança. Os usuários com uma licença Copilot que inclui revisão de código consomem AI credits do pool compartilhado, sujeitos aos orçamentos por usuário configurados por seu administrador.
Uso do modelo
O Copilot code review é um produto que usa uma combinação cuidadosamente ajustada de modelos, prompts e comportamentos do sistema para fornecer feedback consistente e de alta qualidade em uma ampla variedade de bases de código. Não há suporte para a alternância de modelos, pois alterar o modelo provavelmente comprometerá a confiabilidade, a experiência do usuário e a qualidade dos feedbacks de revisão.
Observação
O Copilot code review pode usar modelos que não estão habilitados na página de configurações "Models" da sua organização. A página de configurações "Modelos" controla apenas Copilot Chat.
Como Copilot code review está geralmente disponível, todo o uso do modelo estará sujeito aos termos geralmente disponíveis. Confira Gerenciando políticas e recursos para GitHub Copilot em sua organização.
Servidores MCP e habilidades de agente para revisão de código
Copilot code review pode usar habilidades de agente no nível do repositório e servidores MCP quando eles forem relevantes para a revisão.
Copilot code review tem mais probabilidade de usar habilidades e contexto MCP quando seu repositório ou pull request fornecem sinais claros, incluindo nomes de diretório de habilidades voltados para revisão, instruções personalizadas que fazem referência ao contexto MCP e descrições de pull request que incluem identificadores que remetem a servidores MCP configurados, como chaves de issue ou IDs de incidente.
Habilidades do agente
Se o seu repositório incluir habilidades de agente, Copilot code review poderá usar automaticamente habilidades relevantes ao revisar um pull request, ampliando os recursos de Copilot para além de sua análise integrada.
Ao examinar uma pull request, Copilot leia instruções personalizadas de repositório, instruções de agente e habilidades de agente da ramificação principal (a ramificação com as alterações), e não a ramificação base. Por exemplo, ao mesclar my-feature-branch em main, Copilot usa as instruções e habilidades em my-feature-branch, para que você possa testar alterações nelas no mesmo pull request sem mesclá-las primeiro.
Para obter detalhes de instalação, consulte Adicionando habilidades de agente para GitHub Copilot.
Servidores MCP
Copilot code review pode usar servidores MCP para extrair contexto diretamente para a revisão a partir das plataformas de terceiros e dos sistemas internos que sua equipe usa, incluindo rastreamento de issues, documentação, catálogos de serviços e ferramentas de gerenciamento de incidentes.
O GitHub servidor MCP e o servidor MCP do Dramaturgo são habilitados por padrão.
Você pode definir servidores MCP nas configurações do repositório. A configuração do MCP do repositório em GitHub se aplica tanto a Copilot cloud agent quanto a Copilot code review. As alterações feitas nas configurações do MCP do repositório afetam ambos os recursos. Para obter detalhes de instalação, consulte Configurar servidores MCP para seu repositório.
Nas configurações do repositório, Permitir que o Copilot use ferramentas MCP ao revisar pull requests está habilitada por padrão. Desabilite essa configuração se você quiser servidores MCP disponíveis apenas para Copilot cloud agent, e não para Copilot code review. Para obter instruções passo a passo, consulte Configurar servidores MCP para seu repositório.
Validando Copilot revisões de código
Copilot não garante detectar todos os problemas ou questões em um pull request. Às vezes comete erros. Sempre valide o feedback de Copilot com cuidado. Complementar o feedback de Copilot com uma revisão humana.
Para saber mais, confira Cartão de aplicativo: GitHub Copilot Agents.
Aprimorando o conhecimento de Copilot sobre um repositório
Quanto mais Copilot souber sobre o código em seu repositório, as ferramentas usadas e seus padrões e práticas de codificação, mais precisas e úteis serão suas revisões. Você pode aprimorar o conhecimento de Copilot sobre seus repositórios de duas maneiras.
Instruções personalizadas
Estas são instruções curtas em linguagem natural que você escreve e armazena como um ou mais arquivos em um repositório. Se você for o proprietário de uma organização GitHub, também poderá definir instruções personalizadas nas configurações da sua organização. Para saber mais, confira Sobre a personalização das respostas do GitHub Copilot.
Escolhendo entre instruções personalizadas, AGENTS.md e habilidades
Copilot code review pode se basear em várias fontes de personalização e cada uma tem uma finalidade diferente. Use as .github/copilot-instructions.md para regras para todo o repositório específicas do Copilot, use arquivos do *.instructions.md específicos de caminho nas .github/instructions/ para regras que se aplicam apenas a determinados arquivos ou diretórios, use AGENTS.md para regras permanentes que você deseja compartilhar entre ferramentas e agentes de IA e use habilidades para fluxos de trabalho específicos de tarefas que o Copilot executa sob demanda. A tabela a seguir resume quando usar cada um e como fornecer regras.
| Utilização | copilot-instructions.md |
*.instructions.md específicas para o caminho | AGENTS.md | Habilidades |
| --- | --- | --- | --- | --- |
| Melhor para | Regras sempre ativas em todo o repositório para Copilot | Regras sempre ativas para caminhos, tipos de arquivo ou diretórios específicos | Regras Always-on compartilhadas entre agentes de IA | Fluxos de trabalho de revisão para tarefas específicas |
| Armazenado em | .github/copilot-instructions.md | .github/instructions/**/*.instructions.md | Raiz do repositório (AGENTS.md) | .github/skills/... |
| Examples | Padrões de codificação, padrões de arquitetura, expectativas de teste |
content/** regras de escrita, src/** convenções de codificação, diretrizes específicas do idioma | Convenções de repositório compartilhado que devem ser aplicadas além Copilot | Avaliações, lançamentos, migrações, análise |
| Ativação | Automatic | Automático quando os arquivos alterados correspondem ao escopo de instrução | Automático (lido da raiz do repositório) | Automático quando relevante (por exemplo, habilidades focadas em revisão, como code-review), ou sob demanda |
| Scope | Para todo o repositório e especificamente para o Copilot | Subcaminhos do repositório e especificamente para o Copilot | Ferramenta cruzada/agente independente | Invocado por tarefa |
| Regra |
Copilot, sempre saiba disto sobre este repositório | "Copilot, sempre saiba disso ao trabalhar nesses caminhos" | "Qualquer agente, sempre saiba disso" | "Faça isso quando necessário" |
Para obter mais informações, consulte Adicionando habilidades de agente para GitHub Copilot e Adicionando instruções personalizadas do repositório para GitHub Copilot.
Copilot Memory (prévia pública)
Se você tiver um Copilot Pro, Copilot Pro+ou Copilot Max plano, poderá habilitar Copilot Memory. Isso permite Copilot armazenar detalhes úteis que aprendeu sobre um repositório. Copilot em seguida, pode usar essas informações ao examinar solicitações de pull nesse repositório. Para saber mais, confira Sobre a Memória do GitHub Copilot.
Sobre revisões automáticas de pull request
Por padrão, o Copilot revisa uma pull request apenas se for explicitamente atribuído a ela. No entanto, você pode configurar revisões automáticas.
- Usuários individuais nos planos Copilot Pro ou Copilot Pro+ podem configurar o Copilot para revisar automaticamente todas as pull requests que criarem.
- Os proprietários do repositório podem configurar Copilot para revisar automaticamente todas as solicitações de pull no repositório que são criadas por pessoas com acesso a Copilot.
- Os proprietários da organização podem configurar Copilot para revisar automaticamente todas as solicitações de pull em alguns ou todos os repositórios na organização em que a solicitação de pull é criada por um Copilot usuário.
Se sua organização tiver habilitado Copilot code review sem uma Copilot licença, as revisões automáticas também se aplicam a solicitações de pull criadas por membros da organização sem uma licença. Isso se aplica a repositórios cobertos por uma política em que as revisões automáticas estão habilitadas. Para obter mais informações, consulte Copilot code review sem a Copilot licença.
Disparo de uma revisão automática da solicitação de pull request
Os gatilhos para revisão automática de código dependem das configurações.
- Configuração básica:
- Quando você cria uma solicitação de pull como uma solicitação "aberta".
- Na primeira vez que você alternar uma solicitação de pull "Rascunho" para "Abrir".
- Revise os novos envios:
- Toda vez que você envia um novo commit para o pull request.
- Examinar pull requests em rascunho:
- As solicitações de pull são avaliadas automaticamente enquanto ainda são rascunhos, antes de você alterná-las para "Abrir".
Para obter instruções completas, consulte Configurando a revisão automática de código GitHub Copilot.
Observação
Copilot A menos que tenha sido configurado para examinar cada push para uma solicitação de pull, ele examinará apenas uma solicitação de pull uma vez. Se você fizer alterações na solicitação de pull depois que ela tiver sido revisada automaticamente e desejar Copilot revisá-la novamente, você poderá solicitar isso manualmente. Clique no botão ao lado do nome de Copilot no menu Revisores.
Obtendo comentários detalhados sobre a qualidade do código em seu repositório
GitHub Copilot code review examina as alterações em uma solicitação de pull e sugere correções. Para adicionar feedback sistemático sobre a confiabilidade e a capacidade de manutenção do código em pull requests e na ramificação padrão, habilite GitHub Code Quality.
GitHub Code Quality complementa Copilot code review adicionando:
- Análise baseada em CodeQLregras baseada em solicitações de pull e em seu branch padrão.
- Métricas de cobertura de teste em solicitações de pull, para que você possa ver se uma alteração mantém ou reduz a cobertura.
- Correções com um clique, potencializadas por Copilot, incluindo delegar a remediação para Copilot cloud agent.
- Bloqueio de mesclagem opcional com conjuntos de regras, de maneira que pull requests com resultados baseados em regras não resolvidos (ou que não atinjam um limite de cobertura) possam ter a mesclagem bloqueada.
Para saber mais, confira Qualidade do Código do GitHub.