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

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

• 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.

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.

   

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.

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.

Próxima etapa

Perguntas frequentes (FAQs)

P: Onde posso encontrar os preços de lista cobrados pelos tokens?

R: Consulte modelos e preços na documentação do GitHub Copilot.

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

R: 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.

P: Os créditos que eu comprar com assinaturas de Copilot contam para o uso de revisão de código no Azure DevOps? Posso usar créditos de IA de um plano de GitHub Copilot?

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

P: O código do cliente ou o conteúdo da revisão de pull request são usados para treinar ou melhorar modelos fundamentais?

R: Não. Os dados de interação usados para a revisão de código do Copilot, incluindo diffs de pull request, prompts, respostas, sugestões e contexto relacionado à revisão, não são usados para treinar nem melhorar modelos fundamentais.

P: Quais dados do cliente são retidos durante ou após uma revisão de código?

A: O tratamento e a retenção de dados seguem a documentação da política do GitHub Copilot. O Azure Repos não publica uma política de retenção separada para a revisão de código do Copilot.

Q: Os diffs de pull request, os prompts, as sugestões geradas ou a telemetria são armazenados após o processamento da solicitação? Se mantido, quais são os períodos de retenção?

R: Para obter detalhes atuais de armazenamento e retenção, incluindo quaisquer atualizações de política relacionadas à retenção, consulte GitHub Copilot documentação de confiança e privacidade. Atualmente, o Azure Repos não publica uma tabela separada com o período de retenção específico do recurso para a revisão de código do Copilot.

P: Onde o conteúdo do cliente é processado e armazenado para Copilot revisão de código?

A: A revisão de código do Copilot no Azure Repos é viabilizada pelo GitHub Copilot. A residência dos dados do GitHub Copilot não está alinhada com os limites de residência de dados da organização no Azure DevOps para esse recurso em versão prévia. Por exemplo, se sua organização do Azure DevOps estiver hospedada na UE, o processamento da revisão de código pelo Copilot ainda poderá ocorrer em outra geografia, como os Estados Unidos.

P: A residência de dados do GitHub Copilot se aplica à revisão de código do Copilot para o Azure Repos?

A: Para este recurso de visualização prévia, não suponha que a geografia da organização do Azure DevOps determine a geografia de processamento da revisão de código do Copilot. Consulte a documentação de confiança e privacidade do GitHub Copilot para conhecer o escopo e os limites atuais da residência de dados.

P: O Copilot para revisão de código do Azure Repos segue os mesmos compromissos de tratamento de dados que o GitHub Copilot Business e o GitHub Copilot Enterprise?

A: Sim, a revisão de código do Copilot no Azure Repos segue as políticas de tratamento de dados do GitHub Copilot. Para conhecer os compromissos atuais, consulte a documentação de confiança e privacidade do GitHub Copilot.

P: Qual documentação de conformidade voltada para o cliente posso compartilhar com as equipes de segurança e conformidade?

R: Use estas referências oficiais:

• Perguntas frequentes da Central de Confiabilidade do GitHub Copilot
• política de privacidade geral GitHub
• Sobre a revisão de código do GitHub Copilot

P: Há limitações ou exceções específicas da versão prévia que devo conhecer?

A: Sim. A revisão de código do Copilot para Azure Repos está em prévia pública limitada:

• Os recursos de visualização podem ser alterados ou removidos sem aviso prévio.
• Os recursos de visualização não têm SLA (Contrato de Nível de Serviço) e suporte limitado.
• A residência de dados desse recurso não se alinha aos limites de residência de dados da organização do Azure DevOps.

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