Introdução

Revisão de código do Copilot revisa o código escrito em qualquer idioma e fornece feedback. 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 do Revisão de código do Copilot. Para saber como solicitar uma revisão de código do Copilot, consulte Como usar a revisão de código do GitHub Copilot.

Disponibilidade

A Revisão de código do Copilot é compatível com:

• GitHub.com
• GitHub Mobile
• VS Code
• Visual Studio.
• Xcode
• IDEs JetBrains

Revisão de código do Copilot é um recurso premium disponível com estes planos:

• Copilot Pro
• Copilot Pro+
• Copilot Business
• Copilot Enterprise

Confira os planos Copilot.

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 política do Copilot. Isso se aplica a avaliações em GitHub.com ou em GitHub Mobile. Confira Gerenciar políticas e recursos do GitHub Copilot na sua organização.

Revisão de código do Copilot sem uma licença Copilot

Membros da organização sem Copilot licenciamento podem usar Revisão de código do Copilot em 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 uma licença Copilot utilizem Revisão de código do Copilot, habilite duas políticas:

1.        **Solicitação premium por uso pago**. Habilite essa política primeiro. Ele permite que a empresa ou a organização incorra em custos para uso de requisição premium Revisão de código do Copilot.
   

2.        **Permitir que membros sem uma licença Copilot utilizem 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 ambas as políticas estão habilitadas, os usuários sem licenciamento Copilot podem solicitar uma revisão de Revisão de código do Copilot em solicitações de pull 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 licenciamento Copilot .

Revisão de código do Copilot para usuários sem licenciamento não está disponível nas IDEs.

Arquivos excluídos

Alguns tipos de arquivo são excluídos do 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 do Revisão de código do GitHub Copilot.

Ferramentas na revisão de código do Copilot

O Revisão de código do Copilot usa a coleta completa de contexto do projeto para fornecer revisões de código mais específicas, precisas e contextualmente cientes. Essa funcionalidade analisa todo o repositório para entender melhor o contexto das alterações de código. A coleta completa de contexto de projeto está geralmente disponível e habilitada automaticamente para planos Copilot Pro ou Copilot Pro+.

O Revisão de código do Copilot inclui ferramentas novas adicionais que estão em versão prévia pública:

•         **Suporte para ferramentas de análise estática, como CodeQL, ESLint e PMD**. Isso fornece descobertas mais consistentes e de alto sinal para segurança e qualidade.
  

•         **A capacidade de passar sugestões para Agente de codificação do Copilot**. Isso automatiza a criação de um nova solicitação de pull contra sua ramificação com as correções sugeridas aplicadas.
  

Essas ferramentas também são habilitadas automaticamente para os planos Copilot Pro ou Copilot Pro+.

Se você receber uma assinatura Copilot de uma organização, poderá participar somente do versão prévia pública no site do GitHub se um proprietário da sua organização ou empresa tiver ativado o uso de recursos de visualização prévia. Confira Gerenciar políticas e recursos do GitHub Copilot na sua organização e Gerenciar políticas e recursos do GitHub Copilot em sua empresa.

Você não precisa ter code scanning e GitHub Actions habilitados em sua organização ou empresa para usar o ferramentas na revisão de código do Copilot.

Se GitHub Actions não estiver disponível ou se os fluxos de trabalho do Actions usados por Revisão de código do Copilot falharem, a geração de avaliações ainda ocorrerá. No entanto, eles não incluirão os recursos adicionais fornecidos pelo ferramentas na revisão de código do Copilot.

Uso de executores GitHub Actions para ferramentas na revisão de código

Revisão de código do Copilot usa GitHub Actions para executar o ferramentas na revisão de código do Copilot, incluindo tanto a reunião completa do contexto do projeto quanto as ferramentas adicionais em versão prévia pública. Por padrão, Revisão de código do Copilot usa GitHub-hosted runners.

Se sua organização tiver desabilitado GitHub-hosted runners, o novo ferramentas na revisão de código do Copilot não estará disponível. Nesse caso, as revisões de código retornarão a uma revisão mais limitada.

Cota mensal de revisão de código

Sempre que o Copilot avalia uma solicitação de pull ou avalia o código no seu IDE, sua cota mensal de solicitações premium do Copilot é reduzida em uma.

Se um repositório estiver configurado para solicitar automaticamente uma avaliação de código de Copilot para todas as novas solicitações de pull, o uso da solicitação premium será aplicado à cota do autor da solicitação de pull.

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 você atinge sua cota

Ao atingir sua cota mensal, você não poderá obter uma avaliação de código de Copilot até que sua cota seja redefinida. Para continuar a usar revisões de código antes de redefinir a cota, você precisará atualizar seu plano Copilot ou habilitar solicitações premium adicionais.

Cota para usuários sem uma licença Copilot

Os usuários sem uma licença Copilot não têm uma cota de solicitação premium mensal. Quando Revisão de código do Copilot está habilitado para esses usuários, todas as solicitações premium que eles gerarem serão cobradas diretamente pela organização ou empresa como uso adicional pago. Isso se aplica a revisões solicitadas manualmente e revisões automáticas de código.

As solicitações Premium geradas por usuários sem licenciamento não são atribuídas a nenhuma Copilot cota de plano. Eles aparecem como uso excessivo em relatórios de cobrança e análise de solicitações premium. Os usuários com uma licença Copilot continuam consumindo solicitações premium da cota de plano atribuída.

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.

Validação de revisões do Copilot

Copilot não garante detectar todos os problemas em uma solicitação de pull. Às vezes comete erros. Sempre valide cuidadosamente o feedback de Copilot. Complete o feedback do Copilot com uma revisão humana.

Para saber mais, confira Uso responsável da revisão de código do GitHub Copilot.

Aprimorar o conhecimento do Copilot de um repositório

Quanto mais Copilot sabe sobre o código em seu repositório, as ferramentas que você usa e seus padrões e práticas de codificação, mais precisas e úteis suas revisões se tornarão. Você pode aumentar o conhecimento do Copilot de seus repositórios de duas formas.

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 no GitHub, também poderá definir instruções personalizadas nas configurações da sua organização. Para saber mais, confira Sobre como personalizar respostas do GitHub Copilot.

Memória copilot (versão prévia pública)

Se você tiver um Copilot Pro ou Copilot Pro+, poderá habilitar Memória copilot. Isso permite que Copilot armazene detalhes úteis que aprendeu sobre um repositório. Copilot pode usar essas informações quando avalia solicitações de pull nesse repositório. Para saber mais, confira Sobre a memória de agentes para o GitHub Copilot.

Sobre revisões automáticas de pull request

Por padrão, Copilot somente avaliará uma solicitação de pull se você atribuí-la à solicitação de pull. No entanto, você pode configurar revisões automáticas.

•         **Usuários individuais** no plano 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 o Copilot para revisar de forma automática todas as solicitações de pull no repositório que são criadas por pessoas com acesso ao Copilot.
  

•         **Os proprietários da organização** podem configurar o Copilot para avaliar de forma automática 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 usuário do Copilot.
  

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 Configurar a revisão automática do GitHub Copilot.

Obtendo comentários detalhados sobre a qualidade do código para todo o repositório

Revisão de código do GitHub Copilot revisa seu código em pull requests e fornece feedback. Se quiser feedback acionável sobre a confiabilidade e a manutenção do repositório inteiro, ative GitHub Code Quality. Confira Sobre a Qualidade do Código do GitHub.

Leitura adicional

•         [AUTOTITLE](/copilot/how-tos/agents/copilot-code-review/using-copilot-code-review)