Introdução
O GitHub Copilot pode revisar seu código e fornecer comentários. Sempre que possível, os comentários do Copilot incluem sugestões de alterações que você pode aplicar com alguns cliques.
O Copilot podem revisar o código escrito em qualquer linguagem de programação.
Este artigo fornece uma visão geral do Revisão de código do Copilot. Para obter instruções sobre como solicitar uma revisão 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
O Revisão de código do Copilot é, com uma exceção, um recurso Premium, disponível com os planos Copilot Pro, Copilot Pro+, Copilot Business e Copilot Enterprise.
A exceção é a revisão de uma seleção de código em um arquivo no Visual Studio Code. Esse é um recurso padrão disponível para todos os usuários do Copilot no VS Code.
Se você receber o Copilot de uma organização, para poder solicitar uma revisão da pull request do Copilot no GitHub.com ou no GitHub Mobile, a opção do Revisão de código do Copilot deve ser habilitada nas configurações de política do Copilot para a organização. Confira Gerenciar políticas e recursos do GitHub Copilot na sua organização.
Cota mensal de revisão de código
Quando você designa o Copilot como revisor de uma pull request ou quando você solicita ao Copilot para revisar todas as alterações não confirmadas em seu IDE, sua cota mensal de solicitações Premium do Copilot é reduzida em uma unidade. Para obter mais informações sobre solicitações Premium, confira Solicitações no GitHub Copilot.
Se um repositório estiver configurado para solicitar automaticamente uma revisão do Copilot para todas as novas pull requests, o uso da solicitação premium será aplicado à cota do autor da pull request. Se uma pull request for criada por GitHub Actions ou por um bot, o uso será aplicado ao usuário que disparou o fluxo de trabalho (se identificável) ou a um proprietário de cobrança designado.
Ao atingir sua cota mensal, você não poderá obter uma revisão do Copilot até que sua cota seja redefinida, a menos que você faça upgrade de seu plano do Copilot ou habilite solicitações premium adicionais.
Revisão de código do Copilot no Visual Studio Code
O Revisão de código do Copilot no Visual Studio Code dá suporte a dois tipos de revisão:
- Revisar seleção:
- Realce o código e solicite uma revisão inicial.
- Recurso Standard do Copilot. Nenhuma solicitação Premium usada.
- Não dá suporte a instruções personalizadas.
- Revisar alterações:
- Solicite uma revisão mais detalhada de todas as alterações não confirmadas.
- Recurso premium. Usa uma solicitação Premium de sua cota mensal por revisão.
- Dá suporte a instruções personalizadas.
Fornecer instruções para revisões de código do Copilot
Você pode personalizar as revisões que o Copilot gera fornecendo instruções personalizadas. Isso ajuda o Copilot a examinar o código de uma forma que corresponda aos padrões, às ferramentas e às práticas de codificação da sua equipe. Confira Como adicionar instruções personalizadas de repositório no GitHub Copilot e Como adicionar instruções personalizadas de organização no GitHub Copilot.
Validação de revisões do Copilot
Não há nenhuma garantia de que o Copilot detectará todos os problemas de uma pull request e, às vezes, ele cometerá erros. Sempre valide os comentários do Copilot com atenção e complemente os comentários do Copilot com uma revisão humana.
Para saber mais, confira Uso responsável da revisão de código do GitHub Copilot.
Sobre revisões automáticas de pull request
Por padrão, o Copilot somente revisará uma pull request quando ela for atribuída à pull request do mesmo modo que você atribuiria a um revisor humano. No entanto:
- Usuários individuais com o plano Copilot Pro ou Copilot Pro+ podem configurar o Copilot para revisar automaticamente todas as pull requests que criam.
- Os proprietários do repositório podem configurar o Copilot para revisar automaticamente todas as pull request no repositório que são criadas por pessoas com acesso ao Copilot.
- Os proprietários da organização podem configurar o Copilot para revisar automaticamente todas as pull requests em alguns ou todos os repositórios na organização em que a pull request é 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 definições da configuração:
- Configuração básica:
- Quando um pull request for criado como um pull request "Abrir".
- A primeira vez que um pull request "Rascunho" for alternado para "Abrir".
- Review new pushes:
- a revisão ocorre sempre que um novo commit é enviado por push para a pull request.
- Review draft pull requests:
- as pull requests são revisadas automaticamente enquanto ainda são rascunhos, antes de serem alternadas para "Abrir".
Observação
A menos que o Copilot tenha sido configurado para examinar cada envio por push para uma pull request, ele examinará a pull request apenas uma vez. Se você fizer alterações na pull request depois que ela tiver sido revisada automaticamente e quiser que o Copilot revise novamente a pull request, faça a solicitação manualmente. Para fazer isso, clique no botão ao lado do nome do Copilot no menu Revisores.
Limites de revisões automáticas de pull request
O Revisão de código do Copilot é um recurso premium com uma cota mensal por pessoa. Quando o Copilot realiza uma revisão automática, ele usa uma solicitação premium da cota do usuário que criou a pull request. Para saber mais, confira Como usar a revisão de código do GitHub Copilot.
Configurar revisões automáticas de pull request
Para obter detalhes de como configurar o Copilot para revisar automaticamente novas pull requests, consulte Configuração da revisão automática do Copilot.