Como usar a revisão de código do GitHub Copilot

Dois tipos de Revisão de código do Copilot estão disponíveis:

• Revisão de seleção: realce o código e soliicte uma revisão inicial (disponível somente no VS Code)
• Revisão de alterações: solicite uma revisão mais profunda de todas as suas alterações (disponível no VS Code e no site do GitHub)

Esta versão do artigo está relacionada ao Revisão de código do Copilot no site do GitHub. Para ver informações sobre o tipo de seleção de revisão do Revisão de código do Copilot, clique na opção "Visual Studio Code" na parte superior da página.

Disponibilidade

O Revisão de código do Copilot no site do GitHub é um recurso Premium, disponível com os planos Copilot Pro, Copilot Pro+, Copilot Business e Copilot Enterprise.

Cota mensal de revisão de código

O tipo alterações de revisão do Revisão de código do Copilot é um recurso premium com uma cota mensal por pessoa.

Quando você atribuir o Copilot como revisor de uma pull request, uma solicitação premium será deduzida de sua cota mensal sempre que o Copilot postar comentários na pull request. Confira Sobre solicitações premium.

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.

Suporte ao idioma

O Revisão de código do Copilot no site do GitHub dá suporte a todas as linguagens.

As seguintes linguagens têm suporte em disponibilidade geral:

• C
• C#
• C++
• Go
• Java
• JavaScript
• Kotlin
• Markdown
• Python
• Ruby
• Swift
• TypeScript

Todas as outras linguagens têm suporte como versão prévia pública.

Estas instruções explicam como usar a Revisão de código do Copilot no site do GitHub. Para ver instruções para outros ambientes de codificação populares, use o alternador de ferramentas na parte superior da página.

Como solicitar uma revisão da solicitação de pull request do Copilot

1. Em GitHub.com, crie uma solicitação de pull ou navegue até uma existente.

2. Abra o menu Revisores e escolha Copilot.

   

3. Aguarde o Copilot revisar sua pull request. Normalmente, isso leva menos de 30 segundos.

4. Role a página para baixo e leia os comentários do Copilot.

   

   O Copilot sempre deixa uma revisão “Comentário”, não uma revisão “Aprovar” nem “Solicitar alterações”. Isso significa que as revisões do Copilot não contam para as revisões necessárias para a pull request e as revisões do Copilot não bloquearão o merge de alterações. Para ver mais detalhes, confira Aprovar uma pull request com revisões obrigatórias.

5. Os comentários da revisão do Copilot são parecidos com os comentários de revisão feitos por humanos. Você pode adicionar reações a eles, comentá-los, resolvê-los e ocultá-los.

   Qualquer comentário que você adicionar aos comentários da revisão do Copilot ficará visível para humanos, mas não para o Copilot, e o Copilot não responderá a ele.

Como trabalhar com as sugestões de alterações fornecidas pelo Copilot

Sempre que possível, os comentários do Copilot incluem sugestões de alterações que você pode aplicar com alguns cliques.

Se você estiver satisfeito com as alterações, poderá aceitar uma só sugestão do Copilot e fazer commit dela ou aceitar um grupo de sugestões juntas em um só commit. Para saber mais, confira Incorporando feedback em sua pull request.

Caso deseje validar as sugestões de alterações do Copilot (por exemplo, executando testes automatizados ou o seu linter) ou fazer modificações antes de fazer commit delas, selecione o botão Abrir no Workspace. Para saber mais, confira Como usar o Copilot para facilitar seu trabalho em uma pull request.

Como fornecer comentários sobre as revisões do Copilot

Você pode fornecer comentários sobre os comentários do Copilot diretamente em cada comentário. Usamos essas informações para aprimorar o produto e a qualidade das sugestões do Copilot.

1. Em um comentário de uma revisão da solicitação de pull request do Copilot, selecione o botão de polegar para cima (👍) ou de polegar para baixo (👎).

   

2. Se você selecionar o botão de polegar para baixo, precisará fornecer mais informações. Opcionalmente, você pode escolher o motivo dos seus comentários negativos e deixar um comentário antes de selecionar Enviar comentários.

   

Como solicitar uma nova revisão do Copilot

Quando você efetuar push de alterações para uma pull request que o Copilot revisou, ele não fará uma nova revisão das alterações automaticamente.

Para solicitar uma nova revisão do Copilot, selecione o botão ao lado do nome do Copilot no menu Revisores. Para saber mais, confira Solicitar revisão de pull request.

Habilitação das avaliações automáticas

Por padrão, você precisa solicitar manualmente uma revisão do Copilot em cada pull request, do mesmo modo que solicitaria uma revisão humana. No entanto, você pode configurar Copilot para revisar automaticamente todos os pull requests em um repositório ou para todos os repositórios em uma organização. Confira Configuração da revisão automática do Copilot.

Como personalizar as revisões do Copilot com diretrizes de codificação

Ao usar o Revisão de código do Copilot para revisar as alterações no Visual Studio Code ou no site do GitHub, você pode personalizar a revisão do Copilot com diretrizes de codificação personalizadas escritas em linguagem natural. O Copilot fornecerá comentários com base nas suas diretrizes de codificação ao revisar o código. Para saber mais, confira Como configurar diretrizes de codificação para a revisão de código do GitHub Copilot.

Os comentários gerados com base em uma diretriz de codificação incluirão uma mensagem, realçando a origem dela.