À propos de la révision de code avec GitHub Copilot

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 du code.

Disponibilité

          révision du code Copilot est pris en charge dans :

• GitHub.com

• GitHub Mobile

• VS Code

• Visual Studio

• Xcode

• IDE JetBrains

          révision du code Copilot est une fonctionnalité Premium disponible avec ces plans :
  

• Copilot Pro

• Copilot Pro+

• Copilot Business

• Copilot Entreprise

Consultez Copilot les plans.

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 :

1.        **Utilisation payante de la requête premium**. Activez d’abord cette stratégie. Elle permet à l'entreprise ou à l'organisation d'entraîner des frais pour l'utilisation des requêtes premium révision du code Copilot.
   

2.        **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 Copilot licence peuvent demander une révision de leurs demandes d'extraction 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

          révision du code Copilot a des fonctionnalités qui sont à l'état actuel et susceptibles de changer. Les [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) 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 Copilot de cloud. 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 Copilot de cloud est en préversion publique et susceptible de changer.

Ces fonctionnalités sont activées automatiquement pour Copilot Pro ou Copilot Pro+ plans.

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 des minutes gratuites pour GitHub Actions exécuter les fonctionnalités agentiques, y compris la collecte complète du contexte de projet et toutes les fonctionnalités dans préversion publique. Par défaut, révision du code Copilot utilise les exécuteurs hébergés GitHub. Vous pouvez également effectuer une mise à niveau vers des exécuteurs GitHub-hébergés plus volumineux pour de meilleures performances.

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 avec GitHub Copilot.

Quota mensuel de revue

Chaque fois que Copilot vous révisez une pull request ou du code dans votre IDE, votre quota mensuel de Copilot demandes Premium est réduit d'une unité.

Si un référentiel est configuré pour demander automatiquement une révision de code pour toutes les nouvelles pull requests de Copilot, l'utilisation de la fonctionnalité Premium est appliquée au quota de l'auteur de la pull request. Si une révision est demandée manuellement par un autre utilisateur, l’utilisation est appliquée au quota de 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 lorsque vous atteignez votre quota

Lorsque vous atteignez votre quota mensuel, vous ne pourrez pas obtenir une révision du Copilot code tant que votre quota n’est pas réinitialisé. Pour continuer à utiliser des révisions de code avant la réinitialisation de votre quota, vous devez mettre à niveau votre plan Copilot ou activer des demandes premium supplémentaires.

Utilisateurs sans Copilot licence ou plan incluant révision du code Copilot

Les utilisateurs sans accès à révision du code Copilot ne disposent pas d'un quota de demande Premium mensuel. 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.

Lorsqu’il révision du code Copilot est activé pour ces utilisateurs, toutes les demandes Premium qu’ils génèrent sont facturées directement à l’organisation ou à l’entreprise en tant qu’utilisation supplémentaire payante. Cela s’applique aux révisions demandées manuellement et aux révisions de code automatiques.

Les demandes Premium générées par ces utilisateurs ne sont pas attribuées à un Copilot quota de plan. Ils apparaissent comme une utilisation excessive dans les rapports de facturation et l'analyse des demandes premium. Les utilisateurs disposant d’une licence incluant la Copilot révision du code continuent à consommer des demandes Premium à partir de leur quota de plan affecté.

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.

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élioration des connaissances de Copilot d’un référentiel

          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 ».

          Mémoire Copilot (préversion publique)

Si vous avez un plan Copilot Pro ou Copilot Pro+, vous pouvez activer Mémoire Copilot. 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 agentique pour 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.

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 [AUTOTITLE](/code-security/code-quality/concepts/about-code-quality).

Pour aller plus loin

•         [AUTOTITLE](/copilot/how-tos/agents/copilot-code-review/using-copilot-code-review)