Sobre a revisão de código do GitHub Copilot

Introdução

          Copilot revisão de código 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 revisão de código. Para saber como solicitar uma revisão de Copilotcódigo, consulte Usando o GitHub Copilot para revisão de código.

Disponibilidade

          Copilot revisão de código há suporte em:

• GitHub.com

• GitHub Mobile

• VS Code

• Visual Studio

• Xcode

• IDEs JetBrains

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

• Copilot Pro

• Copilot Pro+

• Copilot Business

• Copilot Enterprise

Veja Copilot os planos.

Se você receber Copilot de uma organização, sua organização deverá habilitar a opção Copilot revisão de código 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 revisão de código sem uma Copilot licença

Os membros da organização sem uma Copilot licença podem usar Copilot revisão de código 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 revisão de código, você deve habilitar duas políticas:

1.        **Solicitação premium por uso pago**. Habilite essa política primeiro. Permite que empresas ou organizações incorram em cobranças pelo uso de solicitações premium de Copilot revisão de código.
   

2.        **Permitir que membros sem licença Copilot usem Copilot revisão de código em GitHub.com**. Essa sub-política habilita Copilot revisão de código 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 revisão de código 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 Copilot revisão de código 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.

          Copilot revisão de código 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 revisão de código:

• 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 revisão de código não examinará o arquivo.

Para saber mais, confira Arquivos excluídos do GitHub Copilot revisão de código.

Recursos de agente para Copilot revisão de código

          Copilot revisão de código tem recursos que estão dentro versão prévia pública e sujeitos a alterações. O [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) se aplica ao uso de recursos de visualização.

          Copilot revisão de código 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 habilitados automaticamente para os planos Copilot Pro ou Copilot Pro+.

Se GitHub Actions estiver indisponível ou se os fluxos de trabalho de Ações usados por Copilot revisão de código 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 revisão de código utiliza minutos gratuitos para GitHub Actions executar os recursos de agente, incluindo a coleta completa do contexto do projeto e qualquer recurso adicional em versão prévia pública. Por padrão, Copilot revisão de código usa runners hospedados por GitHub. Também é possível atualizar para executores hospedados em GitHub maiores para obter melhor desempenho.

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 Configuring runners for GitHub Copilot code review.

Cota mensal de revisão de código

Cada vez que o Copilot revisa uma pull request ou código no seu IDE, sua cota mensal de solicitações premium Copilot é reduzida em uma.

Se um repositório estiver configurado para solicitar automaticamente uma revisão de código pelo Copilot para todas as novas pull requests, o uso de solicitação premium será aplicado à cota do autor da pull request. Se uma revisão for solicitada manualmente por outro usuário, o uso será descontado da quota desse 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 você atinge sua cota

Ao atingir sua cota mensal, não será possível obter novas revisões de código pelo Copilot até que a cota seja redefinida. Para continuar a usar revisões de código antes que sua cota seja redefinida, você precisará fazer upgrade no seu plano Copilot ou habilitar solicitações premium adicionais.

Usuários sem uma Copilot licença ou plano que inclua Copilot revisão de código

Os usuários sem acesso a Copilot revisão de código não têm uma cota de solicitação premium mensal. Isso inclui usuários que não têm Copilot licença e usuários no plano Copilot Gratuito, que não inclui Copilot revisão de código.

Quando Copilot revisão de código está habilitado para esses usuários, todas as solicitações premium geradas são cobradas diretamente para a organização ou empresa como uso excedente pago. Isso se aplica a revisões solicitadas manualmente e revisões automáticas de código.

As solicitações Premium geradas por esses usuários 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. Usuários com licença Copilot que inclui revisão de código continuam consumindo solicitações premium de sua cota do plano atribuído.

Uso do modelo

O Copilot revisão de código é 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.

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 (versão prévia pública)

Se você tiver um plano Copilot Pro ou Copilot Pro+, 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 memória agente para 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 Configuring automatic code review by GitHub Copilot.

          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 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-sync" aria-label="Re-request review" role="img"><path d="M1.705 8.005a.75.75 0 0 1 .834.656 5.5 5.5 0 0 0 9.592 2.97l-1.204-1.204a.25.25 0 0 1 .177-.427h3.646a.25.25 0 0 1 .25.25v3.646a.25.25 0 0 1-.427.177l-1.38-1.38A7.002 7.002 0 0 1 1.05 8.84a.75.75 0 0 1 .656-.834ZM8 2.5a5.487 5.487 0 0 0-4.131 1.869l1.204 1.204A.25.25 0 0 1 4.896 6H1.25A.25.25 0 0 1 1 5.75V2.104a.25.25 0 0 1 .427-.177l1.38 1.38A7.002 7.002 0 0 1 14.95 7.16a.75.75 0 0 1-1.49.178A5.5 5.5 0 0 0 8 2.5Z"></path></svg> 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 [AUTOTITLE](/code-security/code-quality/concepts/about-code-quality).

Leitura adicional

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