Skip to main content

À propos des résumés des demandes de tirage Copilot

Avec Copilot pull request summaries, vous pouvez créer une description générée par l’IA pour une demande de tirage.

Qui peut utiliser cette fonctionnalité ?

Members of an enterprise with a subscription to GitHub Copilot Enterprise

Remarque : vous consultez actuellement la documentation pour les plans Gratuit, Pro et d’équipe. GitHub Copilot Enterprise est disponible uniquement pour les clients sur le plan GitHub Enterprise Cloud. Pour obtenir la documentation complète de Copilot Enterprise, consultez « GitHub Copilot Enterprise ». dans la documentation GitHub Enterprise Cloud.

À propos de Copilot pull request summaries

Copilot pull request summaries est une fonctionnalité basée sur l’intelligence artificielle qui vous permet de créer un résumé des modifications apportées dans une demande de tirage, des fichiers qu’elles affectent et des éléments sur lesquels un réviseur doit se concentrer lorsqu’il effectue sa révision.

Lorsqu’un utilisateur demande un résumé, Copilot analyse la demande de tirage et fournit une vue d’ensemble des modifications apportées en prose, ainsi qu’une liste à puces des modifications avec les fichiers qu’elles affectent.

La seule langue prise en charge pour Copilot pull request summaries est l'anglais.

Copilot pull request summaries utilise un flux d’invite simple tirant parti de l’API Copilot, sans aucun modèle entraîné supplémentaire. C’est le modèle de langage volumineux générique qui est utilisé.

Génération de la réponse

Le processus actuel utilise un grand modèle de langage pour lancer le processus de complétion automatique et générer le résumé de la demande de tirage.

Approche du pipeline

Lorsqu’un utilisateur demande un résumé, un flux de travail est déclenché. Le flux de travail utilise les différences de code pour générer un appel d’invite qui demande à Copilot de générer un résumé de la demande de tirage. La demande de résumé lance un processus de pipeline qui inclut des différences brutes de fichiers résumables dans une invite et demande à Copilot de générer un résumé global pour la demande de tirage.

Mise en forme de la sortie

Vous pouvez lancer cette fonctionnalité lors de la création d’une demande de tirage, en modifiant la description de la demande de tirage après la création ou dans un commentaire dans le thread de demande de tirage. À l’initiation, Copilot génère un résumé en deux parties :

  • Un paragraphe, écrit en prose, donnant une vue d’ensemble des modifications apportées à la demande de tirage.
  • Une liste à puces des modifications principales, liée aux lignes de code respectives où ces modifications se produisent.

La génération des demandes de tirage plus volumineuses par Copilot peut prendre quelques minutes. En fonction des paramètres de votre entreprise, vous pouvez partager vos retours d’expérience sur un résumé directement à partir de l’interface utilisateur une fois qu’un résumé est généré pour nous aider à continuer à améliorer la caractéristique.

Cas d’utilisation pour les résumés des demandes de tirage

L’objectif de Copilot pull request summaries est d’optimiser la capacité d’un auteur à fournir rapidement un contexte lorsqu’il demande une révision humaine qui nécessite le partage du contexte des modifications qui ont été apportées. Cela peut augmenter la productivité des développeurs en réduisant le temps nécessaire à l’ouverture d’une demande de tirage.

De nombreux utilisateurs peuvent ainsi obtenir un contexte plus utile pour les modifications qui ont été apportées dans une demande de tirage que ce qui est normalement disponible.

Amélioration des performances des résumés des demandes de tirage

Utiliser Copilot pull request summaries comme un outil et non comme un substitut

Cette fonctionnalité est destinée à compléter plutôt qu’à remplacer le travail d’un humain pour ajouter du contexte, et nous vous encourageons à continuer à ajouter un contexte utile et à laisser Copilot s’occuper de la tâche prenante d’analyse du code et de liaison à des fichiers spécifiques. Cependant, il est de votre responsabilité de passer en revue et d’évaluer l’exactitude des informations de la demande de tirage que vous créez.

Fournir des commentaires

Remarque : la possibilité de fournir des commentaires sur GitHub à propos de Copilot pull request summaries dépend des paramètres de l’entreprise. Pour plus d’informations, consultez « Activation des caractéristiques GitHub Copilot Enterprise ».

Si vous rencontrez des problèmes ou des limitations avec Copilot pull request summaries, vous pouvez fournir des commentaires en cliquant sur le bouton « Résumé incorrect » (icône de pouce vers le bas), qui s’affiche sous la zone de texte après la génération d’un résumé et avant de cliquer sur Créer une demande de tirage (pull request) ou Mettre à jour un commentaire.

Capture d'écran du bas d'un commentaire de demande de tirage (pull request). Les icônes de commentaires, les pouces vers le haut et vers le bas, sont mises en surbrillance avec un contour orange foncé.

Une fois que vous évaluez un résumé comme bon ou incorrect, vous pouvez fournir des commentaires écrits en cliquant sur le lien affiché.

Limites des résumés des demandes de tirage

Actuellement, notre équipe sait qu’il existe des limites à cette fonctionnalité. La plupart d’entre elles sont attendues lors de l’utilisation de notre API Copilot. Cependant, certaines d’entre elles sont spécifiques aux Copilot pull request summaries et concernent l’étendue limitée, les temps de traitement allongés et les réponses inexactes. Nous notons également que les utilisateurs doivent s’attendre à ce que les termes utilisés dans leur PR apparaissent dans le résumé généré par l’IA. Cette fonctionnalité a été soumise au Red Teaming en matière d’IA responsable et nous continuerons à surveiller l’efficacité et la sécurité de la fonctionnalité au fil du temps. Pour plus d’informations, consultez Microsoft AI Red Team construit l’avenir d’une IA plus sûre sur le blog Sécurité Microsoft.

Étendue limitée

En raison de la capacité, nous savons que les demandes de tirage plus volumineuses qui référencent 30 fichiers ou plus nécessitent plus de temps pour être traitées minutieusement. Nous n’avons pas de seuil exact pour le moment, mais nous avons observé que les 30 premiers fichiers étaient pris en compte et que tous les fichiers supplémentaires étaient omis du résumé. Nous mettons tout en œuvre pour corriger cette étendue limitée.

Temps de traitement

En général, nous nous attendons à ce qu’un résumé soit retourné en 40 secondes ou moins après le lancement de l’action par l’utilisateur. Toutefois, nous avons entendu dire que cela peut prendre jusqu’à une minute et, dans certains cas, quelques minutes. Nous mettons tout en œuvre pour réduire le temps de traitement et nous savons que parfois les utilisateurs ne souhaitent pas attendre la fin du traitement pour passer à d’autres parties de la demande de tirage.

Réponses inexactes

Plus Copilot apprendra des entrées et du contexte, meilleures seront les sorties. Toutefois, étant donné que la fonctionnalité est assez récente, il faudra du temps pour que les résumés générés atteignent une précision exacte. En attendant, il peut arriver que le résumé généré soit moins précis. L’utilisateur doit alors apporter des modifications avant d’enregistrer et de publier sa demande de tirage (pull request) avec cette description. En outre, il existe un risque d'« hallucination », où Copilot génère des déclarations inexactes. La révision est une exigence pour ces raisons, et une révision attentive de la sortie est fortement recommandée par notre équipe.

Régénération des résumés

Les résumés des demandes de tirage (pull request) sont créés uniquement lorsque les utilisateurs les demandent manuellement. Lorsque les utilisateurs envoient des mises à jour ou des modifications à leur demande de tirage (pull request), le résumé n’est pas automatiquement mis à jour. Les utilisateurs peuvent demander à Copilot de générer un nouveau résumé si nécessaire. La révision manuelle du résumé Copilot actualisé est vivement recommandée. Le résumé mis à jour présente les mêmes risques d’inexactitude que le résumé d’origine.

Réplication du contenu d’une demande de tirage

Étant donné qu’un résumé est un aperçu des modifications qui ont été apportées dans une demande de tirage, si des termes blessants ou offensants se trouvent dans le contenu de la demande de tirage, il est possible que le résumé inclue également ces termes.

Pour aller plus loin