Introdução
Revisão de código do Copilot 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 Revisão de código do Copilot. Para saber como solicitar uma revisão de Copilotcódigo, consulte Usando o GitHub Copilot para revisão de código.
Disponibilidade
Revisão de código do Copilot há suporte em:
- GitHub.com
- GitHub CLI
- GitHub Mobile
- VS Code
- Visual Studio
- Xcode
- IDEs JetBrains
Observação
Se você receber Copilot de uma organização, sua organização deverá habilitar a opção Revisão de código do Copilot 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.
Revisão de código do Copilot sem uma Copilot licença
Os membros da organização sem uma Copilot licença podem usar Revisão de código do Copilot 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 Revisão de código do Copilot, 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 Revisão de código do CopilotAI credits.
- Permitir que membros sem licença Copilot usem Revisão de código do Copilot em GitHub.com. Essa sub-política habilita Revisão de código do Copilot 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. Revisão de código do Copilot só está disponível em repositórios em que você habilita 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 Revisão de código do Copilot 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.
Revisão de código do Copilot 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 Revisão de código do Copilot:
- 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, Revisão de código do Copilot não examinará o arquivo.
Para saber mais, confira Arquivos excluídos de GitHub Copilot revisão de código.
Recursos de agente para Revisão de código do Copilot
Observação
Revisão de código do Copilot tem recursos que estão dentro prévia pública e sujeitos a alterações. O Termos de licença de pré-lançamento do GitHub se aplica ao uso de recursos de visualização.
Revisão de código do Copilot 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 coleta completa de contexto do projeto está disponível em geral.
- A capacidade de passar sugestões para agente de nuvem Copilot. 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 agente de nuvem Copilot está em pré-visualização pública e sujeito a alterações.
Esses recursos são ativados automaticamente nos planos Copilot Pro, Copilot Pro+ e Copilot Max.
Se GitHub Actions estiver indisponível ou se os fluxos de trabalho de Ações usados por Revisão de código do Copilot 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.
Revisão de código do Copilot usa GitHub Actions para executar os recursos de agente, incluindo a coleta completa de contexto do projeto e quaisquer recursos em prévia pública. Por padrão, Revisão de código do Copilot usa corredores hospedados padrão GitHub. Você também pode atualizar para corredores hospedados maiores GitHubpara melhor desempenho ou usar corredores auto-hospedados.
Observação
O uso de maiores executores hospedados 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 Revisão de código do Copilot execuções. Para obter mais informações, consulte GitHub Actions a ata da revisão de código.
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 runners GitHub Actions para capacidades agênticas na revisão de código.
Se um repositório estiver configurado para solicitar automaticamente a Copilot revisão de código 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 Revisão de código do Copilot
Os usuários sem acesso a Revisão de código do Copilot 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 Gratuito, que não inclui Revisão de código do Copilot.
Quando Revisão de código do Copilot 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 Revisão de código do Copilot é 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 Revisão de código do Copilot 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 Bate-papo do Copilot.
Como Revisão de código do Copilot 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.
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 Uso responsável da revisão de código do Copilot GitHub.
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.
Memória Copilot (prévia pública)
Se você tiver um Copilot Pro, Copilot Pro+ou Copilot Max plano, poderá habilitar Memória Copilot. 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.
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 para todo o repositório
GitHub Copilot revisão de código revisa seu código em solicitações de pull e fornece comentários. Se você quiser comentários acionáveis sobre a confiabilidade e a manutenção de todo o repositório, habilite GitHub Code Quality. Confira Sobre a qualidade do código no GitHub.