Démarrage avec la révision de code avec Copilot pour les demandes de tirage

Azure DevOps Services

Utilisez GitHub Copilot pour passer en revue les requêtes de tirage dans Azure Repos. Copilot agit en tant que réviseur automatisé qui publie des commentaires et des suggestions sur le code modifié, de sorte que vous recevez des commentaires avant qu’un réviseur humain ne se déconnecte.

Pour utiliser cette fonctionnalité, un administrateur de collection de projets l’active pour l’organisation, un administrateur de projet gère les paramètres par défaut au niveau du projet et les remplacements pour les dépôts, les administrateurs de dépôt configurent chaque dépôt lorsque les remplacements sont autorisés, et les utilisateurs individuels activent la fonctionnalité via les fonctionnalités en préversion (sauf si l’administrateur active cette préversion pour tous).

Prerequisites

Activer la révision du code avec Copilot

Au niveau de l’organisation

Un administrateur de collection de projets doit activer la révision de code Copilot pour l’organisation avant que les propriétaires de projet puissent l’activer pour des projets et des référentiels individuels.

Si vous sélectionnez l’option Activer tout au niveau de l’organisation, la révision de code Copilot est activée pour chaque projet de l’organisation et chaque dépôt dans ces projets. Vous n’avez pas besoin d’activer chaque projet ou référentiel individuellement.

1. Connectez-vous à votre organisation Azure DevOps (https://dev.azure.com/{yourorganization}).

2. Sélectionnez Paramètres d’organisation>Repos>Repositories.

3. Sous Révision du code GitHub Copilot, définissez Autoriser les référentiels de cette organisation à utiliser la révision du code GitHub Copilot sur Activé.

   

Au niveau du projet

Une fois l’accès au niveau de l’organisation activé, un administrateur Project peut éventuellement activer la fonctionnalité au niveau project. Cette option offre un contrôle granulaire permettant de déterminer quels projets de l’organisation peuvent utiliser la révision de code Copilot.

Si vous sélectionnez l’option Activer tout au niveau du projet, la révision de code Copilot est activée pour chaque dépôt de ce projet. Vous n’avez pas besoin d’activer chaque dépôt individuellement.

1. Sélectionnez Project paramètres>Repos>Repositories.

2. Sous GitHub Copilot code review, basculez Activer la revue de code Copilot pour ce projet sur Activé.

   

   Ce paramètre s’applique à tous les référentiels du projet, sauf substitution au niveau du référentiel. Vous pouvez toujours activer ou désactiver la fonctionnalité pour les dépôts individuels en fonction des besoins.

Au niveau du référentiel

Après avoir activé l’accès au niveau de l’organisation (et éventuellement l’accès au niveau du projet), un propriétaire du référentiel active Copilot révision de code pour chaque référentiel qui doit l’utiliser.

1. Sélectionnez Project paramètres>Repos>Repositories.

2. Sélectionnez le référentiel que vous souhaitez activer.

3. Dans l’onglet Settings, basculez Activer la vérification du code Copilot pour les pull requests dans ce dépôt sur On.

   

Pour vérifier que la fonctionnalité est activée, ouvrez n’importe quelle pull request dans le dépôt. GitHub Copilot doit maintenant apparaître en tant que réviseur disponible dans la liste Reviewers.

Configurer la révision du code avec Copilot

Après avoir activé la fonctionnalité aux trois niveaux, vous pouvez configurer la façon dont Copilot examine les pull requests de vos dépôts.

Configurer l’effort de révision par défaut

Le niveau d’effort de révision détermine à quel point Copilot analyse une pull request. Un administrateur de projet définit l’effort par défaut pour tous les dépôts d’un projet et détermine si les administrateurs de référentiel peuvent le remplacer. Les utilisateurs peuvent sélectionner un niveau d’effort différent pour une révision individuelle sans modifier le projet ou le dépôt par défaut.

Les niveaux d’effort plus élevés consomment généralement plus de jetons et peuvent augmenter le coût d’une révision. Pour plus d’informations, consultez Facturation.

Définir la valeur par défaut du projet

1. Sélectionnez Project paramètres>Repos>Repositories.

2. Sous Revue de code GitHub Copilot, sélectionnez une option dans Niveau d’effort par défaut.

3. Pour permettre aux administrateurs de référentiel de définir une valeur par défaut différente, sélectionnez Autoriser les dépôts individuels à définir leur propre niveau d’effort par défaut. Désactivez cette option pour exiger que tous les référentiels utilisent le projet par défaut.

   

Définir un référentiel par défaut

Si le projet autorise les remplacements de référentiel, un administrateur de référentiel peut définir une valeur par défaut différente :

1. Sélectionnez Project paramètres>Repos>Repositories.
2. Sélectionnez le référentiel, puis sélectionnez l’onglet Paramètres .
3. Sous Revue de code GitHub Copilot, sélectionnez une option dans Niveau d’effort par défaut.

Si le projet n’autorise pas les remplacements de référentiel, le niveau d’effort par défaut est en lecture seule et affiche le paramètre de projet hérité.

Configurer des stratégies de révision automatique

Copilot peut examiner automatiquement les nouvelles pull requests sans qu’aucune demande manuelle ne soit nécessaire. Vous pouvez configurer cette stratégie pour tous les dépôts d’un projet ou pour des dépôts individuels.

L’activation des fonctionnalités et la révision automatique sont des paramètres distincts. L’activation de la révision du code avec Copilot la rend disponible pour un dépôt. Une règle de révision automatique demande une révision par Copilot lorsqu’une nouvelle pull request est créée.

Configurer la révision automatique pour tous les référentiels d’un projet

Utilisez la stratégie définie au niveau du projet pour demander automatiquement des révisions Copilot dans tous les référentiels du projet. Vous n’avez pas besoin de configurer la stratégie pour chaque dépôt individuellement.

1. Sélectionnez Project paramètres>Repos>Repositories.

2. Sous Révision de code GitHub Copilot, activez Demander automatiquement une révision de code Copilot pour les nouvelles pull requests de tous les référentiels de ce projet sur Activé.

   Ce paramètre s’applique à tous les référentiels du projet, sauf si une stratégie au niveau du dépôt la remplace.

Configurer la révision automatique pour un référentiel

Utilisez la stratégie au niveau du référentiel lorsque vous avez besoin d’un comportement spécifique au référentiel.

1. Sélectionnez Project paramètres>Repos>Repositories.

2. Sélectionnez le référentiel que vous souhaitez configurer.

3. Dans l’onglet Paramètres, sous Révision du code GitHub Copilot, basculez Demander automatiquement la révision du code par Copilot sur les nouvelles pull requests sur Activé.

4. (Facultatif) Configurer l’étendue de révision :

   • S’applique à toutes les demandes de tirage : Copilot examine chaque nouvelle demande de tirage dans le dépôt.
   • S’appliquent à des stratégies de branche spécifiques : Copilot passe en revue uniquement les pull requests qui ciblent des branches définies (par exemple, main ou develop).

   Priorité de la stratégie pour les révisions automatiques :

   • La stratégie de révision automatique au niveau du projet s’applique à tous les référentiels du projet.
   • Les paramètres de révision automatique au niveau du référentiel remplacent la valeur par défaut au niveau du projet pour ce référentiel.

Lorsque vous activez la révision automatique, Copilot commence à passer en revue les nouvelles pull requests dès leur création. Vous pouvez toujours demander manuellement des révisions supplémentaires en sélectionnant Demander à côté de GitHub Copilot dans la pull request.

Sélectionner un pool d’agents

La révision de code Copilot exécute des tâches de révision en utilisant un pool d’agents Azure Pipelines. Par défaut, il utilise le pool de Azure Pipelines par défaut dans votre organisation.

Certaines organisations désactivent le pool de Azure Pipelines par défaut. Dans cette configuration, la révision de code Copilot ne peut pas s'exécuter tant que vous n'avez pas sélectionné un pool alternatif pris en charge.

Si votre organisation a configuré un pool DevOps managé, vous pouvez le sélectionner pour exécuter Copilot révision du code au lieu du pool par défaut.

Lors de la sélection d’une image pour le pool DevOps managé, veillez à sélectionner la dernière.Ubuntu Server

Les images Windows ne sont pas prises en charge pour Copilot Code Reviews. Ne mélangez pas votre pool avec les agents Ubuntu et Windows.

1. Sélectionnez Paramètres d’organisation>Repos>Repositories.

2. Sous Révision du code GitHub Copilot, sélectionnez Groupe de calcul dans le menu déroulant.

   La configuration du pool de calcul de votre organisation détermine les pools disponibles. Si aucun pool n’est disponible, contactez l’administrateur de votre organisation.

3. Cliquez sur Enregistrer.

Le pool sélectionné traite toutes les révisions de code Copilot pour les dépôts de votre organisation. Vous pouvez modifier ce paramètre à tout moment. Pour utiliser différents pools pour différents projets ou référentiels, configurez les affectations de pool via des pools DevOps managés.

Personnaliser le comportement de révision de Copilot

Pour obtenir des conseils sur l'utilisation d'instructions personnalisées et de compétences d'agent pour adapter les commentaires de révision de code de Copilot, consultez Configurer Copilot instructions de révision de code.

Utiliser la révision du code avec Copilot

Lorsque la fonctionnalité est activée aux trois niveaux, vous pouvez demander à Copilot d’examiner une pull request. Les sections suivantes décrivent ce qu’il faut attendre.

Demander une révision

Par défaut, GitHub Copilot passe en revue une pull request uniquement si vous le demandez :

1. Ouvrir une demande de tirage.

2. Dans la section Réviseurs, utilisez l’une des options suivantes en regard de GitHub Copilot :

   • Pour utiliser le niveau d’effort par défaut du référentiel, sélectionnez Demande.
   • Pour utiliser un niveau d’effort différent pour cette révision, ouvrez le menu déroulant en regard de Demander et sélectionnez un niveau d’effort.

3. Attendez la fin de la révision. La révision peut prendre quelques instants, en fonction de la taille du référentiel et du nombre de modifications apportées à la demande de tirage. Une fois la révision terminée, l’état passe à Révision terminé.

   

Si Copilot identifie des problèmes potentiels, il y ajoute des commentaires et des suggestions directement dans la pull request afin que vous puissiez les examiner et les résoudre.

Le niveau d’effort sélectionné s’applique uniquement à cette révision. Azure DevOps enregistre le demandeur et le niveau d’effort dans l’activité de la pull request.

Lire les commentaires de Copilot

• Copilot publie ses retours en tant que réviseur standard nommé GitHub Copilot sur la pull request.
• Chaque commentaire apparaît sur la ligne de code à laquelle il s’applique et, le cas échéant, inclut une modification suggérée que vous pouvez appliquer en un clic.
• Copilot laisse toujours un Comment. Il n’approuve jamais la pull request et ne demande jamais de modifications ; sa revue ne satisfait donc pas aux règles de réviseurs obligatoires et n’empêche pas la fusion.
• les commentaires de Copilot se comportent comme des commentaires d'un réviseur humain. Vous pouvez y répondre, y réagir, les résoudre ou les masquer. Copilot ne lit pas les réponses et ne suit pas.

Réexécriture après de nouvelles validations

Copilot ne réexamine pas automatiquement une pull request lorsque vous poussez de nouveaux commits. Pour obtenir une nouvelle révision après une validation, sélectionnez Request à côté de GitHub Copilot dans la liste Reviewers.

Annuler une révision en cours

Si une révision de code prend plus de temps que prévu ou si vous devez l’arrêter, vous pouvez annuler l’exécution de la révision.

1. Ouvrez la pull request que Copilot est en train d’examiner.
2. Dans la section Réviseurs, en regard de GitHub Copilot, sélectionnez le bouton Annuler (ou sélectionnez Autres options>Annuler la révision).
3. Confirmez l’annulation lorsque vous y êtes invité.

Le cycle de révision s’arrête immédiatement et aucun commentaire supplémentaire n’est ajouté. Les résultats de la révision partielle, y compris les commentaires ajoutés avant l’annulation, restent dans la pull request. Vous pouvez demander une nouvelle révision à tout moment.

Exigences et limites

Les exigences et limites suivantes s’appliquent pendant la préversion et peuvent changer.

Copilot examine une pull request uniquement lorsqu’elle remplit les conditions suivantes :

Ces limites de concurrence et de débit s’appliquent également :

Billing

Chaque révision de code terminée consomme des jetons, y compris les jetons d’entrée que vous envoyez au modèle, les jetons de sortie générés par le modèle et les jetons mis en cache qui réutilisent le contexte existant. Les jetons utilisés pour chaque révision sont convertis en unité de facturation standard appelée GitHub crédit IA, où 1 crédit est égal à 0,01 USD.

L’effort de révision sélectionné affecte la consommation. Les niveaux d’effort plus élevés analysent généralement plus de contexte et consomment plus de jetons que les niveaux d’effort inférieurs. La taille des pull requests, les instructions personnalisées du dépôt et les modifications du modèle peuvent également affecter la consommation. Pour connaître les plages de référence et les mises en garde actuelles, consultez La consommation estimée.

Pour obtenir des réponses aux questions fréquentes sur la facturation et les coûts de la révision de code Copilot, consultez Résoudre les problèmes liés à la révision de code Copilot.

Les frais vont à l’abonnement Azure lié à votre organisation Azure DevOps et apparaissent sous la forme d’un compteur distinct dans Gestion des coûts Azure. Pour estimer les coûts attendus dans votre environnement, activez la fonctionnalité pour un ou deux référentiels, comparez les niveaux d’effort d’examen et surveillez l’utilisation quotidienne.

Les frais de révision du code Copilot dans Gestion des coûts Azure incluent désormais les balises de projet Azure DevOps, permettant la création de rapports sur les coûts par projet. Vous pouvez filtrer ou regrouper l’analyse des coûts par ces balises de projet pour attribuer l’utilisation et dépenser à des projets Azure DevOps individuels.

Pour surveiller vos frais quotidiens :

1. Dans le portail Azure, accédez à votre abonnement.

2. Sélectionnez Gestion des coûts>Analyse des coûts.

3. Filtrez par produit pour afficher les coûts quotidiens de l’organisation. Pour afficher les coûts d’un projet spécifique, ajoutez un filtre ou regroupez par la balise de projet Azure DevOps.

   

Définir une alerte budgétaire

Créez un budget Azure qui vous avertit lorsque les dépenses atteignent un seuil que vous définissez. Les budgets vous notifient uniquement. Ils n’arrêtent pas les révisions ni ne modifient aucune ressource. Vous avez besoin d’un accès Propriétaire, Contributeur ou Contributeur Cost Management sur l’abonnement lié à votre organisation Azure DevOps.

1. Dans le portail Azure, ouvrez l’abonnement lié à votre organisation Azure DevOps.

2. Sélectionnez Gestion des coûts>Budgets, puis sélectionnez Ajouter.

3. Sous Filtres, ajoutez un filtre pour Product et sélectionnez GitHub Copilot pour AzDO.

   

4. Si l’abonnement est lié à plusieurs organisations Azure DevOps, ajoutez un filtre pour Tag et sélectionnez les balises correspondant aux noms des organisations que vous souhaitez cibler avec l’alerte. Si des balises de projet sont présentes, vous pouvez également filtrer ou regrouper par balise de projet pour créer des alertes budgétaires au niveau du projet.

5. Entrez un nom de budget, choisissez une période de réinitialisation et une date d’expiration, définissez le montant du budget, puis sélectionnez Suivant.

6. Ajoutez un ou plusieurs seuils d’alerte en pourcentage du budget (par exemple, 75% et 90%), définissez Type sur Réel ou Prévision, puis entrez les adresses e-mail à notifier.

7. Cliquez sur Créer.

   

Lorsque les dépenses atteignent un seuil, Azure envoie un e-mail dans une heure de l’évaluation suivante. Pour consulter les alertes déclenchées, sélectionnez Cost Management>Alertes de coût. Pour éviter que les e-mails d’alerte n’arrivent dans votre dossier de courrier indésirable, ajoutez azure-noreply@microsoft.com à vos expéditeurs autorisés. Pour plus d’informations, consultez Créer et gérer des budgets.

Désactiver la révision de code Copilot

Pour cesser d’utiliser la révision de code Copilot, réglez le bouton bascule sur Désactivé pour l'étendue que vous souhaitez désactiver :

• Pour un seul utilisateur : désactivez l’option Fonctionnalités en préversion dans vos paramètres utilisateur.
• Pour un dépôt : désactivez le bouton bascule du dépôt dans Paramètres du projet>Dépôts>Dépôts.
• Pour l’ensemble de l’organisation : désactivez le bouton bascule de l’organisation dans Paramètres de l’organisation>Référ>Référentiels. Cette action désactive la fonctionnalité pour tous les référentiels.

Partager des commentaires

Pour signaler des problèmes ou partager des commentaires sur cette préversion, visitez le Azure DevOps Developer Community.

Résoudre les problèmes de révision de code Copilot

Pour obtenir des réponses aux questions courantes sur la facturation, la gestion des données, la conformité et la résolution des problèmes liés aux instructions personnalisées, consultez Résoudre les problèmes de révision de code avec Copilot.

Étape suivante

Contenu connexe

• Résoudre les problèmes liés à la révision du code par Copilot
• Configurer des instructions de révision de code Copilot
• À propos de la révision du code avec GitHub Copilot
• À propos des pull requests
• Paramètres et stratégies du référentiel