Primeiros passos com a revisão de código do Copilot para pull requests

Serviços do Azure DevOps

Use GitHub Copilot para examinar solicitações de pull no Azure Repos. Copilot atua como um revisor automatizado que posta comentários e sugestões sobre o código alterado, para que você receba comentários antes de um revisor humano sair.

Para usar o recurso, um Administrador da Coleção de Projetos o ativa para a organização, um proprietário do repositório o ativa para cada repositório, e os usuários individuais aderem por meio dos Recursos de visualização (a menos que o administrador habilite a versão prévia para todos).

Pré-requisitos

Habilitar a revisão de código do Copilot no nível da organização

Um Administrador da Coleção de Projetos deve habilitar a revisão de código do Copilot na organização antes que os proprietários de repositórios possam ativá-la em repositórios individuais.

1. Entre na sua organização do Azure DevOps (https://dev.azure.com/{yourorganization}).

2. Selecione Configurações da organização>Repos>Repositórios.

3. Em revisão de código do GitHub Copilot, alterne Permitir que os repositórios nesta organização usem a revisão de código do Copilot para Ativado.

   

Habilitar revisão de código do Copilot no nível do repositório

Depois que o acesso em nível de organização estiver habilitado, o proprietário de um repositório ativa a revisão de código do Copilot para cada repositório que deve usá-la.

1. Selecione Configurações do projeto>Repos>Repositórios.

2. Selecione o repositório que você deseja habilitar.

3. Na guia Settings, ative Habilitar a revisão de código do Copilot para pull requests neste repositório para On.

   

Habilitar a revisão de código do Copilot para usuários individuais

Depois de habilitar o recurso no nível da organização e do repositório, os usuários individuais podem aderir por meio de Recursos de visualização.

1. Selecione o avatar do usuário no canto superior direito e, em seguida, selecione Recursos de visualização.

2. Defina o escopo para mim.

3. Localize Copilot Code Review for Pull Requests e alterne-o para On.

   

Para verificar se o recurso está habilitado, abra qualquer solicitação de pull no repositório. GitHub Copilot agora deve aparecer como um revisor disponível na lista Reviewers.

Usar a revisão de código do Copilot

Com o recurso habilitado em todos os três escopos, você pode solicitar que o Copilot revise um pull request. As seções a seguir descrevem o que esperar.

Solicitar uma revisão

Por padrão, GitHub Copilot revisa uma solicitação de pull somente quando você solicita uma:

1. Abrir um pull request.
2. Na seção Reviewers, selecione Request ao lado de GitHub Copilot.
3. Aguarde a conclusão da revisão. A revisão pode levar alguns instantes, dependendo do tamanho do repositório e do número de alterações na solicitação de pull. Quando a revisão for concluída, o status será alterado para Revisão concluída.

Se Copilot identificar possíveis problemas, ele adicionará comentários e sugestões diretamente à solicitação de pull para que você examine e resolva.

Ler os comentários de Copilot

• Copilot posta seus comentários como um revisor regular chamado GitHub Copilot na solicitação de pull.
• Cada comentário aparece na linha de código à qual se aplica e, sempre que possível, inclui uma alteração sugerida que você pode aplicar com um clique.
• Copilot sempre deixa uma revisão Comment. Ele nunca aprova a solicitação de pull ou solicita alterações, portanto, sua revisão não atende às políticas de revisor obrigatório e não bloqueia a mesclagem.
• os comentários de Copilot se comportam como comentários de um revisor humano. Você pode responder a eles, reagir a eles, resolvê-los ou ocultá-los. Copilot não lê respostas e não faz acompanhamento.

Revisar novamente após novas confirmações

O Copilot não faz uma nova revisão automaticamente de um pull request quando você faz push de novos commits. Para obter uma nova revisão após uma confirmação, selecione Request novamente ao lado de GitHub Copilot na lista Reviewers.

Fazer comentários sobre uma revisão

Cada comentário do Copilot inclui botões de polegar para cima e para baixo. Use-os para informar à equipe de Copilot se um comentário específico foi útil. Se você selecionar o polegar para baixo, opcionalmente poderá escolher um motivo e adicionar detalhes antes de enviar.

Requisitos e limites

Os requisitos e limites a seguir se aplicam durante a visualização e podem ser alterados.

Copilot revisa uma solicitação de pull somente quando ela atende a estes requisitos:

Esses limites de concorrência e taxa também se aplicam:

Faturamento

Cada revisão de código concluída consome tokens, incluindo tokens de entrada enviados para o modelo, tokens de saída gerados pelo modelo e tokens armazenados em cache que reutilizam o contexto existente. Os tokens usados para cada revisão são convertidos em uma unidade de cobrança padrão chamada GitHub crédito de IA, em que 1 crédito é igual a US$ 0,01.

Os encargos vão para a assinatura Azure vinculada à sua organização Azure DevOps e aparecem como um medidor separado em Gerenciamento de Custos do Azure. O custo de cada revisão varia de acordo com fatores como o tamanho da solicitação de pull e o número de linhas alteradas. Para estimar os custos esperados em seu ambiente, habilite o recurso para um ou dois repositórios primeiro e monitore o uso diário.

Para acompanhar suas cobranças diárias:

1. No Azure portal, acesse sua assinatura.

2. Selecione Gerenciamento de Custos>Análise de custo.

3. Filtrar por produto para exibir os custos diários da organização.

   

Perguntas frequentes (FAQs)

Onde posso encontrar os preços de lista que me são cobrados pelos tokens?

Consulte Models e preços na documentação do GitHub Copilot.

Quais fatores influenciam o número de tokens consumidos por uma revisão de código?

O consumo de token depende de fatores como o tamanho do repositório, o tamanho da alteração e a complexidade do código que está sendo revisado.

Os créditos que comprei com assinaturas de Copilot contam para o uso de revisão de código em Azure DevOps? Posso usar créditos de IA de um plano de GitHub Copilot?

Não, o uso no Azure DevOps não consome créditos de IA dos planos do GitHub Copilot.

Desativar a revisão de código do Copilot

Para deixar de usar a revisão de código do Copilot, defina a opção como Off no escopo que você deseja desativar:

• Para um usuário: desative o botão de recursos de visualização em suas configurações de usuário.
• Para um repositório: desative o botão de alternância do repositório em Configurações do projeto>Repos>Repositórios.
• Para toda a organização: desative a opção da organização em Configurações da organização>Repos>Repositórios. Essa ação desabilita o recurso para todos os repositórios.

Compartilhar comentários

Para relatar problemas ou compartilhar comentários sobre essa versão prévia, visite o Azure DevOps Developer Community.

Próxima etapa

Conteúdo relacionado

• Sobre a revisão de código do GitHub Copilot
• Sobre solicitações de pull
• Configurações e políticas do repositório