Usar o GitHub Copilot com o Azure Boards

Serviços do Azure DevOps

O Azure Boards integra-se ao GitHub Copilot para simplificar seu fluxo de trabalho de desenvolvimento. Você pode usar itens de trabalho diretamente com o 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 o 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 do GitHub Copilot dá suporte a qualquer tipo de item de trabalho sob os requisitos e a 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 o GitHub Copilot com itens de trabalho de qualquer modelo de processo (Agile, Scrum, CMMI ou personalizado) em seu projeto do Azure DevOps.

Iniciar o GitHub Copilot a partir de itens de trabalho

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

2. No formulário do item de trabalho, selecione o ícone do 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 o GitHub Copilot.

   

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

   Observação

   Somente os repositórios do GitHub conectados por meio da autenticação do Aplicativo 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ê inicia Copilot

Ao iniciar o Copilot a partir de um item de trabalho, os seguintes processos automatizados ocorrem:

• Compartilhamento de dados: o 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 o GitHub Copilot.
• Validação de licença: o Azure DevOps verifica sua licença do GitHub Copilot.
  • Se a validação falhar, uma opção Obter uma licença aparecerá para comprar o GitHub Copilot.
• Preparação do repositório: Copilot cria um novo ramo 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.
• Acompanhamento de progresso: atualizações de status em tempo real mostram o progresso do Copilot.

Monitorar o progresso do GitHub Copilot

Indicadores de estado

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

• Em andamento: 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 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:

• Branch 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 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 no 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, Introdução ao 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.

• Executar Copilot novamente: selecione Executar Novamente 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.
• Solução: verifique se você tem uma assinatura ativa do GitHub Copilot e selecione Obter uma licença , 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 o Azure DevOps e o GitHub.
  • Verifique se você tem acesso aos repositórios do GitHub (não aos Repositórios do Azure).
  • 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 Aplicativo GitHub.

Erros de copilot

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

Status não atualizado

• Problema: o status do progresso permanece paralisado.
• Solução: verifique o progresso real do GitHub, pois as atualizações de status dependem do relatório do GitHub.

Práticas recomendadas

• Descrições de item de trabalho claras: 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.
• Instruções específicas: adicionar diretrizes de implementação ao iniciar o 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 o GitHub Copilot com o Azure Boards:

• Dependências: não há suporte para lidar com dependências entre itens de trabalho. Cada item de trabalho deve ser autossuficiente.
• Operações simultâneas: não há suporte para gerenciar várias operações simultâneas do Copilot em diferentes itens de trabalho. Conclua uma operação Copilot antes de iniciar outra.
• Compartilhamento de dados: 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 o GitHub Copilot.
• Complexidade: descrições de item de trabalho excessivamente complexas ou detalhadas podem reduzir a eficácia do Copilot.

Conteúdo relacionado

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