Utiliser GitHub Copilot avec Azure Boards

Azure DevOps Services

Azure Boards s’intègre à GitHub Copilot pour simplifier votre flux de travail de développement. Vous pouvez utiliser des tâches directement avec Copilot, qui crée automatiquement des branches, implémente des modifications de code et génère des pull requests provisoires tout en gardant votre tâche mise à jour avec la progression.

Cette intégration vous permet de :

• Lancer le codage automatisé à partir d’éléments de travail
• Suivre la progression de GitHub Copilot directement dans Azure DevOps
• Lier automatiquement les pull requests et les branches générées aux éléments de travail
• Suivre quand les pull requests en brouillon sont prêtes à la révision

Prerequisites

Types d’éléments de travail pris en charge

L’intégration de GitHub Copilot prend en charge n’importe quel type d’élément de travail dans la catégorie des tâches et des exigences, notamment :

• Types d’éléments de travail standard : article utilisateur, élément de backlog de produit, exigence, tâche, bogue, problème
• Types d’éléments de travail personnalisés que vous avez créés dans votre modèle de processus

Cette prise en charge étendue signifie que vous pouvez utiliser GitHub Copilot avec des éléments de travail à partir de n’importe quel modèle de processus (Agile, Scrum, CMMI ou personnalisé) dans votre projet Azure DevOps.

Démarrer GitHub Copilot à partir d’éléments de travail

1. Ouvrez un élément de travail que vous souhaitez utiliser avec GitHub Copilot.

2. Dans le formulaire d’élément de travail, sélectionnez l’icône GitHub.

   Si plusieurs options sont disponibles, le bouton devient un menu déroulant avec différents choix.

   

3. Sélectionnez Créer une pull request avec GitHub Copilot.

   

4. Sélectionnez le référentiel GitHub cible et la branche où Copilot doit créer le pull request.

   Note

   Seuls les référentiels GitHub connectés via l’authentification GitHub App apparaissent dans la liste des référentiels. Azure Repos n’est pas pris en charge.

5. (Facultatif) Ajoutez des instructions spéciales pour guider l’approche d’implémentation de Copilot. Par exemple, vous pouvez ajouter « Créer README avec des instructions d’installation ».

6. Sélectionnez Créer pour commencer le processus de codage automatisé.

   

Que se passe-t-il quand vous démarrez Copilot

Lorsque vous démarrez Copilot à partir d’un élément de travail, les processus automatisés suivants se produisent :

• Partage de données : Azure DevOps partage le titre de l’élément de travail, les champs de texte volumineux (tels que les critères de description et d’acceptation), les commentaires et un lien vers l’élément de travail avec GitHub Copilot.
• Validation de licence : Azure DevOps vérifie votre licence GitHub Copilot.
  • En cas d’échec de la validation, une option Obtenir une licence s’affiche pour acheter GitHub Copilot.
• Préparation du référentiel : Copilot crée une branche pour le travail.
• Création d’une pull request : une pull request de brouillon est automatiquement générée et liée à votre élément de travail.
• Mises à jour des éléments de travail :
  • Un commentaire est ajouté à la discussion sur l’élément de travail.
  • L’indicateur d’état apparaît au-dessus de la section Développement.
  • Les liens des branches et des pull requests sont automatiquement ajoutés.
• Suivi de la progression : les mises à jour d’état en temps réel indiquent la progression de Copilot.

Surveiller la progression de GitHub Copilot

Indicateurs d’état

Azure DevOps affiche l’état Copilot directement sur votre élément de travail avec trois états possibles :

• En cours : Copilot travaille activement sur les modifications du code.
• Prêt à l’examen : la pull request brouillon est terminée et prête pour votre examen.
• Erreur : des problèmes se sont produits pendant le processus de codage (pointez pour plus d’informations).

Indicateurs de cartes du tableau

Lorsque vous affichez des éléments de travail sur votre tableau, vous pouvez identifier l’état GitHub Copilot directement sur la carte d’élément de travail. Une icône GitHub Copilot s’affiche sur la carte et indique que Copilot travaille ou a terminé le travail pour cet élément.

Cet indicateur visuel vous aide à identifier rapidement les éléments de travail qui ont des opérations Copilot actives sans ouvrir chaque élément de travail individuel.

Mises à jour de la section Développement

La section Développement de votre élément de travail affiche automatiquement :

• Branche liée créée par Copilot.
• Pull request en brouillon avec statut en temps réel.
• Liens directs pour passer en revue le code généré dans GitHub.

Réviser et fusionner la pull request

1. Sélectionnez le lien de la pull request pour examiner l’implémentation de Copilot sur GitHub.

2. Si vous êtes satisfait des modifications, convertissez le brouillon en pull request courante. La discussion sur l'élément de travail reçoit des mises à jour automatiques concernant les modifications d’état des pull requests.

3. Utilisez l’interface de GitHub pour passer en revue, commenter et approuver le code généré.

4. Terminez le processus de fusion dans GitHub lorsque vous êtes prêt.

   • La validation de fusion est automatiquement liée à votre élément de travail.
   • Les liens de branche sont supprimés si la branche est supprimée.
   • Les indicateurs d’état copilot sont masqués après la fusion réussie.

5. Une fois le pull request fusionné :

   1. Pour refléter l’achèvement, mettez à jour l’état de votre élément de travail.
   2. Vérifiez que la validation de fusion s’affiche dans la section Développement.
   3. Fermez l’élément de travail si l’implémentation répond entièrement aux exigences.

Pour plus d’informations, consultez notre module de formation, Bien démarrer avec GitHub Copilot.

Résoudre les problèmes

• Vérifiez les détails de l’erreur : pointez sur l’icône d’erreur pour obtenir des informations spécifiques sur ce qui s’est passé.

• Réexécutez Copilot : sélectionnez Réexécuter Copilot pour tenter à nouveau le processus avec les mêmes instructions ou modifiées.

  

• Intervention manuelle : si nécessaire, apportez des modifications manuelles à la branche générée et à la Pull Request.

Problèmes de licences

• Problème : échec de la validation de la licence.
• Solution : Vérifiez que vous disposez d’un abonnement GitHub Copilot actif et sélectionnez Obtenir une licence si nécessaire.

Accès au dépôt

• Problème : Impossible de voir les référentiels attendus.
• Solution :
  • Vérifiez la connexion d’application GitHub entre Azure DevOps et GitHub.
  • Vérifiez que vous avez accès aux référentiels GitHub (et non à Azure Repos).
  • Vérifiez les autorisations du référentiel et l’authentification d’application GitHub.
  • Vérifiez que le référentiel est connecté via l’intégration appropriée de l’application GitHub.

Les erreurs de Copilot

• Problème : l’agent de codage rencontre des erreurs.
• Solution : passez en revue les détails de l’erreur, vérifiez les instructions pour plus de clarté et essayez de réexécuter Copilot.

État non mis à jour

• Problème : l’état de progression reste bloqué.
• Solution : vérifiez la progression réelle de GitHub, car les mises à jour d’état dépendent des rapports GitHub.

Meilleures pratiques

• Description claire des éléments de travail : fournissez des critères d’acceptation détaillés et un contexte pour de meilleurs résultats Copilot.
• Conservez les modifications simples et concises : plus votre description d’élément de travail est complexe et détaillée, plus il est difficile pour Copilot de comprendre. Concentrez-vous sur des exigences claires et spécifiques.
• Instructions spécifiques : Ajoutez des instructions d’implémentation lors du démarrage de Copilot.
• Surveillance régulière : vérifiez régulièrement la progression, en particulier pour les éléments de travail complexes.
• Révision rapide : passez en revue les pull requests en cours et fournissez des retours rapidement pour maintenir l'élan.
• Hygiène appropriée des éléments de travail : Mettez à jour les états d’élément de travail de manière appropriée tout au long du processus.

Limites

Tenez compte des limitations suivantes lors de l’utilisation de GitHub Copilot avec Azure Boards :

• Dépendances : la gestion des dépendances entre les éléments de travail n’est pas prise en charge. Chaque élément de travail doit être autonome.
• Opérations simultanées : la gestion de plusieurs opérations Copilot simultanées sur différents éléments de travail n’est pas prise en charge. Effectuez une opération Copilot avant de commencer une autre.
• Partage de données : seul le titre de l’élément de travail, les champs de texte volumineux, les commentaires et le lien d’élément de travail sont partagés avec GitHub Copilot.
• Complexité : des descriptions d’éléments de travail trop complexes ou détaillées peuvent réduire l’efficacité de Copilot.

Contenu connexe

• Lier des éléments de travail à des artefacts de développement
• Configurer l’intégration de GitHub
• Travailler avec les pull requests dans Azure Repos
• Suivi du travail avec des liens et des pièces jointes