À propos de Résumés des pull requests Copilot
Résumés des pull requests Copilot est une fonctionnalité alimentée par l'IA qui vous permet de créer un résumé des modifications apportées dans une pull request, des fichiers qu'elles impactent, et sur quoi un réviseur doit se concentrer lors de sa révision.
Lorsqu’un utilisateur demande un résumé, Copilot analyse la pull request et fournit une vue d’ensemble des modifications sous forme de texte, ainsi qu’une liste à puces des modifications et des fichiers qu’elles affectent.
Vous pouvez générer un résumé aux emplacements suivants :
- Dans la description d’une nouvelle pull request que vous êtes en train de créer
- Dans la description d'un pull request existant, en éditant le commentaire d'ouverture
- Dans un commentaire sur le fil principal d'une pull request
La seule langue prise en charge pour Résumés des pull requests Copilot est l’anglais.
Résumés des pull requests Copilot utilise un flux d’invite simple tirant parti de l’API Copilot , sans modèles entraînés supplémentaires. 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 modèle de langage étendu pour initier le processus de complétion automatique et générer le résumé de la pull request.
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 une requête d'invite, qui demande Copilot de générer un résumé de la pull request. La demande récapitulative lance un processus de pipeline qui inclut des différences brutes de fichiers pouvant être résumés dans une invite et demande Copilot de générer un résumé global pour la pull request (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. Lors de 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 pull request.
- Une liste à puces des modifications principales, liée aux lignes de code respectives où ces modifications se produisent.
Les demandes de tirage plus volumineuses peuvent mettre quelques minutes à être générées par Copilot. 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 des résumés de pull request
L’objectif est d’optimiser Résumés des pull requests Copilot 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 apportées. Cela peut augmenter la productivité des développeurs en réduisant le temps nécessaire à l’ouverture d’un pull request.
De nombreux utilisateurs peuvent ainsi obtenir un contexte plus utile pour les modifications qui ont été apportées dans une pull request que ce qui est habituellement disponible.
Amélioration des performances des résumés des pull requests
Utiliser Résumés des pull requests Copilot en tant qu’outil, et non en remplacement
La fonctionnalité est destinée à compléter plutôt qu’à remplacer le travail d’un humain pour ajouter un contexte, et nous vous encourageons à continuer à ajouter un contexte utile et à laisser Copilot le travail occupé d’analyser le code et de lier à 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 à GitHub concernant Résumés des pull requests Copilot dépend des paramètres de l'entreprise. Pour plus d’informations, consultez « Gestion des stratégies et fonctionnalités pour GitHub Copilot dans votre entreprise ».
Si vous rencontrez des problèmes ou des limitations avec Résumés des pull requests Copilot, vous pouvez fournir des commentaires en cliquant sur le bouton « Résumé erroné » (une 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 un pull request ou mettre à jour un commentaire.
Une fois que vous évaluez un résumé comme bon ou incorrect, vous pouvez fournir des commentaires écrits en cliquant sur le lien affiché.
Limitations des résumés de pull request
Actuellement, notre équipe sait qu’il existe des limites à cette fonctionnalité. La plupart d’entre eux sont censés tirer parti de notre Copilot API. Toutefois, il y en a quelques-uns, spécifiques à Résumés des pull requests Copilot, qui traitent d'une étendue limitée, de temps de traitement plus longs et de 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 fait l’objet d’un exercice de Red Teaming en IA responsable (RAI) et nous continuerons à surveiller son efficacité et sa sécurité au fil du temps. Pour plus d’informations, consultez Microsoft AI Red Team pour l’avenir de l’IA plus sûre sur le blog de sécurité Microsoft.
Limites des lignes modifiées
Les fichiers avec plus de 400 ajouts et suppressions combinés sont exclus du résumé.
É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 travaillons à réduire le temps de traitement et nous savons que les utilisateurs ne souhaitent pas attendre que cela soit terminé avant de passer à d'autres parties de la pull request.
Réponses inexactes
Plus Copilot peut apprendre 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 y a 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 de résumés
Les résumés des pull requests sont créés uniquement lorsque les utilisateurs les demandent manuellement. Lorsqu'un utilisateur apporte des mises à jour ou des modifications à sa requête d'extraction (pull request), le résumé n'est pas mis à jour automatiquement. Les utilisateurs peuvent demander Copilot à générer un nouveau résumé si nécessaire. L’examen manuel du résumé mis à jour Copilot est vivement recommandé. 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 pull request
É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 approfondir
-
[ GitHub Copilot Centre de gestion de la confidentialité](https://copilot.github.trust.page/)