Usar GitHub Copilot com Azure Boards

Azure DevOps Services

Azure Boards integra-se com GitHub Copilot para simplificar seu fluxo de trabalho de desenvolvimento. Você pode usar itens de trabalho diretamente com Copilot, que cria ramificações automaticamente, implementa alterações de código e gera solicitações de pull de rascunho, mantendo seu item de trabalho atualizado com progresso.

Essa integração permite que você:

• Iniciar a codificação automatizada de itens de trabalho
• Acompanhar o progresso do GitHub Copilot diretamente no Azure DevOps
• Vincular automaticamente pull requests gerados e branches a itens de trabalho
• Monitorar quando as solicitações de pull de rascunho estão prontas para revisão

Pré-requisitos

Tipos de item de trabalho suportados

A integração GitHub Copilot dá suporte a qualquer tipo de item de trabalho nos requisitos e na categoria de tarefa, incluindo:

• Tipos de item de trabalho padrão: História do Usuário, Item de Lista de Pendências do Produto, Requisito, Tarefa, Bug, Problema
• Tipos de item de trabalho personalizados criados no modelo de processo

Esse suporte amplo significa que você pode usar GitHub Copilot com itens de trabalho de qualquer modelo de processo (Agile, Scrum, CMMI ou personalizado) em seu projeto Azure DevOps.

Iniciar GitHub Copilot a partir de itens de trabalho

1. Abra um item de trabalho que você deseja usar com GitHub Copilot.

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

   Se várias opções estiverem disponíveis, o botão se tornará um menu suspenso com opções diferentes.

   

3. Selecione Criar uma solicitação de pull com GitHub Copilot.

   

4. Selecione o repositório de GitHub de destino e o branch em que Copilot deve criar a solicitação de pull.

   Observação

   Somente repositórios do GitHub conectados por meio da autenticação de aplicativo do GitHub aparecem na lista de repositórios. não há suporte para Azure Repos.

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

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

   

O que acontece quando você começa Copilot

Quando você começa o Copilot a partir de um item de trabalho, os seguintes processos automatizados ocorrem:

• Data sharing: Azure DevOps compartilha 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 para o item de trabalho com GitHub Copilot.
• Validação de licença: Azure DevOps verifica sua licença do GitHub Copilot.
  • Se a validação falhar, uma opção Get a license aparecerá para comprar GitHub Copilot.
• Repository preparation: Copilot cria uma nova ramificação para o trabalho.
• Criação de solicitação de pull: uma solicitação de pull de rascunho é gerada automaticamente e vinculada ao item de trabalho.
• Atualizações de item de trabalho:
  • Um comentário é adicionado à discussão do item de trabalho.
  • O indicador de status aparece acima da seção Desenvolvimento.
  • Links de ramificação e pull request são adicionados automaticamente.
• Progress tracking: atualizações de status em tempo real mostram o progresso do Copilot.

Monitorar o progresso do GitHub Copilot

Indicadores de estado

Azure DevOps exibe Copilot status diretamente no item de trabalho com três estados possíveis:

• In Progress: Copilot está trabalhando ativamente em alterações de código.
• Pronto para Revisão: a solicitação de pull de rascunho está concluída e pronta para sua revisão.
• Erro: ocorreram problemas durante o processo de codificação (focalize para obter detalhes).

Indicadores da placa de circuito

Ao exibir itens de trabalho em seu quadro, você pode identificar o status do GitHub Copilot diretamente no cartão de item de trabalho. Um ícone do GitHub Copilot aparece no cartão e indica que o Copilot está trabalhando ou já concluiu o trabalho para esse item.

Esse indicador visual ajuda você a identificar rapidamente quais itens de trabalho têm operações de Copilot ativas sem abrir cada item de trabalho individual.

Atualizações da seção de desenvolvimento

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

• Ramo vinculado criado pelo Copilot.
• Solicitação de pull redigida com status em tempo real.
• Links diretos para examinar o código gerado no GitHub.

Revisar e mesclar a solicitação de pull

1. Selecione o link de solicitação de pull para examinar a implementação do Copilot no GitHub.

2. Se você estiver satisfeito com as alterações, converta o rascunho em uma solicitação de pull regular. A discussão do item de trabalho recebe atualizações automáticas sobre as alterações de status do pull request.

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

4. Conclua o processo de mesclagem em GitHub quando estiver pronto.

   • A confirmação de mesclagem é vinculada automaticamente ao item de trabalho.
   • Os links de ramificação são removidos se o ramo for excluído.
   • Os indicadores de status do Copilot ficam ocultos após a mesclagem bem-sucedida.

5. Após mesclar a solicitação de pull:

   1. Para indicar a conclusão, atualize o estado do item de trabalho.
   2. Verifique se a confirmação de mesclagem aparece na seção Desenvolvimento.
   3. Feche o item de trabalho se a implementação atender totalmente aos requisitos.

Para obter mais informações, consulte nosso módulo de treinamento, Get iniciado com GitHub Copilot.

Solucionar problemas

• Verifique os detalhes do erro: passe o mouse sobre o ícone de erro para obter informações específicas sobre o que deu errado.

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

  

• Intervenção manual: se necessário, faça alterações manuais na ramificação gerada e na solicitação de pull.

Problemas de licença

• Problema: falha na validação de licença.
• Solution: verifique se você tem uma assinatura de GitHub Copilot ativa e selecione Get a license se necessário.

Acesso ao repositório

• Problema: não é possível ver os repositórios esperados.
• Solução:
  • Verifique a conexão do aplicativo GitHub entre Azure DevOps e GitHub.
  • Verifique se você tem acesso a repositórios de GitHub (não Azure Repos).
  • Verifique as permissões do repositório e a autenticação do aplicativo GitHub.
  • Confirme se o repositório está conectado por meio da integração adequada do GitHub App.

Copilot Erros

• Problema: o agente de codificação encontra erros.
• Solution: examine os detalhes do erro, verifique as instruções de clareza e tente executar novamente Copilot.

Status não atualizado

• Problema: o status do progresso permanece paralisado.
• Solution: verifique o GitHub para obter o progresso real, pois as atualizações de status dependem dos relatórios do GitHub.

Práticas recomendadas

• Descrições claras de itens de trabalho: Forneça critérios de aceitação detalhados e contexto para melhores resultados do Copilot.
• Mantenha as alterações simples e concisas: quanto mais complexa e detalhada a descrição do item de trabalho, mais difícil é para o Copilot entender. Concentre-se em requisitos claros e específicos.
• Specific instructions: Adicionar diretrizes de implementação ao iniciar Copilot.
• Monitoramento regular: verifique o progresso periodicamente, especialmente para itens de trabalho complexos.
• Revisão rápida: revise e forneça comentários sobre solicitações de pull de rascunho rapidamente para manter o ritmo.
• Higiene adequada do item de trabalho: atualizar os estados do item de trabalho adequadamente durante todo o processo.

Limitações

Lembre-se das seguintes limitações ao usar GitHub Copilot com Azure Boards:

• Dependências: não há suporte para lidar com dependências entre itens de trabalho. Cada item de trabalho deve ser autossuficiente.
• Concurrent operations: não há suporte para gerenciar várias operações de Copilot simultâneas em diferentes itens de trabalho. Conclua uma operação Copilot antes de iniciar outra.
• Data sharing: somente o título do item de trabalho, campos de texto grandes, comentários e o link do item de trabalho são compartilhados com GitHub Copilot.
• Complexidade: descrições de itens de trabalho excessivamente complexas ou verbosas podem reduzir a eficácia do Copilot.

Conteúdo relacionado

• Vincular itens de trabalho a artefatos de desenvolvimento
• Configure a integração do GitHub
• Trabalho com solicitações de pull no Azure Repos
• Acompanhar o trabalho com links e anexos