Comentários de Revisão de Código do GitHub Copilot Ausentes: Corrigir

Quando você espera que o GitHub Copilot sugira melhorias durante uma revisão de pull request, mas não vê comentários inline, o processo de revisão para. Isso geralmente acontece porque o recurso de revisão de código do Copilot requer permissões específicas, um tipo de arquivo suportado ou um repositório GitHub configurado corretamente. A causa subjacente geralmente é uma licença do GitHub Copilot ausente ou expirada atribuída ao revisor, ou uma configuração do repositório que impede o Copilot de escrever comentários. Este artigo explica por que os comentários de revisão do Copilot não aparecem e fornece as etapas exatas para restaurá-los.

Por que os Comentários de Revisão de Código do GitHub Copilot Não Aparecem

O GitHub Copilot pode gerar comentários de revisão de código apenas quando o revisor possui uma licença válida do Copilot Enterprise ou Copilot Business. O recurso não está disponível nos planos Copilot Individual. Mesmo com uma licença adequada, o proprietário da organização deve habilitar a política de revisão de código nas configurações do Copilot. Se a política estiver desativada, o Copilot não publicará comentários em pull requests. Além disso, regras de proteção de branch que exigem um número específico de revisores ou que bloqueiam comentários de bots podem impedir o Copilot de escrever suas sugestões. O revisor deve ter acesso de escrita ou manutenção ao repositório para que o Copilot deixe comentários. Se alguma dessas condições não for atendida, os comentários de revisão estarão ausentes.

Tipo de Licença e Disponibilidade do Recurso

O Copilot Individual não inclui recursos de revisão de código. Apenas os planos Copilot Business e Copilot Enterprise suportam comentários de revisão automatizados. O revisor deve ter um assento atribuído em um desses planos. Se o revisor tiver uma licença Business ou Enterprise, mas os comentários ainda estiverem ausentes, o problema provavelmente é uma política ou configuração de permissão.

Políticas da Organização e do Repositório

O proprietário da organização do GitHub deve habilitar a política de revisão de código na seção Copilot das configurações da organização. Essa política controla se o Copilot pode publicar comentários em pull requests em todos os repositórios da organização. Se a política estiver desabilitada, nenhum comentário de revisão do Copilot aparecerá. Mesmo quando habilitada, as configurações individuais do repositório podem substituir a política da organização se as regras de proteção de branch bloquearem comentários de usuários automatizados.

Etapas para Corrigir Comentários de Revisão de Código do GitHub Copilot Ausentes

Siga estas etapas em ordem. Teste após cada etapa abrindo um novo pull request ou atualizando um existente para ver se os comentários aparecem.

1. Verifique a atribuição da licença do Copilot para o revisor
   Faça login no GitHub como proprietário da organização. Vá para Settings > Organization > Copilot. Em Seat management, confirme que a conta do revisor está listada com um plano Business ou Enterprise. Se o revisor não estiver atribuído, clique em Add seats e insira o nome de usuário. Salve a alteração. O revisor deve sair e entrar novamente para ativar a licença.
2. Habilite a política de revisão de código no nível da organização
   Na mesma página de configurações do Copilot, encontre a seção Policies. Localize Code review e defina como Enabled. Clique em Save. Isso permite que o Copilot publique comentários em pull requests em todos os repositórios. Se quiser restringir a repositórios específicos, use a lista de permissões de repositório abaixo da alternância de política.
3. Verifique as regras de proteção de branch do repositório
   Vá para o repositório onde o pull request está aberto. Navegue até Settings > Branches > Branch protection rules. Edite a regra para o branch de destino. Em Rules applied to everyone including administrators, certifique-se de que Require pull request reviews before merging não esteja definido para um número maior que zero se você quiser que os comentários do Copilot contem. Além disso, desmarque Dismiss stale pull request approvals when new commits are pushed se quiser que os comentários do Copilot persistam após atualizações. Salve a regra.
4. Confirme que o revisor tem acesso de escrita ao repositório
   No repositório, vá para Settings > Collaborators and teams. Verifique se a conta do revisor tem a função Write ou Maintain. Se a função for Read, o Copilot não pode publicar comentários. Altere a função para Write e salve.
5. Crie um novo pull request para acionar a revisão
   Abra um novo pull request com pelo menos uma alteração de arquivo. O Copilot revisa apenas pull requests que modificam arquivos de código. Após abrir o pull request, aguarde até 30 segundos para o Copilot gerar comentários. Atualize a página se os comentários não aparecerem. Se os comentários ainda não aparecerem, repita as etapas 1 a 4 para garantir que nenhuma configuração foi perdida.

Se o Copilot Ainda Tiver Problemas Após a Correção Principal

Alguns problemas exigem solução de problemas adicional além das configurações principais.

Comentários de Revisão do Copilot Aparecem Apenas em Alguns Pull Requests

O Copilot não revisa pull requests que contenham apenas arquivos não relacionados a código, como imagens, PDFs ou arquivos de texto simples. Ele também ignora pull requests com mais de 500 linhas de alterações. Para testar, crie um pequeno pull request que modifique um único arquivo de código. Se os comentários aparecerem nesse pull request, mas não em outros, o tipo de arquivo ou o limite de tamanho é a causa.

Comentários do Copilot São Rejeitados por Revisores Obrigatórios

Se seu repositório usa revisores obrigatórios, os comentários do Copilot podem ser descartados ou ocultados. Para corrigir, vá para Settings > Branches > Branch protection rules do repositório. Edite a regra e desmarque Require review from Code Owners. Alternativamente, adicione o usuário do Copilot como um code owner no arquivo CODEOWNERS. Isso dá aos comentários do Copilot o mesmo peso que os comentários de revisores humanos.

Comentários de Revisão do Copilot Não Aparecem na Guia Conversation

O Copilot publica seus comentários na guia Files changed do pull request. Verifique especificamente essa guia. Se os comentários estiverem lá, mas não visíveis na guia Conversation, isso é comportamento normal. O Copilot não publica comentários de resumo no thread principal da conversa. Você pode ver todas as sugestões do Copilot apenas na visualização diff.

Item	Copilot Business	Copilot Enterprise
Comentários de revisão de código	Sim	Sim
Instruções de revisão personalizadas	Não	Sim
Bases de conhecimento para revisão	Não	Sim
Custo da licença por usuário por mês	$19	$39

Se os comentários de revisão do Copilot ainda estiverem ausentes após todas essas etapas, abra um ticket de suporte com o GitHub. Inclua a URL do pull request e uma captura de tela da página de configurações do Copilot. A equipe de suporte pode verificar logs do lado do servidor para encontrar solicitações bloqueadas.

Agora você pode restaurar comentários de revisão de código ausentes do Copilot verificando a licença, habilitando a política da organização e ajustando as regras de proteção de branch. Após aplicar essas alterações, teste com um pequeno pull request para confirmar que a correção funciona. Para confiabilidade contínua, revise periodicamente as atribuições de assentos do Copilot nas configurações da sua organização para garantir que nenhum assento expire. Como etapa avançada, considere usar o Copilot Enterprise com instruções de revisão personalizadas para adaptar os comentários aos padrões de codificação da sua equipe.