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 Administrador da Coleção de Projetos ativa-a para a organização, um Administrador de Projeto gere os valores predefinidos ao nível do projeto e as substituições dos repositórios, os administradores de repositórios configuram repositórios individuais quando são permitidas substituições, e os utilizadores individuais aderem através das funcionalidades de pré-visualização (a menos que o administrador ative a pré-visualização para todos).

Pré-requisitos

Ativar a revisão do código do Copilot

Ao nível da organização

Um Administrador de Coleções de Projeto tem de ativar a revisão de código do Copilot na organização antes de os proprietários dos projetos a poderem ativar para projetos e repositórios individuais.

Se selecionares a opção Ativar tudo ao nível da organização, a revisão de código do Copilot está ativada para todos os projetos da organização e para todos os repositórios desses projetos. Não precisa de ativar cada projeto ou repositório individualmente.

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.

   

Ao nível do projeto

Depois de o acesso ao nível da organização ser ativado, um Administrador de Projeto pode, opcionalmente, ativar a funcionalidade ao nível do projeto. Esta opção oferece controlo detalhado sobre quais projetos na organização podem usar revisão de código do Copilot.

Se selecionares a opção Ativar tudo ao nível do projeto, a revisão de código do Copilot está ativada para todos os repositórios desse projeto. Não precisas de ativar cada repositório individualmente.

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

2. Em Revisão de código do GitHub Copilot, altere Ativar a revisão de código do Copilot para este projeto para Ativado.

   Esta configuração aplica-se a todos os repositórios do projeto, a menos que seja substituída ao nível do repositório. Ainda podes ativar ou desativar a funcionalidade para repositórios individuais conforme necessário.

Ao nível do repositório

Depois de ativar o acesso ao nível da organização (e, opcionalmente, o acesso ao nível do projeto), o proprietário do repositório ativa a revisão de código do Copilot para cada repositório que o deva utilizar.

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.

   

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.

Configurar a revisão de código do Copilot

Depois de ativar a funcionalidade nos três escopos, pode configurar como o Copilot analisa os pull requests nos seus repositórios.

Configurar o esforço de revisão padrão

O esforço de revisão controla o quão minuciosamente o Copilot analisa um pull request. Um administrador de projeto define o esforço padrão para todos os repositórios de um projeto e decide se os administradores de repositórios podem substituí-lo. Os utilizadores podem selecionar um nível de esforço diferente para uma revisão individual sem alterar o padrão do projeto ou repositório.

Níveis de esforço mais elevados geralmente consomem mais tokens e podem aumentar o custo de uma análise. Para mais informações, veja Facturação.

Defina o padrão do projeto

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

2. Na revisão de código do GitHub Copilot, selecione uma opção do nível de esforço padrão.

3. Para permitir que os administradores de repositórios definam um padrão diferente, selecione Permitir que repositórios individuais definam o seu próprio nível de esforço padrão. Desative esta opção para exigir que todos os repositórios usem o padrão do projeto.

Definir um padrão de repositório

Se o projeto permitir sobreposições de repositório, um administrador de repositório pode definir um padrão diferente:

1. Selecione Definições do projeto>Repos>Repositórios.
2. Selecione o repositório e, em seguida, selecione o separador Definições.
3. Na revisão de código do GitHub Copilot, selecione uma opção do nível de esforço padrão.

Se o projeto não permitir substituições ao nível do repositório, Nível de esforço predefinido está em modo de leitura e apresenta a definição herdada do projeto.

Configurar políticas de revisão automática

O Copilot pode rever automaticamente novos pull requests sem necessidade de pedidos manuais. Pode configurar esta política para todos os repositórios de um projeto ou para repositórios individuais.

A ativação de funcionalidades e a revisão automática são definições separadas. Ativar a revisão de código do Copilot torna-o disponível para um repositório. Uma apólice de revisão automática solicita uma revisão do Copilot quando é criado um novo pull request.

Configure a revisão automática para todos os repositórios de um projeto

Use a política ao nível do projeto para solicitar automaticamente revisões do Copilot em todos os repositórios do projeto. Não precisas de configurar a política para cada repositório individualmente.

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

2. Em a revisão de código do GitHub Copilot, ative Solicitar automaticamente a revisão de código do Copilot em novos pull requests para todos os repositórios deste projeto para Ativado.

   Esta configuração aplica-se a todos os repositórios do projeto, a menos que uma política ao nível do repositório a sobreponha.

Configurar a revisão automática para um repositório

Use a política ao nível do repositório quando precisar de comportamento específico do repositório.

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

2. Seleciona o repositório que queres configurar.

3. No separador Definições, em revisão de código do GitHub Copilot, alterne Solicitar automaticamente a revisão de código do Copilot em novos pull requests para Ativado.

4. (Opcional) Configurar o âmbito da revisão:

   • Aplicar a todos os pull requests: O Copilot analisa todos os novos pull requests do repositório.
   • Aplicar a políticas específicas de ramificações: o Copilot analisa apenas pull requests dirigidos a ramificações especificadas (por exemplo, main ou develop).

   Precedência de política para revisões automáticas:

   • A política de revisão automática ao nível do projeto aplica-se a todos os repositórios do projeto.
   • As definições de revisão automática ao nível do repositório sobrepõem-se ao padrão ao nível do projeto para esse repositório.

Quando ativas a revisão automática, o Copilot começa a rever os novos pull requests imediatamente após a criação. Ainda pode solicitar revisões adicionais manualmente selecionando Request ao lado do GitHub Copilot no pull request.

Selecione um grupo de agentes

A revisão de código Copilot executa trabalhos de revisão utilizando um pool de agentes do Azure Pipelines. Por defeito, utiliza o pool padrão do Azure Pipelines na sua organização.

Algumas organizações desativam o pool padrão do Azure Pipelines. Nessa configuração, a revisão de código do Copilot não pode correr até selecionar um pool alternativo suportado.

Se a sua organização configurou um Managed DevOps Pool, pode selecioná-lo para executar a revisão de código do Copilot em vez do pool padrão.

Ao selecionar uma imagem para o Managed DevOps Pool, certifique-se de selecionar a versão mais recente Ubuntu Server.

As imagens do Windows não são suportadas para análises de código do Copilot. Não misture o seu pool com agentes Ubuntu e Windows.

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

2. Na revisão de código do GitHub Copilot, selecione Compute pool no menu suspenso.

   A configuração do pool de computação da sua organização determina os pools disponíveis. Se não houver pools disponíveis, contacte o administrador da sua organização.

3. Selecione Guardar.

O pool selecionado processa todas as revisões de código Copilot para repositórios na sua organização. Você pode alterar essa configuração a qualquer momento. Para usar diferentes pools para diferentes projetos ou repositórios, configure atribuições de pools através de Managed DevOps Pools.

Personalize o comportamento de avaliação do Copilot

Para orientações sobre como usar instruções personalizadas e competências de agente para adaptar o feedback de revisão de código do Copilot, consulte Configurar as instruções de revisão de código do Copilot.

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 de Revisores, use uma das seguintes opções ao lado do GitHub Copilot:

   • Para usar o nível de esforço padrão do repositório, selecione Request.
   • Para usar um nível de esforço diferente nesta análise, abra o menu suspenso ao lado de Pedido e selecione um nível de esforço.

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.

O nível de esforço selecionado aplica-se apenas a essa avaliação. O Azure DevOps regista o solicitante e o nível de esforço na atividade de pull request.

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.

Cancelar uma revisão em curso

Se uma revisão de código demorar mais do que o esperado ou precisares de a interromper, podes cancelar a execução da revisão.

1. Abra o pull request em que o Copilot está a analisar neste momento.
2. Na secção de Revisores, ao lado do GitHub Copilot, selecione o botão Cancelar (ou selecione Mais opções>Cancelar análise).
3. Confirme o cancelamento quando solicitado.

A revisão termina imediatamente e não são adicionados comentários adicionais. Os resultados da revisão parcial, incluindo os comentários adicionados antes do cancelamento, permanecem no pull request. Pode pedir uma nova avaliação a qualquer momento.

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 que envia ao modelo, tokens de saída gerados pelo modelo e tokens em cache que reutilizam contexto existente. Os tokens usados em cada avaliação convertem-se numa unidade de faturação padrão chamada crédito GitHub AI, onde 1 crédito equivale a $0,01 USD.

O esforço de revisão selecionado afeta o consumo. Níveis de esforço mais elevados geralmente analisam mais contexto e consomem mais tokens do que níveis de esforço mais baixos. O tamanho do pull request, instruções personalizadas do repositório e alterações de modelo também podem afetar o consumo. Para intervalos de referência atuais e ressalvas, veja Consumo estimado.

Para respostas a perguntas frequentes sobre a faturação e custos da revisão de código do Copilot, consulte Resolução de problemas da revisão do código do Copilot.

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. Para estimar os custos esperados no seu ambiente, ative a funcionalidade para um ou dois repositórios, compare os níveis de esforço de revisão e monitorize a utilização diária.

As cobranças de revisão de código do Copilot no Gestão de Custos do Azure incluem agora etiquetas de projeto Azure DevOps, permitindo relatórios de custos por projeto. Pode filtrar ou agrupar a análise de custos por estas etiquetas de projeto para atribuir o uso e o gasto a projetos individuais do Azure DevOps.

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. Para ver os custos de um projeto específico, adicione um filtro ou grupo pela tag do projeto Azure DevOps.

   

Defina um alerta orçamental

Crie um orçamento no Azure que o informe quando os gastos atingem um limiar que definiu. Os orçamentos apenas o notificam. Eles não param as avaliações nem alteram quaisquer recursos. Precisa de acesso de Proprietário, Contribuidor ou Contribuidor de Gestão de Custos na subscrição associada à sua organização do Azure DevOps.

1. No portal Azure, abra a subscrição associada à sua organização Azure DevOps.

2. Selecione Orçamentos de Gestão> de Custos e depois selecione Adicionar.

3. Em Filtros, adicione um filtro para Produto e selecione GitHub Copilot para AzDO.

   

4. Se a subscrição estiver ligada a várias organizações Azure DevOps, adicione um filtro para Tag e selecione as etiquetas de nome da organização que quer que o alerta seja direcionado. Se houver etiquetas de projeto, pode também filtrar ou agrupar por etiqueta de projeto para criar alertas orçamentais ao nível do projeto.

5. Introduza um nome de orçamento, escolha um período de redefinição e uma data de validade, defina o montante do orçamento e depois selecione Próximo.

6. Adicione um ou mais limiares de alerta como percentagem do orçamento (por exemplo, 75% e 90%), defina o Tipo para Atual ou Previsível e introduza os endereços de email para notificar.

7. Selecione Criar.

   

Quando o gasto atinge um determinado limite, o Azure envia um email dentro de uma hora após a próxima avaliação. Para rever os alertas acionados, selecione Gestão de Custos>Alertas de custos. Para evitar que os emails de alerta entrem na sua pasta de lixo, adicione azure-noreply@microsoft.com aos seus remetentes aprovados. Para mais informações, consulte Criar e gerir orçamentos.

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.

Resolver problemas de revisão do código do Copilot

Para respostas a perguntas comuns sobre faturação, tratamento de dados, conformidade e resolução de problemas com instruções personalizadas, consulte Revisão de código do Copilot para resolver problemas.

Passo seguinte

Conteúdo relacionado

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