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.

   

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.

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.

   

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.

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.

Passo seguinte

Perguntas mais frequentes (FAQ)

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

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

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

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

P: Os créditos que compro 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?

R: Não, a utilização no Azure DevOps não utiliza créditos de IA dos planos GitHub Copilot.

P: O conteúdo da revisão de código dos clientes ou de pull requests é utilizado para treinar ou melhorar modelos de base?

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

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

R: O manuseamento e retenção de dados seguem a documentação de políticas do GitHub Copilot. O Repositórios do Azure não publica um calendário de retenção separado para revisão de código do Copilot.

Q: Os diffs de pull request, prompts, sugestões geradas ou telemetria são armazenados para além do processamento do pedido? Se for retido, quais são os períodos de retenção?

R: Para detalhes atuais sobre armazenamento e retenção, incluindo quaisquer atualizações de políticas relacionadas com retenção, consulte a documentação de confiança e privacidade do GitHub Copilot. O Repositórios do Azure não publica atualmente uma tabela separada de períodos de retenção específica para a revisão do código do Copilot.

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

R: A análise do código do Copilot no Repositórios do Azure é suportada pelo GitHub Copilot. A residência de dados do GitHub Copilot não está alinhada com os limites de residência de dados da organização do Azure DevOps para esta funcionalidade em pré-visualização. Por exemplo, se a sua organização Azure DevOps estiver alojada na UE, o processamento de revisão de código do Copilot pode ainda ocorrer noutra geografia, como nos Estados Unidos.

P: O GitHub Copilot Data Residency aplica-se à revisão de código do Copilot para Repositórios do Azure?

R: Para esta funcionalidade de pré-visualização, não presuma que a geografia de gestão do Azure DevOps determina a geografia do processamento de revisão de código do Copilot. Consulte a documentação de confiança e privacidade do GitHub Copilot para conhecer o âmbito e os limites atuais da residência de dados.

P: A revisão de código do Copilot para Repositórios do Azure segue os mesmos compromissos de gestão de dados que o GitHub Copilot Business e o GitHub Copilot Enterprise?

R: Sim, a revisão do código do Copilot no Repositórios do Azure segue as políticas de gestão de dados do GitHub Copilot. Para compromissos atuais, consulte a documentação de confiança e privacidade do GitHub Copilot.

P: Que documentação de conformidade voltada para o cliente posso partilhar com as equipas de segurança e conformidade?

R: Use estas referências oficiais:

• Perguntas Frequentes do GitHub Copilot Trust Center
• Declaração Geral de Privacidade do GitHub
• Sobre revisão de código GitHub Copilot

P: Existem limitações ou exceções específicas de pré-visualização de que deva estar ciente?

R: Sim. A revisão do código Copilot para Repositórios do Azure está em pré-visualização pública limitada:

• As funcionalidades de pré-visualização podem ser alteradas ou removidas sem aviso prévio.
• As funcionalidades de pré-visualização não têm Acordo de Nível de Serviço (SLA) e têm suporte limitado.
• A residência de dados para esta funcionalidade não está alinhada com os limites da residência de dados da organização Azure DevOps.

Conteúdo relacionado

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