Configuration de la révision du code par GitHub Copilot

Introduction

Vous pouvez configurer Copilot code review pour examiner automatiquement les pull requests, et définir l’effort de révision de Copilot. Pour obtenir une vue d’ensemble, consultez À propos de la révision de code avec GitHub Copilot.

Configuration de la revue automatique de code pour vos propres pull requests

Vous pouvez configurer Copilot code review pour examiner les pull requests que vous créez, dans n’importe quel dépôt auquel Copilot code review vous avez accès.

1. Dans le coin supérieur droit de n’importe quelle page sur GitHub, cliquez sur votre photo de profil, puis sur Paramètres Copilot.
2. Dans la barre latérale, sous Copilot, cliquez sur Révision du code.
3. Activer Automatique Copilot code review.
4. Si vous le souhaitez, pour examiner chaque nouveau push d’une pull request que Copilot examine déjà, activez Examiner les nouveaux pushs.
5. Si vous le souhaitez, pour examiner les pull requests lorsqu’elles sont encore à l’état de brouillon, activez Examiner les pull requests en brouillon.

Une demande de tirage peut bénéficier d’une révision automatique à partir de plusieurs sources indépendantes : vos paramètres utilisateur, ensembles de règles de référentiel ou ensembles de règles d’organisation. Ces sources sont évaluées séparément. Si plusieurs sources s’appliquent, Copilot publie toujours une seule révision. Vos paramètres utilisateur ne peuvent pas désactiver les révisions push ou brouillons activées par un ensemble de règles. Pour plus d’informations, consultez « À propos de la révision de code avec GitHub Copilot ».

Configuration de votre Copilot effort de révision

Vous pouvez choisir le niveau d’effort Copilot de révision qu’utilise Copilot code review pour les révisions que vous demandez. Votre choix s’applique aux révisions automatiques et aux révisions que vous demandez manuellement. Pour une vue d’ensemble des niveaux et de la façon dont Copilot décide quel niveau utiliser, consultez À propos de la révision de code avec GitHub Copilot.

1. Dans le coin supérieur droit de n’importe quelle page sur GitHub, cliquez sur votre photo de profil, puis sur Paramètres Copilot.
2. Dans la barre latérale, sous Copilot, cliquez sur Révision du code.
3. En regard de « Niveau d’effort de révision », sélectionnez l’effort Copilot de révision pour les révisions que vous demandez.
   • Lite : Révision standard.
   • Équilibré : analyse plus approfondie de la logique complexe, du code sensible à la sécurité et des modifications interservices.
   • Max : Examen le plus approfondi. Cette option s’affiche avec une étiquette à venir et n’est pas encore disponible.

Pour revenir à la valeur par défaut intégrée, sélectionnez l’option Default en haut du menu. Jusqu’à ce que vous choisissiez un niveau spécifique, le contrôle affiche la valeur par défaut intégrée qui s’applique à vous, par défaut (Lite) ou Par défaut (équilibré).

Votre Copilot effort de révision est indépendant de Automatic Copilot code review. La désactivation de la révision automatique ne permet pas d’effacer votre Copilot effort de révision ou de l’empêcher de s’appliquer aux révisions que vous demandez manuellement.

Configuration de la révision automatique du code pour un référentiel

Vous pouvez activer les révisions de code automatiques pour un référentiel et personnaliser la façon dont les révisions de code sont effectuées.

Activation des révisions automatiques

1. Sur GitHub, accédez à la page principale du référentiel.

2. Sous le nom de votre référentiel, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

3. Dans la barre latérale gauche, sous « Code et automatisation », cliquez sur Ensembles de règles, puis sur Ensembles de règles.

4. Cliquez sur Nouveau jeu de données.

5. Cliquez sur Nouvel ensemble de règles de branche.

6. Sous « Nom de l’ensemble de règles », tapez un nom pour l’ensemble de règles.

7. Pour activer l’ensemble de règles, sous « État de l’application », sélectionnez Actif.

8. Sous « Branches cibles », cliquez sur Ajouter une cible et choisissez l’une des options, par exemple Inclure la branche par défaut ou Inclure toutes les branches.

9. Sous « Branches cibles », cliquez sur Ajouter une cible et choisissez l’une des options cibles.

10. Sous « Règles de branche », sélectionnez Demander Copilot code reviewautomatiquement .

11. Si vous le souhaitez, si vous voulez que Copilot examine tous les nouveaux push de la pull request, sélectionnez Examiner les nouveaux push.

    Si cette option n’est pas sélectionnée, Copilot n’examinera la pull request qu’une seule fois.

12. Si vous le souhaitez, pour que Copilot examine les pull requests alors qu’elles sont encore à l’état de brouillon, sélectionnez l’option Examiner les pull requests à l’état de brouillon.

    Cette option peut être utile pour détecter les erreurs à un stade précoce, avant de demander une révision humaine.

13. En bas de la page, cliquez sur Créer.

Personnalisation Copilot code review

Vous pouvez configurer la façon dont Copilot code review termine les revues de code dans votre dépôt.

1. Sur GitHub, accédez à la page principale du référentiel.

2. Sous le nom de votre référentiel, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

3. Dans la barre latérale, sous « Code, planification et automatisation », cliquez sur Copilot, puis Révision du code.

4. Pour choisir la profondeur des revues Copilot de code, à côté de « Niveau d’effort de révision », sélectionnez le niveau d’effort pour les revues automatiques dans ce dépôt.

   • Lite : Révision standard.
   • Équilibré : analyse plus approfondie de la logique complexe, du code sensible à la sécurité et des modifications interservices.

   Les vérifications équilibrées utilisent davantage de AI credits et peuvent nécessiter légèrement plus de GitHub Actions minutes. Consultez « À propos de la révision de code avec GitHub Copilot ».

5. Pour choisir si Copilot peut approuver les pull requests dans votre dépôt, configurez les paramètres dans la section « Approbation automatique ».

   • Autoriser Copilot à approuver les pull requests : activez cette option pour permettre à Copilot de soumettre des avis d’approbation.

   • Autoriser les approbations Copilot à être prises en compte dans les exigences de fusion : Activez cette option pour que les approbations Copilot puissent répondre aux exigences d’approbation des pull requests.

   • Chemins d’accès aux fichiers : si vous le souhaitez, limitez le nombre de demandes de tirage en fonction des exigences de fusion. Entrez un fichier glob par ligne pour compter les approbations uniquement sur les demandes de tirage où chaque fichier modifié correspond à l’un des globs. Laissez vide pour compter les approbations pour tous les fichiers. Jusqu’à 15 globs sont pris en charge.

   Remarque

   Copilot les approbations sont disponibles en préversion publique et sont susceptibles d’être modifiées.

Configuration de la revue automatique de code pour les dépôts d'une organisation

Vous pouvez activer les révisions de code automatiques pour les référentiels de votre organisation et personnaliser la façon dont les révisions de code sont effectuées.

Activation des révisions automatiques

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la barre latérale, sous « Code, planification et automatisation », cliquez sur Référentiel, puis sur Ensembles de règles.

5. Cliquez sur Nouveau jeu de données.

6. Cliquez sur Nouvel ensemble de règles de branche.

7. Sous « Nom de l’ensemble de règles », tapez un nom pour l’ensemble de règles.

8. Pour activer l’ensemble de règles, sous « État de l’application », sélectionnez Actif.

9. Sous « Référentiels cibles », cliquez sur Ajouter une cible et choisissez Inclure par modèle ou Exclure par modèle.

10. Tapez un modèle qui correspond aux noms de référentiels que vous souhaitez cibler( par exemple, *feature pour faire correspondre tous les référentiels avec des noms se terminant par feature.

    Pour la syntaxe de correspondance de modèles, consultez Création d'ensembles de règles pour les dépôts de votre organisation.

11. Cliquez sur Ajouter un modèle d’inclusion ou Ajouter un modèle d’exclusion.

12. Répétez pour tous les modèles supplémentaires.

    Remarque

    Vous pouvez ajouter plusieurs critères de ciblage au même ensemble de règles. Les modèles d’exclusion sont appliqués après les modèles d’inclusion. Par exemple, vous pouvez inclure tous les référentiels correspondant au modèle *cat* et exclure spécifiquement un référentiel correspondant au modèle not-a-cat.

13. Sous « Branches cibles », cliquez sur Ajouter une cible et choisissez l’une des options cibles.

14. Sous « Règles de branche », sélectionnez Demander Copilot code reviewautomatiquement .

15. Si vous le souhaitez, si vous voulez que Copilot examine tous les nouveaux push de la pull request, sélectionnez Examiner les nouveaux push.

    Si cette option n’est pas sélectionnée, Copilot n’examinera la pull request qu’une seule fois.

16. Si vous le souhaitez, pour que Copilot examine les pull requests alors qu’elles sont encore à l’état de brouillon, sélectionnez l’option Examiner les pull requests à l’état de brouillon.

    Cette option peut être utile pour détecter les erreurs à un stade précoce, avant de demander une révision humaine.

17. En bas de la page, cliquez sur Créer.

Personnalisation Copilot code review

Vous pouvez configurer la manière dont Copilot code review effectue des révisions de code dans les référentiels de votre organisation.

1. Dans le coin supérieur droit de GitHub, cliquez sur votre photo de profil, puis sur Vos organisations.

2. Sélectionnez une organisation en cliquant dessus.

3. Sous le nom de votre organisation, cliquez sur Settings. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la barre latérale, sous « Code, planification et automatisation », cliquez sur Copilot, puis Révision du code.

5. Pour choisir la profondeur des révisions de Copilot code, en regard de « Niveau d’effort de révision », sélectionnez le niveau d’effort par défaut pour les révisions automatiques dans les référentiels de votre organisation.

   • Lite : Révision standard.
   • Équilibré : analyse plus approfondie de la logique complexe, du code sensible à la sécurité et des modifications interservices.

   Les vérifications équilibrées utilisent davantage de AI credits et peuvent nécessiter légèrement plus de GitHub Actions minutes. Consultez « À propos de la révision de code avec GitHub Copilot ».

6. Pour choisir si Copilot peut approuver les demandes de tirage sur vos référentiels, sélectionnez une option sous « Approbations », à côté de « Compter les approbations de Copilot dans les exigences de fusion ».

   • Activé partout : Copilot les approbations peuvent être comptabilisées dans les exigences de fusion dans chaque référentiel de l’organisation.

   • Laisser les référentiels décider : les administrateurs de référentiel peuvent le décider dans les paramètres du référentiel.

   • Activer pour les référentiels sélectionnés : Copilot les approbations peuvent être comptabilisées dans les exigences de fusion uniquement dans les référentiels que vous sélectionnez. Si vous choisissez cette option, affectez également les référentiels pour lesquels vous souhaitez l’activer.

   • Désactivé partout : Copilot les approbations ne peuvent pas compter pour les exigences de fusion dans n’importe quel référentiel de l’organisation.

   Remarque

   Copilot les approbations sont disponibles en préversion publique et sont susceptibles d’être modifiées.

Configuration de la révision automatique du code pour une entreprise

Vous pouvez activer les révisions de code automatiques pour votre entreprise et personnaliser la façon dont les révisions de code sont effectuées.

Activation des révisions automatiques

1. Créez un ensemble de règles de branche au niveau de l’entreprise. Consultez « Application de la gouvernance du code dans votre entreprise avec des ensembles de règles ».
2. Sélectionnez les organisations et les référentiels où Copilot code review doit s’exécuter automatiquement.
3. Activez la stratégie de requête Copilot code reviewautomatique.
4. Si vous le souhaitez, activez les révisions automatiques pour les brouillons de pull requests et après chaque push sur une pull request.
5. Cliquez sur Créer.

Personnalisation Copilot code review

Vous pouvez configurer la façon dont Copilot code review effectue les revues de code pour votre entreprise.

1. Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
2. En haut de la page, cliquez sur AI controls.
3. Faites défiler jusqu’à « Agents disponibles », puis cliquez sur Copilot code review.
4. À côté de « Copilot code review », sélectionnez une politique.
5. Choisissez ensuite les Copilot code review fonctionnalités à activer pour votre entreprise.
6. Pour choisir si Copilot peut approuver les pull requests dans vos organisations, à côté de « Autoriser Copilot à approuver les pull requests », sélectionnez une politique.

   • Permettre aux organisations de décider : les propriétaires d’organisations peuvent choisir s’il faut activer Copilot les approbations.

   • Activer pour les organisations sélectionnées : Copilot les approbations sont activées uniquement pour les organisations que vous sélectionnez.

   • Désactivé partout : les organisations ne peuvent pas activer l’Copilotapprobation. Il s’agit de la valeur par défaut.

   Remarque

   Copilot les approbations sont disponibles en préversion publique et sont susceptibles d’être modifiées.