Utilize o GitHub Copilot com o Azure Boards

Azure DevOps Serviços

Azure Boards integra-se com GitHub Copilot para simplificar o seu fluxo de trabalho de desenvolvimento. Pode usar os itens de trabalho diretamente com o Copilot, que cria automaticamente ramificações, implementa alterações de código e gera pull requests preliminares, mantendo o seu item de trabalho atualizado com o progresso.

Esta integração permite-lhe:

• Iniciar codificação automatizada a partir dos itens de trabalho
• Acompanha o progresso da GitHub Copilot diretamente em Azure DevOps
• Ligue automaticamente os pull requests gerados e as branches aos itens de trabalho.
• Monitorize quando os pull requests de rascunho estão prontos para análise

Pré-requisitos

Tipos de itens de trabalho suportados

A integração GitHub Copilot suporta qualquer tipo de item de trabalho sob os requisitos e categoria de tarefa, incluindo:

• Tipos padrão de itens de trabalho: História de Utilizador, Item de Atraso do Produto, Requisito, Tarefa, Bug, Problema
• Tipos de itens de trabalho personalizados que criou no seu modelo de processo

Este apoio abrangente significa que pode usar GitHub Copilot com itens de trabalho de qualquer modelo de processo (Ágil, Scrum, CMMI ou personalizado) no seu projeto Azure DevOps.

Comece o GitHub Copilot a partir de itens de trabalho

1. Abre um item de trabalho que queiras usar com GitHub Copilot.

2. No formulário do item de trabalho, selecione o ícone do GitHub.

   Se houver várias opções disponíveis, o botão torna-se um menu suspenso com diferentes escolhas.

   

3. Selecione Crie um pull request com GitHub Copilot.

   

4. Seleciona o repositório GitHub de destino e faz uma ramificação onde o Copilot deve criar o pull request.

   Observação

   Apenas repositórios GitHub ligados via autenticação de aplicações GitHub aparecem na lista de repositórios. Os Azure Repos não são suportados.

5. (Opcional) Adicione instruções especiais para orientar a abordagem de implementação do Copilot. Por exemplo, pode acrescentar, "Criar README com instruções de configuração".

6. Selecione Criar para iniciar o processo automatizado de codificação.

   

O que acontece quando começas o Copilot

Quando inicia o Copilot a partir de um item de trabalho, ocorrem os seguintes processos automatizados:

• Partilha de dados: Azure DevOps partilha o título do item de trabalho, campos de texto grandes (como critérios de descrição e aceitação), comentários e um link de volta ao item de trabalho com GitHub Copilot.
• Validação da licença: Azure DevOps verifica a tua licença de GitHub Copilot.
  • Se a validação falhar, aparece uma opção Obtenha uma licença para comprar GitHub Copilot.
• Repository preparation: Copilot cria uma nova ramificação para o trabalho.
• Criação de pull request: Um pull request de rascunho é gerado automaticamente e associado ao respetivo item de trabalho.
• Atualizações dos itens de trabalho:
  • Um comentário é adicionado à discussão dos itens de trabalho.
  • O indicador de estado aparece acima da secção de Desenvolvimento.
  • Os links de branch e pull request são automaticamente adicionados.
• Seguimento de progresso: Atualizações de estado em tempo real mostram o progresso da Copilot.

Monitorar o progresso do GitHub Copilot

Indicadores de estado

O Azure DevOps mostra o estado do Copilot diretamente no seu item de trabalho, com três estados possíveis:

• Em Progresso: Copilot está a trabalhar ativamente em alterações de código.
• Pronto para Revisão: O pull request de rascunho está completo e pronto para a sua revisão.
• Erro: Ocorreram problemas durante o processo de codificação (passe o rato para mais detalhes).

Indicadores de cartas de tabuleiro

Quando visualiza os itens de trabalho no seu quadro, pode identificar o estado do GitHub Copilot diretamente no cartão de trabalho. Um ícone do GitHub Copilot aparece no cartão e indica que o Copilot está a trabalhar ou a concluir trabalho nesse item.

Este indicador visual ajuda-o a identificar rapidamente quais os itens de trabalho que têm operações ativas no Copilot sem abrir cada item individualmente.

Atualizações da secção de desenvolvimento

A secção de Desenvolvimento do seu item de trabalho mostra automaticamente:

• Ramo ligado criado pelo Copilot.
• Pedido de pull request redigido e estado em tempo real.
• Links diretos para rever o código gerado no GitHub.

Rever e integrar o pull request

1. Selecione o link do pull request para rever a implementação do Copilot no GitHub.

2. Se estiver satisfeito com as alterações, converta o rascunho num pull request normal. A discussão sobre itens de trabalho recebe atualizações automáticas sobre alterações no estado dos pull requests.

3. Use a interface do GitHub para rever, comentar e aprovar o código gerado.

4. Completa o processo de fusão no GitHub quando estiveres pronto.

   • O commit de fusão liga-se automaticamente ao seu item de trabalho.
   • Os links de ramificação são removidos se a ramificação for eliminada.
   • Os indicadores de estado do Copilot ficam ocultos após a fusão bem-sucedida.

5. Após a integração do pull request:

   1. Para refletir a conclusão, atualize o estado do seu item de trabalho.
   2. Verifique se o commit de fusão aparece na secção de Desenvolvimento.
   3. Feche o item de trabalho se a implementação cumprir totalmente os requisitos.

Para mais informações, consulte o nosso módulo de formação, Comece com GitHub Copilot.

Solucionar problemas

• Verifique os detalhes do erro: Passe o rato sobre o ícone do erro para obter informações específicas sobre o que correu mal.

• Rerun Copilot: Selecione Rerun Copilot para tentar o processo novamente com as mesmas instruções ou instruções modificadas.

  

• Intervenção manual: Se necessário, faça alterações manuais ao branch gerado e ao pull request.

Problemas de licença

• Problema: A validação da licença falha.
• Solução: Certifique-se de que tem uma subscrição GitHub Copilot ativa e selecione Obtenha uma licença se necessário.

Acesso ao repositório

• Problema: Não consigo ver os repositórios esperados.
• Solução:
  • Verifique a ligação da aplicação GitHub entre Azure DevOps e GitHub.
  • Assegura-te de que tens acesso aos repositórios do GitHub (não aos Azure Repos).
  • Verifique as permissões do repositório e a autenticação da aplicação GitHub.
  • Confirma se o repositório está ligado através da integração correta com a aplicação GitHub.

Erros de Copilot

• Problema: O agente de codificação encontra erros.
• Solution: Rever os detalhes dos erros, verificar as instruções para clareza e tentar executar novamente o Copilot.

Estado não atualizado

• Problema: O estado de progresso mantém-se bloqueado.
• Solução: Verifique GitHub para o progresso real, pois as atualizações do estado dependem do relatório do GitHub.

Melhores práticas

• Descrições claras dos itens de trabalho: Forneça critérios detalhados de aceitação e contexto para melhores resultados Copilot.
• Mantém as alterações simples e concisas: Quanto mais complexa e detalhada for a descrição do teu item de trabalho, mais difícil será para Copilot compreender. Foca-te em requisitos claros e específicos.
• Instruções específicas: Adicione orientações de implementação ao iniciar Copilot.
• Monitorização regular: Verifique o progresso periodicamente, especialmente para tarefas complexas.
• Revisão rápida: Revise rapidamente e forneça feedback sobre pull requests de rascunho para manter o ritmo.
• Higiene adequada dos itens de trabalho: Atualize os estados dos itens de trabalho adequadamente ao longo do processo.

Limitações

Esteja ciente das seguintes limitações ao usar GitHub Copilot com Azure Boards:

• Dependências: O tratamento de dependências entre itens de trabalho não é suportado. Cada item de trabalho deve ser autónomo.
• Operações concorrentes: Gerir múltiplas operações de Copilot concorrentes entre diferentes itens de trabalho não é suportado. Completar uma operação Copilot antes de começar outra.
• Partilha de dados: Apenas o título do item de trabalho, campos de texto grandes, comentários e o link do item de trabalho são partilhados com GitHub Copilot.
• Complexidade: Descrições de itens de trabalho excessivamente complexas ou extensas podem reduzir a eficácia da Copilot.

Conteúdo relacionado

• Ligar itens de trabalho a artefactos de desenvolvimento
• Configurar GitHub integração
• Trabalhe com pedidos de pull em Azure Repos
• Acompanhar trabalho com links e anexos