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

Serviços de DevOps do Azure

Usa o GitHub Copilot para analisar pull requests no Repositórios do Azure. O Copilot atua como um revisor automatizado que deixa comentários e sugestões sobre o código alterado, para que receba comentários antes de um revisor humano dar a aprovação final.

Para usar a funcionalidade, um Project Collection Administrator ativa-a para a organização, um proprietário do repositório ativa-a para cada repositório, e os utilizadores individuais optam por aderir através das funcionalidades de Pré-visualização (a menos que o administrador ative a pré-visualização para todos).

Pré-requisitos

Permitir a revisão do código Copilot ao nível da organização

Um Project Collection Administrator tem de ativar a revisão de código do Copilot na organização antes de os proprietários dos repositórios a poderem ativar em repositórios individuais.

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

2. Selecione Definições de organização>Repos>Repositórios.

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

   

Ativar a revisão de código do Copilot ao nível do repositório

Depois de o acesso ao nível da organização estar ativado, o proprietário do repositório ativa a revisão de código do Copilot para cada repositório que deva utilizá-lo.

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

2. Seleciona o repositório que queres ativar.

3. No separador Settings, altere Ativar a revisão de código do Copilot para pull requests neste repositório para On.

   

Ativar a revisão de código do Copilot para utilizadores individuais

Depois de ativar a funcionalidade ao nível da organização e do repositório, os utilizadores individuais podem aderir através das funcionalidades de Pré-visualização.

1. Selecione o seu avatar de utilizador no canto superior direito e depois selecione Funcionalidades de Pré-visualização.

2. Define o telescópio para mim.

3. Localize Copilot Code Review for Pull Requests e ative a opção Ativado.

   

Para verificar se a funcionalidade está ativada, abra qualquer pull request no repositório. GitHub Copilot deve agora aparecer como um revisor disponível na lista Revisores.

Revisão do código Use Copilot

Com a funcionalidade ativada nos três âmbitos, pode pedir ao Copilot para analisar um pull request. As secções seguintes descrevem o que esperar.

Solicite uma revisão

Por defeito, GitHub Copilot analisa um pull request apenas quando solicita um:

1. Abre um pull request.
2. Na secção Revisores, selecione Request ao lado de GitHub Copilot.
3. Espere que a avaliação termine. A revisão pode demorar alguns momentos, dependendo do tamanho do repositório e do número de alterações no pull request. Quando a revisão termina, o estado muda para Revisão concluída.

Se o Copilot identificar potenciais problemas, adiciona comentários e sugestões diretamente ao pull request para que possa analisar e abordar.

Leia os comentários do Copilot

• O Copilot publica os seus comentários como um revisor normal chamado GitHub Copilot no pull request.
• Cada comentário aparece na linha de código a que se aplica e, sempre que possível, inclui uma alteração sugerida que pode aplicar com um clique.
• Copilot deixa sempre uma avaliação Comentário. Nunca aprova o pull request nem solicita alterações, pelo que a sua revisão não satisfaz as políticas de revisores obrigatórios nem bloqueia a intercalação.
• Os comentários do Copilot comportam-se como comentários de um crítico humano. Podes responder-lhes, reagir, resolvê-los ou escondê-los. O Copilot não lê respostas nem faz seguimento.

Reavaliação após novos commits

O Copilot não revê automaticamente um pull request quando envias novos commits. Para obter uma nova avaliação após um commit, selecione novamente Request ao lado de GitHub Copilot na lista Reviewers.

Dê feedback sobre uma avaliação

Cada comentário do Copilot inclui botões de polegar para cima e para baixo. Usa-os para dizer à equipa do Copilot se algum comentário específico foi útil. Se selecionares o polegar para baixo, podes opcionalmente escolher uma razão e adicionar detalhes antes de submeteres.

Requisitos e limites

Os seguintes requisitos e limites aplicam-se durante a pré-visualização e podem ser alterados.

O Copilot analisa um pull request apenas quando cumpre estes requisitos:

Estes limites de concorrência e taxas também se aplicam:

Billing

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 em cache que reutilizam contexto existente. Os tokens usados para cada revisão são convertidos numa unidade de faturação padrão chamada crédito GitHub IA, onde 1 crédito equivale a $0,01 USD.

As taxas vão para a subscrição do Azure associada à sua organização Azure DevOps e aparecem como um contador separado no Gestão de Custos do Azure. O custo de cada avaliação varia consoante fatores como o tamanho do pull request e o número de linhas alteradas. Para estimar os custos esperados no seu ambiente, ative a funcionalidade para um ou dois repositórios primeiro e monitorize o uso diário.

Para monitorizar as suas cobranças diárias:

1. No portal Azure, aceda à sua subscrição.

2. Selecione Gestão de custos>Análise de custos.

3. Filtre por produto para ver os custos diários da organização.

   

Perguntas mais frequentes (FAQ)

Onde posso encontrar os preços de lista que me cobram pelos tokens?

Veja Modelos e preços na documentação do GitHub Copilot.

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

O consumo de tokens depende de fatores como o tamanho do repositório, o tamanho da alteração e a complexidade do código a ser revisto.

Os créditos que comprei com subscrições do Copilot contam para a utilização de revisão de código no Azure DevOps? Posso usar créditos de IA de um plano GitHub Copilot?

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

Desativar a revisão de código do Copilot

Para parar de utilizar a revisão de código do Copilot, defina o interruptor para Desligado ao nível em que pretende desativá-la:

• Para um utilizador: desative a opção de Pré-visualização nas definições de utilizador.
• Para um único repositório: Desative o botão de alternância do repositório em Definições do projeto>Repos>Repositórios.
• Para toda a organização: Desligue o interruptor da organização em Definições da organização>Repos>Repositories. Esta ação desativa a funcionalidade para todos os repositórios.

Partilhar comentários

Para reportar problemas ou partilhar feedback sobre esta pré-visualização, visite o Azure DevOps Developer Community.

Passo seguinte

Conteúdo relacionado

• Sobre revisão de código GitHub Copilot
• Acerca dos pull requests
• Definições e políticas do repositório