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 Administrador do Projeto gerencia os padrões no nível do projeto e as substituições de repositório, os administradores de repositório configuram repositórios individuais quando as substituições são permitidas, e os usuários individuais aderem por meio dos recursos de visualização (a menos que o administrador habilite a visualização para todos).

Pré-requisitos

Habilitar revisão de código do Copilot

No nível da organização

Um administrador de coleção do Project deve habilitar a revisão de código do Copilot na organização antes que os proprietários dos projetos possam ativá-la em projetos e repositórios individuais.

Se você selecionar a opção de nível da organização Habilitar tudo, a revisão de código do Copilot será habilitada em todos os projetos da organização e em todos os repositórios desses projetos. Você não precisa habilitar cada projeto ou repositório individualmente.

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 GitHub Copilot code review, alterne Allow repositories in this organization to use Copilot code review para Ativado.

   

No nível do projeto

Depois que o acesso no nível da organização estiver habilitado, um administrador de Project poderá, opcionalmente, habilitar o recurso no nível project. Essa opção oferece controle granular sobre quais projetos na organização podem usar a revisão de código do Copilot.

Se você selecionar a opção de nível de projeto Habilitar tudo, a revisão de código do Copilot será habilitada para cada repositório desse projeto. Você não precisa habilitar cada repositório individualmente.

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

2. Em revisão de código do GitHub Copilot, ative Habilitar a revisão de código do Copilot para este projeto para Ativado.

   Essa configuração se aplica a todos os repositórios no projeto, a menos que seja substituída no nível do repositório. Você ainda pode habilitar ou desabilitar o recurso para repositórios individuais, conforme necessário.

No nível do repositório

Depois de habilitar o acesso no nível da organização (e, opcionalmente, o acesso no nível do projeto), um proprietário do repositório ativa Copilot revisão de código para cada repositório que deve usá-lo.

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

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

3. Na guia Configurações, alterne Enable Copilot code review for pull requests in this repository para Ativado.

   

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.

Configurar a revisão de código do Copilot

Depois de habilitar o recurso em todos os três escopos, você pode configurar como Copilot analisa solicitações pull em 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 uma pull request. Um administrador de projeto define o esforço padrão para todos os repositórios em um projeto e decide se os administradores do repositório podem substituí-lo. Os usuários podem selecionar um nível de esforço diferente para uma revisão individual sem alterar o projeto ou o padrão do repositório.

Níveis de esforço mais altos geralmente consomem mais tokens e podem aumentar o custo de uma revisão. Para obter mais informações, confira Cobrança.

Definir o padrão do projeto

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

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

3. Para permitir que os administradores do repositório definam um padrão diferente, selecione Permitir repositórios individuais para definir seu próprio nível de esforço padrão. Desmarque essa 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 substituições de repositório, um administrador de repositório poderá definir um padrão diferente:

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

Se o projeto não permitir substituições de repositório, o nível de esforço padrão será somente leitura e exibirá a configuração do projeto herdado.

Configurar políticas de revisão automática

Copilot pode revisar automaticamente novas solicitações de pull sem exigir solicitações manuais. Você pode configurar essa política para todos os repositórios em um projeto ou para repositórios individuais.

Habilitação de recursos e revisão automática são configurações separadas. Habilitar a revisão de código do Copilot a disponibiliza para um repositório. Uma política de revisão automática solicita uma revisão do Copilot quando um novo pull request é criado.

Configurar a revisão automática para todos os repositórios em um projeto

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

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

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

   Essa configuração se aplica a todos os repositórios no projeto, a menos que uma política no nível do repositório a substitua.

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

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

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

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

3. Na guia Configurações, em revisão de código do GitHub Copilot, ative Solicitar automaticamente a revisão de código do Copilot em novos pull requests para Ativado.

4. (Opcional) Configurar o escopo de revisão:

   • Aplique a todas as solicitações de pull: Copilot revisa cada nova solicitação de pull no repositório.
   • Aplicar a políticas específicas de branch: O Copilot revisa apenas pull requests direcionados a branches especificadas (por exemplo, main ou develop).

   Ordem de precedência da política para revisões automáticas:

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

Quando você habilita a revisão automática, Copilot começa a examinar novas solicitações de pull imediatamente após a criação. Você ainda pode solicitar revisões adicionais manualmente selecionando Solicitação ao lado de GitHub Copilot na solicitação de pull.

Selecionar um pool de agentes

A revisão de código do Copilot executa tarefas de revisão usando um pool de agentes do Azure Pipelines. Por padrão, ele usa o pool de Azure Pipelines padrão em sua organização.

Algumas organizações desabilitam o pool de Azure Pipelines padrão. Nessa configuração, Copilot revisão de código não pode ser executada até que você selecione um pool alternativo com suporte.

Se sua organização tiver configurado um Pool de DevOps Gerenciado, você poderá selecioná-lo para executar Copilot revisão de código em vez do pool padrão.

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

Imagens do Windows não têm suporte no Copilot Code Reviews. Não misture seu pool com agentes do Ubuntu e do Windows.

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

2. Em revisão de código do GitHub Copilot, selecione pool de computação no menu suspenso.

   A configuração do pool de computação da sua organização determina os pools disponíveis. Se nenhum pool estiver disponível, entre em contato com o administrador da sua organização.

3. Selecione Salvar.

O pool selecionado processa todas as revisões de código do Copilot dos repositórios da sua organização. Você pode alterar essa configuração a qualquer momento. Para usar pools diferentes para diferentes projetos ou repositórios, configure as atribuições de pool por meio de Pools de DevOps Gerenciados.

Personalizar o comportamento de revisão do Copilot

Para obter diretrizes sobre como usar instruções personalizadas e habilidades de agente para adaptar os comentários de revisão de código do Copilot, consulte Configurar Copilot instruções de revisão de código.

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

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

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.

O nível de esforço selecionado aplica-se somente a essa revisão. O Azure DevOps registra o solicitante e o nível de esforço na atividade do pull request.

Ler os comentários de Copilot

• O Copilot publica 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.

Nova revisão após novos commits

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.

Cancelar uma revisão em andamento

Se uma revisão de código levar mais tempo do que o esperado ou você precisar pará-la, você poderá cancelar a execução da revisão.

1. Abra o pull request que o Copilot está revisando atualmente.
2. Na seção Revisores, ao lado de GitHub Copilot, selecione o botão Cancelar (ou selecione Mais opções>Cancelar revisão).
3. Confirme o cancelamento quando solicitado.

A execução da revisão é interrompida imediatamente, e nenhum comentário adicional é acrescentado. Os resultados parciais da revisão, incluindo comentários adicionados antes do cancelamento, permanecem na solicitação de pull. Você pode solicitar uma nova revisão a qualquer momento.

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.

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

Para obter respostas às perguntas frequentes sobre a cobrança e os custos da revisão de código do Copilot, consulte Solucionar problemas da revisão de código do Copilot.

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. Para estimar os custos esperados em seu ambiente, habilite o recurso para um ou dois repositórios, compare os níveis de esforço de revisão e monitore o uso diário.

As cobranças da revisão de código do Copilot no Gerenciamento de Custos do Azure agora incluem tags de projeto do Azure DevOps, permitindo relatórios de custos por projeto. Você pode filtrar ou agrupar a análise de custos por essas marcas de projeto para atribuir o uso e os gastos a projetos Azure DevOps individuais.

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

   

Configurar um alerta de orçamento

Crie um orçamento Azure que notifique você quando os gastos atingirem um limite definido. Os orçamentos notificam você apenas. Eles não interrompem revisões nem alteram nenhum recurso. Você precisa de acesso de Proprietário, Colaborador ou Colaborador de Gerenciamento de Custos na assinatura vinculada à sua organização Azure DevOps.

1. No portal Azure, abra a assinatura vinculada à sua organização Azure DevOps.

2. Selecione Gerenciamento de custos>Orçamentos e, em seguida, selecione Adicionar.

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

   

4. Se a assinatura estiver vinculada a várias organizações do Azure DevOps, adicione um filtro para Tag e selecione as tags de nome da organização para as quais você deseja direcionar o alerta. Se as marcas de projeto estiverem presentes, você também poderá filtrar ou agrupar por marca de projeto para criar alertas de orçamento no nível do projeto.

5. Insira um nome de orçamento, escolha um período de redefinição e uma data de validade, defina o valor do orçamento e selecione Avançar.

6. Adicione um ou mais limites de alerta como um percentual do orçamento (por exemplo, 75% e 90%), defina Tipo como Real ou Previsto e insira os endereços de email a serem notificados.

7. Selecionar Criar.

   

Quando os gastos atingem um limite, Azure envia um email dentro de uma hora da próxima avaliação. Para revisar alertas acionados, selecione Gerenciamento de custos>Alertas de custo. Para manter os emails de alerta fora da pasta lixo eletrônico, adicione azure-noreply@microsoft.com aos remetentes aprovados. Para obter mais informações, consulte Criar e gerenciar orçamentos.

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.

Solucionar problemas na revisão de código do Copilot

Para obter respostas a perguntas comuns sobre cobrança, tratamento de dados, conformidade e resolução de problemas com instruções personalizadas, consulte Solucionar problemas da revisão de código do Copilot.

Próxima etapa

Conteúdo relacionado

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