Introduction
GitHub Copilot peut examiner votre code et vous faire part de ses commentaires. Dans la mesure du possible, les commentaires de Copilot comprennent des suggestions de modifications que vous pouvez appliquer en quelques clics.
Copilot peut passer en revue le code écrit dans n’importe quel langage de programmation.
Cet article donne un aperçu de Révision du code Copilot. Pour savoir comment demander une révision de code à Copilot, consultez Utiliser la revue de code GitHub Copilot.
Disponibilité
Révision du code Copilot est pris en charge dans :
- GitHub.com
- GitHub Mobile
- VS Code
- Visual Studio
- Xcode
Révision du code Copilot est, avec une exception, une fonctionnalité premium, disponible avec les plans Copilot Pro, Copilot Pro+, Copilot Business et Copilot Enterprise.
L’exception est la révision d’une sélection de code au sein d’un fichier dans Visual Studio Code. Il s’agit d’une fonctionnalité standard disponible pour tous les utilisateurs Copilot dans VS Code.
Si vous recevez Copilot d’une organisation, pour pouvoir demander une révision de demande de tirage à partir de Copilot sur GitHub.com ou dans GitHub Mobile, l’option Révision du code Copilot doit être activée dans les paramètres de stratégie Copilot de l’organisation. Consultez Gestion des stratégies et des fonctionnalités de GitHub Copilot dans votre organisation.
Quota mensuel de revue
Lorsque vous assignez Copilot comme réviseur pour une demande de tirage (pull request), ou lorsque vous demandez à Copilot de réviser toutes vos modifications non validées dans votre IDE, votre quota mensuel de demandes de prime Copilot est réduit d'une unité. Pour plus d’informations sur les demandes premium, consultez Requêtes dans GitHub Copilot.
Si un référentiel est configuré pour demander automatiquement une revue de code à Copilot pour toutes les nouvelles demandes d'extraction, l'utilisation de la demande premium est appliquée au quota de l'auteur de la demande de tirage (pull request). Si une demande de tirage (pull request) est créée par GitHub Actions ou par un robot, l'utilisation s'appliquera à l'utilisateur qui a déclenché le flux de travail (s'il est identifiable), ou à un propriétaire de facturation désigné.
Lorsque vous aurez atteint votre quota mensuel, vous ne pourrez plus obtenir d'examen de code de la part de Copilot jusqu'à ce que votre quota soit réinitialisé, à moins que vous ne mettiez à jour votre plan Copilot ou que vous n'activiez des demandes supplémentaires premium.
Révision du code Copilot dans Visual Studio Code
Révision du code Copilot dans Visual Studio Code prend en charge deux types de révision :
- Vérifier la sélection :
- Mettez le code en surbrillance et demandez une première révision.
- Caractéristique standard de Copilot. Aucune demande Premium utilisée.
- Ne prend pas en charge les instructions personnalisées.
- Examiner les modifications :
- Demandez une révision plus approfondie de toutes vos modifications non validées.
- Fonctionnalité Premium. Utilise une requête Premium de votre quota mensuel par révision.
- Prend en charge les instructions personnalisées.
Fournir des instructions pour les revues Copilot
Vous pouvez personnaliser les revues générées par Copilot en fournissant des instructions personnalisées. Cela permet à Copilot de passer en revue le code d’une manière qui correspond aux normes, outils et pratiques de codage de votre équipe. Consultez « Ajout d’instructions personnalisées du référentiel pour GitHub Copilot » et « Ajout d’instructions personnalisées de l’organisation pour GitHub Copilot».
Validation des revues de code Copilot
Copilot n’est pas garanti pour repérer tous les problèmes dans une demande de tirage, et parfois il fera des erreurs. Validez toujours soigneusement les commentaires de Copilot et complétez les commentaires de Copilot par une révision humaine.
Pour plus d’informations, consultez « Utilisation responsable de la revue de code GitHub Copilot ».
À propos des révisions de demande de tirage (pull request) automatique
Par défaut, Copilot ne passera en revue une demande de tirage que si elle est affectée à la demande de tirage de la même manière que vous affecteriez un réviseur humain. Toutefois :
- Les utilisateurs individuels disposant du plan Copilot Pro ou Copilot Pro+ peuvent configurer Copilot pour passer automatiquement en revue toutes les demandes de tirage qu’ils créent.
- Les propriétaires de référentiels peuvent configurer Copilot pour passer automatiquement en revue toutes les demandes de tirage du référentiel qui sont créées par des personnes ayant accès à Copilot.
- Les propriétaires d’organisation peuvent configurer Copilot pour passer automatiquement en revue toutes les demandes de tirage dans certains ou tous les référentiels de l’organisation où la demande d'extraction est créée par un utilisateur Copilot.
Déclenchement d’une révision de demande de tirage automatique
Les déclencheurs de la revue automatique dépendent des paramètres de configuration :
- Paramètres de base :
- Lorsqu’une demande de tirage est créée en tant que demande de tirage « Ouverte ».
- La première fois qu’une demande de tirage « Brouillon » change de statut et devient « Ouverte ».
- Passer en revue les nouveaux envois :
- Chaque fois qu’un nouveau commit est envoyé sur la demande de tirage.
- Passer en revue les demandes de tirage brouillon :
- Les demandes de tirage sont automatiquement passées en revue lorsqu’elles sont encore à l’état de brouillon, avant d’être basculées en « Ouvertes ».
Remarque
À moins que Copilot ait été configuré pour passer en revue chaque envoi vers une demande de tirage, il ne passera en revue la demande de tirage qu’une seule fois. Si vous apportez des modifications à la demande de tirage après qu’elle a été automatiquement passée en revue et que vous souhaitez que Copilot repasse en revue la demande de tirage, vous devez en faire la demande manuellement. Pour ce faire, cliquez sur le bouton à côté du nom de Copilot dans le menu Réviseurs.
Limites d’une révision de demande de tirage automatique
Révision du code Copilot est une fonctionnalité Premium avec un quota mensuel par personne. Lorsque Copilot effectue une révision automatique, elle utilise une demande Premium du quota de l’utilisateur qui a créé la demande de tirage. Pour plus d’informations, consultez « Utiliser la revue de code GitHub Copilot ».
Configuration des révisions de demande de tirage (pull request) automatique
Pour savoir comment configurer Copilot pour examiner automatiquement les nouvelles demandes de tirage, consultez Configuration de la revue automatique du code par GitHub Copilot.