Revisar pull requests no GitHub pode consumir muito tempo, especialmente ao verificar estilo de código, erros de lógica ou casos extremos ausentes. O GitHub Copilot pode gerar sugestões de revisão diretamente no pull request, ajudando você a identificar problemas mais rápido sem trocar de ferramenta. Este artigo explica como habilitar e usar o Copilot para sugestões de revisão de pull requests, incluindo as permissões necessárias e o fluxo de trabalho. Você aprenderá as etapas exatas para obter comentários de revisão de código com IA em qualquer pull request.
Principais Conclusões: Usando o GitHub Copilot para Revisões de Pull Requests
- Configuração da revisão de pull request do GitHub Copilot: Ative as sugestões de revisão geradas por IA nas configurações do repositório ou da organização, em Copilot > Revisão de pull request.
- Gatilho da revisão do Copilot: Abra um pull request e clique na aba Copilot na conversa do pull request para ver os comentários sugeridos.
- Aceitação das sugestões de revisão: Cada sugestão inclui um botão Aceitar ou Dispensar para aplicar ou ignorar o comentário antes de publicar a revisão.
O que a Revisão de Pull Request do GitHub Copilot Faz
A revisão de pull request do GitHub Copilot é um recurso que gera automaticamente comentários de revisão de código em um pull request. Ele analisa as alterações de código no diff e sugere melhorias, possíveis bugs, problemas de estilo e testes ausentes. O recurso está disponível para os planos GitHub Copilot Enterprise e GitHub Copilot Business e funciona com repositórios hospedados no GitHub.com. Você deve ter permissões de administrador ou proprietário no repositório ou na organização para habilitar a configuração.
As sugestões de revisão aparecem como comentários na aba Copilot dentro da conversa do pull request. Cada sugestão é específica para uma linha ou um bloco de código alterado. Você pode aceitar, dispensar ou editar a sugestão antes de enviar sua revisão final. O Copilot não posta comentários automaticamente no pull request. Ele apenas fornece sugestões que você escolhe publicar.
Pré-requisitos
Antes de usar a revisão de pull request do Copilot, confirme o seguinte:
- Sua conta do GitHub tem uma assinatura do Copilot Enterprise ou Copilot Business.
- Você tem acesso de administrador ou proprietário ao repositório ou organização onde deseja habilitar o recurso.
- O repositório está hospedado no GitHub.com, não no GitHub Enterprise Server.
- A revisão de pull request do Copilot está habilitada nas configurações do repositório ou da organização.
Etapas para Habilitar e Usar a Revisão de Pull Request do GitHub Copilot
Siga estas etapas para ativar o recurso e começar a usar as sugestões de revisão do Copilot em seus pull requests.
- Habilite a revisão de pull request do Copilot nas configurações do repositório
Vá para o seu repositório no GitHub.com. Clique em Settings na barra de navegação superior. Na barra lateral esquerda, clique em Copilot. Em Revisão de pull request, marque a caixa Habilitar revisão de pull request do Copilot. Clique em Salvar. Se você gerencia uma organização, pode habilitar essa configuração para todos os repositórios em Configurações da organização > Copilot. - Crie ou abra um pull request
Crie um novo pull request ou abra um existente que tenha alterações. O Copilot analisa o diff automaticamente quando a configuração está habilitada. - Abra a aba Copilot na conversa do pull request
Na página do pull request, encontre as abas sob a área de conversa. Clique na aba Copilot. Essa aba aparece somente quando a revisão de pull request do Copilot está habilitada e o pull request tem alterações para revisar. - Revise os comentários sugeridos
O Copilot exibe uma lista de comentários sugeridos. Cada comentário mostra o nome do arquivo, o número da linha e o texto da sugestão. Leia cada sugestão com atenção. Algumas sugestões podem estar incorretas ou irrelevantes para o seu código. - Aceite ou dispense cada sugestão
Ao lado de cada sugestão, clique em Aceitar para incluir o comentário na sua revisão final. Clique em Dispensar para remover a sugestão. Você também pode editar o texto da sugestão antes de aceitar, clicando no ícone de edição. - Envie sua revisão
Depois de aceitar ou dispensar todas as sugestões, clique em Enviar revisão no topo da aba Copilot. Escolha um tipo de revisão: Comentar, Aprovar ou Solicitar alterações. Suas sugestões aceitas se tornam comentários no pull request.
Problemas Comuns e Limitações
Os seguintes problemas podem ocorrer ao usar a revisão de pull request do Copilot. Cada seção descreve a causa e a solução.
A Aba Copilot Não Aparece no Pull Request
Se a aba Copilot estiver ausente, o recurso pode não estar habilitado para o repositório. Verifique se você habilitou a revisão de pull request do Copilot nas configurações do repositório ou da organização. Confirme também se sua assinatura do Copilot está ativa. Se você estiver usando um plano Copilot Business, o proprietário da organização deve habilitar o recurso para toda a organização primeiro. A aba aparece somente quando o pull request tem pelo menos um arquivo alterado.
O Copilot Não Gera Sugestões
O Copilot pode não gerar sugestões se o pull request contiver apenas alterações menores, como espaços em branco ou comentários. O modelo de IA precisa de alterações de código significativas para produzir sugestões úteis. Se o diff for grande, o Copilot pode levar alguns segundos para gerar sugestões. Atualize a aba Copilot após 10 segundos se nenhuma sugestão aparecer. Se o problema persistir, verifique se a linguagem do repositório é uma das linguagens suportadas: Python, JavaScript, TypeScript, Ruby, Go, Java, C, C++ e C#.
Sugestões Irrelevantes ou Incorretas
As sugestões do Copilot são baseadas em padrões de código público e podem não corresponder ao estilo de codificação ou à lógica de negócios do seu projeto. Sempre revise cada sugestão antes de aceitar. Você pode dispensar sugestões incorretas sem afetar sua revisão. Com o tempo, o Copilot melhora suas sugestões à medida que aprende com o feedback aceito e dispensado, mas ainda requer julgamento humano.
| Item | Revisão de Pull Request do Copilot | Revisão de Código Manual |
|---|---|---|
| Velocidade | Gera sugestões em segundos | Pode levar horas para diffs grandes |
| Consciência de contexto | Limitada a padrões de código e conteúdo do diff | Entende objetivos do projeto e regras de negócio |
| Falsos positivos | Comuns, especialmente com código incomum | Raros, se o revisor conhece o código |
| Configuração necessária | Habilitar uma configuração no repositório ou organização | Nenhuma |
| Custo | Incluído com Copilot Enterprise ou Business | Gratuito, mas requer tempo do desenvolvedor |
A revisão de pull request do GitHub Copilot pode acelerar o processo de revisão, identificando problemas comuns antecipadamente. Habilite o recurso nas configurações do seu repositório e use a aba Copilot para revisar as sugestões antes de publicar seus comentários. Sempre combine as sugestões do Copilot com seu próprio julgamento para garantir que o código atenda aos padrões do seu projeto. Para melhores resultados, habilite o recurso em repositórios com pull requests ativos e linguagens suportadas.