Présentation
révision du code Copilot examine le code écrit dans n’importe quelle langue et fournit des commentaires. Il examine votre code sous plusieurs angles pour identifier les problèmes et suggérer des correctifs. Vous pouvez appliquer des modifications suggérées en quelques clics.
Cet article fournit une vue d’ensemble de révision du code Copilot. Pour savoir comment demander une révision de code à partir de Copilot, consultez Utilisation de GitHub Copilot pour la révision de code.
Disponibilité
révision du code Copilot est pris en charge dans :
- GitHub.com
- GitHub CLI
- GitHub Mobile
- VS Code
- Visual Studio
- Xcode
- IDE JetBrains
Remarque
Si vous recevez Copilot d’une organisation, votre organisation doit activer l’option révision du code Copilot dans les paramètres de Copilot stratégie. Cela s'applique aux évaluations portant sur GitHub.com ou concernant GitHub Mobile. Consultez Gestion des stratégies et des fonctionnalités pour GitHub Copilot dans votre organisation.
révision du code Copilot sans Copilot licence
Les membres de l’organisation sans Copilot licence peuvent utiliser révision du code Copilot sur GitHub.com. Un administrateur d’entreprise ou un propriétaire de l’organisation doit l’activer. Cette fonctionnalité est disponible pour les organisations sur Copilot Business et Copilot Entreprise plans.
Activation de la révision du code pour les utilisateurs sans licence
Pour autoriser les membres de l’organisation sans Copilot licence à utiliser révision du code Copilot, vous devez activer deux stratégies :
- ** AI credits utilisation payante**. Activez d’abord cette stratégie. Elle permet à l’entreprise ou à l’organisation de se voir facturer l’utilisation de révision du code CopilotAI credits.
- Autoriser les membres sans Copilot licence à utiliser révision du code Copilot dans GitHub.com. Cette sous-stratégie active révision du code Copilot pour les utilisateurs sans licence.
La deuxième stratégie présente les caractéristiques suivantes :
- Il est désactivé par défaut.
- Une fois que cette stratégie est définie au niveau de l’entreprise, elle devient visible, mais n’est pas modifiable au niveau de l’organisation.
- La stratégie est la plus restrictive. révision du code Copilot est disponible uniquement dans les référentiels où vous activez explicitement la stratégie.
Fonctionnement pour les utilisateurs sans licence
Lorsque les deux stratégies sont activées, les utilisateurs sans licence Copilot peuvent demander une révision à révision du code Copilot sur leurs pull requests dans les dépôts de l’organisation.
Dans les dépôts où la révision automatique du code est activée, Copilot examine automatiquement toutes les pull requests. Cela se produit, que l’auteur en dispose ou non d’une Copilot licence.
révision du code Copilot pour les utilisateurs dépourvus de licence n’est pas disponible dans les environnements de développement intégré.
Fichiers exclus
Certains types de fichiers sont exclus de révision du code Copilot.
- Fichiers de gestion des dépendances, tels que package.json et Gemfile.lock
- Fichiers de logs
- Fichiers SVG
Si vous incluez ces types de fichiers dans une demande de fusion, révision du code Copilot ne passera pas en revue les fichiers.
Pour plus d’informations, consultez « Fichiers exclus de GitHub Copilot révision du code ».
Fonctionnalités agentiques pour révision du code Copilot
Remarque
révision du code Copilot dispose de fonctionnalités en préversion publique susceptibles d’évoluer. Les GitHub – Termes du Contrat de licence de la préversion s’appliquent à votre utilisation des fonctionnalités en préversion.
révision du code Copilot utilise des fonctionnalités agentiques pour étendre ses fonctionnalités.
- Collecte complète du contexte de projet. Cela fournit des révisions de code plus spécifiques, précises et contextuelles. Cette fonctionnalité analyse l’ensemble de votre référentiel pour mieux comprendre le contexte des modifications de code. La collecte complète du contexte de projet est généralement disponible.
- La possibilité de transmettre des suggestions à Agent cloud Copilot. Cela automatise la création d'une nouvelle pull request pour votre branche en appliquant les correctifs suggérés. La transmission de suggestions à Agent cloud Copilot est en préversion publique et susceptible de changer.
Ces fonctionnalités sont activées automatiquement pour les forfaits Copilot Pro, Copilot Pro+ et Copilot Max.
Si GitHub Actions n’est pas disponible ou si les workflows Actions utilisés par révision du code Copilot échouent, les révisions sont toujours générées. Toutefois, ils n’incluront pas les fonctionnalités supplémentaires fournies par les fonctionnalités agentiques.
Utilisation des GitHub Actions exécuteurs pour les fonctionnalités agentiques dans la révision du code
révision du code Copilot utilise GitHub Actions pour exécuter les fonctionnalités agentiques, notamment la collecte complète du contexte du projet et toutes les fonctionnalités dans préversion publique. Par défaut, révision du code Copilot utilise des exécuteurs standard GitHub hébergés. Vous pouvez également effectuer une mise à niveau vers des exécuteurs de plus grande capacité GitHub hébergés pour une performance améliorée, ou utiliser des exécuteurs hébergés par vous-même.
Remarque
L’utilisation de plus grands GitHubexécuteurs hébergés est facturée à un taux plus élevé par minute. Les agents auto-hébergés ne consomment pas de GitHub Actions minutes.
Vous n’avez pas besoin d’avoir GitHub Actions activé dans votre organisation ou votre entreprise pour utiliser les fonctionnalités agentiques dans la révision du code.
Si votre organisation a désactivé GitHubles exécuteurs hébergés, les fonctionnalités agentiques ne seront pas disponibles. Dans ce cas, les révisions de code reviennent à une révision plus limitée. Les organisations dans cette situation peuvent utiliser des runners auto-hébergés.
Pour plus d’informations sur la configuration des exécuteurs, consultez Configuration des exécuteurs pour la révision du code GitHub Copilot.
Vous pouvez afficher les GitHub Actions minutes associées aux révision du code Copilot exécutions. Pour plus d’informations, consultez GitHub Actions les minutes de révision du code.
Utilisation de la révision du code
Chaque fois que Copilot passe en revue une pull request ou du code dans votre IDE, l’interaction consomme AI credits. La quantité dépend du modèle utilisé et du nombre de jetons traités.
Les révisions de code ont deux composants de coût : AI credits pour l’interaction du modèle (la révision elle-même) et GitHub Actions les minutes pour les fonctionnalités agentiques (collecte de contexte et utilisation de l’outil). Pour plus d’informations sur l’utilisation de GitHub Actions, consultez Utilisation des exécuteurs GitHub Actions pour les capacités agentiques dans la revue de code.
Si un dépôt est configuré pour demander automatiquement une révision de code à Copilot pour toutes les nouvelles pull requests, la consommation de AI credits est attribuée à l’auteur de la pull request. Si une révision est demandée manuellement par un autre utilisateur, la consommation est attribuée à cet utilisateur à la place.
Si une demande de tirage (pull request) est créée par GitHub Actions ou par un bot, l'utilisation s'appliquera à :
- Utilisateur qui a déclenché le flux de travail, si cet utilisateur peut être identifié.
- Propriétaire de facturation désigné.
Que se passe-t-il lorsqu’un budget est atteint
Pour Copilot Business et Copilot Entreprise, l’accès à la révision du code est régi par les contrôles budgétaires. Si un utilisateur atteint son budget utilisateur, ou si la limite de dépenses de l’entreprise ou du centre de coûts est épuisée, les revues de code sont bloquées, ainsi que les autres fonctionnalités consommatrices de AI credits. Consultez Budgets de facturation basée sur l’utilisation.
Utilisateurs sans Copilot licence ou plan incluant révision du code Copilot
Les utilisateurs qui n’ont pas accès à révision du code Copilot ne bénéficient pas d’une allocation mensuelle de AI credits pour ce service. Cela inclut les utilisateurs qui n’ont pas de Copilot licence et les utilisateurs sur le plan Copilot gratuit, ce qui n’inclut pas révision du code Copilot.
Lorsque révision du code Copilot est activé pour ces utilisateurs, tous les AI credits qu’ils consomment sont facturés directement à l’organisation ou à l’entreprise comme utilisation supplémentaire payante. Cela s’applique aux révisions demandées manuellement et aux révisions de code automatiques.
AI credits consommés par ces utilisateurs ne sont pas attribués au budget d’un utilisateur individuel. Ils apparaissent comme une utilisation supplémentaire dans les rapports de facturation. Les utilisateurs disposant d’une Copilot licence incluant la révision du code consomment AI credits à partir du pool partagé, soumis à tous les budgets au niveau utilisateur configurés par leur administrateur.
Utilisation du modèle
révision du code Copilot est un produit spécialement conçu qui utilise une combinaison soigneusement ajustée de modèles, de prompts et de comportements système afin de fournir des commentaires cohérents et de haute qualité sur un large éventail de codebases. Le changement de modèle n’est pas pris en charge, car cela risquerait de compromettre la fiabilité, l’expérience utilisateur et la qualité des commentaires de révision.
Remarque
révision du code Copilot peut utiliser des modèles qui ne sont pas activés dans la page des paramètres « Modèles » de votre organisation. La page des paramètres « Modèles » contrôle uniquement Discussion avec Copilot.
Étant donné que révision du code Copilot est en disponibilité générale, toute utilisation du modèle sera soumise aux conditions en vigueur pour la disponibilité générale. Consultez Gestion des stratégies et des fonctionnalités pour GitHub Copilot dans votre organisation.
Validation des revues de code Copilot
Copilot n’est pas garanti pour repérer tous les problèmes ou difficultés dans une pull request. Parfois, il fera des erreurs. Toujours valider attentivement les commentaires de Copilot. Complétez les commentaires de Copilot par une révision humaine.
Pour plus d’informations, consultez « Utilisation responsable de la révision de code avec GitHub Copilot ».
Améliorer Copilot la connaissance d’un dépôt par
Copilot Plus vous connaissez le code dans votre référentiel, les outils que vous utilisez et vos normes et pratiques de codage, plus les révisions sont plus précises et utiles. Vous pouvez améliorer Copilotles connaissances de vos dépôts de deux manières.
Instructions personnalisées
Il s’agit d’instructions courtes et en langage naturel que vous écrivez et stockez en tant que fichiers dans un référentiel. Si vous êtes propriétaire d’une organisation sur GitHub, vous pouvez également définir des instructions personnalisées dans les paramètres de votre organisation. Pour plus d’informations, consultez « À propos de la personnalisation des réponses GitHub Copilot ».
Copilot mémoire (préversion publique)
Si vous disposez d’un forfait Copilot Pro, Copilot Pro+ ou Copilot Max, vous pouvez activer Copilot mémoire. Cela permet Copilot de stocker des détails utiles qu’il a appris sur un référentiel. Copilot peut ensuite utiliser ces informations lorsqu'il passe en revue les demandes de tirage dans ce référentiel. Pour plus d’informations, consultez « À propos de la mémoire GitHub Copilot ».
À propos des examens automatiques des demandes d’extraction
Par défaut, Copilot examine une pull request uniquement si vous l’y affectez. Toutefois, vous pouvez configurer des révisions automatiques.
- Les utilisateurs individuels sur le plan Copilot Pro ou Copilot Pro+ peuvent configurer Copilot pour examiner automatiquement toutes les pull requests qu'ils créent.
- Les propriétaires de référentiels peuvent configurer Copilot pour examiner automatiquement toutes les pull requests du référentiel qui sont créées par des personnes ayant accès à Copilot.
- Les propriétaires de l’organisation peuvent configurer Copilot pour examiner automatiquement toutes les demandes de tirage dans certains dépôts ou tous les dépôts de l’organisation où la demande de tirage est créée par un Copilot utilisateur.
Déclenchement d’une révision automatique des demandes de tirage
Les déclencheurs pour la révision automatique du code dépendent des paramètres de configuration.
- Paramètre de base :
- Lorsque vous créez un pull request en tant que « pull request ouvert ».
- La première fois que vous basculez une demande de tirage de « Brouillon » à « Ouverte ».
- Passez en revue les nouvelles notifications push :
- Chaque fois que vous envoyez un nouveau commit à la pull request.
- Passez en revue les projets de pull requests :
- Les pull requests sont automatiquement examinées tant qu'elles sont encore à l'état de brouillon, avant de passer à « ouvrir ».
Pour obtenir des instructions complètes, consultez Configuration de la révision automatique du code par GitHub Copilot.
Remarque
À moins que Copilot ne soit configuré pour examiner chaque push pour une pull request, il n'examinera la pull request qu'une seule fois. Si vous apportez des modifications à la demande de tirage une fois qu’elle a été révisée automatiquement et que vous souhaitez Copilot la revoir à nouveau, vous pouvez la demander manuellement. Cliquez sur le bouton près du nom de Copilot dans le menu Réviseurs.
Obtention de commentaires détaillés sur la qualité du code pour votre dépôt entier
GitHub Copilot révision du code analyse votre code dans les pull requests et fournit des commentaires. Si vous souhaitez obtenir des commentaires actionnables sur la fiabilité et la maintenance de votre référentiel entier, activez GitHub Code Quality. Consultez À propos de la qualité du code sur GitHub.