Usage responsable des résumés de pull requests de GitHub Copilot

À 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 concernés et des points sur lesquels un réviseur doit se concentrer lors de sa révision.

Lorsqu’un utilisateur demande un résumé, Copilot analyse le pull request et fournit une vue d'ensemble des modifications en prose, ainsi qu’une liste à puces des modifications et les fichiers qu'elles affectent.

Vous pouvez générer un résumé aux emplacements suivants :

• Dans la description d’une nouvelle proposition de fusion que vous créez
• 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 de requêtes simples exploitant 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 un appel de prompt qui demande à Copilot de générer un résumé du pull request. La demande de résumé lance un processus de pipeline qui inclut des différences non traitées de fichiers résumables dans le cadre d'une invite et demande à Copilot de générer un résumé global pour la pull request.

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 pull request.
• Une liste à puces des modifications principales, liée aux lignes de code respectives où ces modifications se produisent.

Les pull requests plus volumineuses peuvent prendre quelques minutes pour ê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 de Résumés des pull requests Copilot est d'aider les auteurs à fournir rapidement le contexte nécessaire lorsqu'ils demandent 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

Utilisez Résumés des pull requests Copilot comme un outil, pas 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

Si vous rencontrez des problèmes ou des limitations avec , vous pouvez nous faire part de vos commentaires en cliquant sur le bouton « Mauvais résumé » (icône représentant un pouce vers le bas), qui s'affiche sous la zone de texte après la génération d'un résumé et avant que vous ne cliquiez sur Créer une demande de tirage ou Mettre à jour le 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é.

Limites des résumés des demandes de tirage

Actuellement, notre équipe sait qu’il existe des limites à cette fonctionnalité. Beaucoup d'entre eux devraient tirer parti de notre API Copilot ; toutefois, certains sont spécifiques à Résumés des pull requests Copilot et concernent une portée limitée, des temps de traitement plus longs et des 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 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 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 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 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 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

•         [Centre de Confiance GitHub Copilot](https://copilot.github.trust.page/)
  

•         [AUTOTITLE](/copilot/github-copilot-enterprise/copilot-pull-request-summaries/creating-a-pull-request-summary-with-github-copilot) dans la documentation GitHub Enterprise Cloud