Utilisation de Copilot dans le cloud sur GitHub

Présentation

Vous pouvez lancer des sessions GitHub Copilot in the cloud depuis plusieurs endroits sur GitHub. Une fois qu’une session est en cours d’exécution, vous pouvez surveiller sa progression, la diriger avec des invites de suivi et itérer sur la pull request résultante sans quitter le navigateur.

Pour plus d’informations sur Copilot in the cloud, consultez GitHub Copilot sur GitHub.com et GitHub Mobile.

Vous pouvez également démarrer des agents développés par des partenaires à partir de ces mêmes points d’entrée en utilisant agent apps. Pour plus d’informations, consultez « Utilisation d’applications d’agent ».

Démarrage d’une Copilot in the cloud session

Vous pouvez démarrer des sessions à partir de plusieurs points d’entrée différents.

• Votre Copilot page d’accueil sur github.com/copilot.
• Votre tableau de bord personnel ou GitHub page d’accueil lors de la connexion à https://github.com.
• Onglet Agents ou panneau dans un dépôt.

Vous pouvez envoyer une invite immédiatement avec les paramètres par défaut ou configurer la session en fonction de votre tâche avant d’envoyer une invite.

1. Dans la zone de texte, décrivez ce que vous voulez que Copilot fasse. Incluez le résultat souhaité et toutes les contraintes.

   Conseil

   Vous pouvez également utiliser des commandes slash dans votre prompt pour effectuer des actions spécifiques, telles que /rubber-duck pour obtenir un deuxième avis, /security-review pour examiner un référentiel pour les vulnérabilités ou /usage pour afficher des informations d’utilisation pour votre session.

2. Si vous le souhaitez, cliquez sur Joindre pour joindre Copilot des références à votre demande.

   Sélectionnez Fichiers et dossiers, Charger à partir de l’ordinateur, Référentiel ou Espace pour fournir le contexte de votre demande.

   Pour les sessions de bac à sable cloud, vous pouvez fournir un contexte supplémentaire à partir de sources tierces en configurant des connecteurs et des serveurs MCP personnalisés personnels, consultez connecteurs Copilot et Protocole MCP (Model Context Protocol).

3. Ouvrez le sélecteur de mode pour choisir la façon dont vous souhaitez collaborer avec Copilot.

   • Interactive : (par défaut) Utiliser Copilot pas à pas.
   • Autopilot : déléguer la tâche à Copilot pour une exécution de bout en bout.

   Dans le même menu, utilisez Autorisations des outils pour contrôler la façon dont les demandes d’outil sont approuvées.

   • Choisissez Assisted (valeur par défaut), qui utilise un contrôle de sécurité pour décider s’il faut approuver une demande ou vous demander votre avis.
   • Choisissez Toujours demander pour exiger une approbation pour chaque demande.
   • Choisissez Autoriser tout pour approuver automatiquement tous les outils, chemins d’accès et demandes d’URL.

4. Ouvrez le sélecteur Modèles et sélectionnez Auto (par défaut) ou un modèle spécifique. Les modèles sont regroupés par leurs points forts pour vous aider à choisir entre la vitesse et le rapport coût-efficacité, la polyvalence et l’intelligence, ou la capacité à effectuer des tâches complexes. Si le modèle sélectionné prend en charge le raisonnement configurable, tel que Balance, vous pouvez également utiliser le menu déroulant pour sélectionner le niveau de raisonnement.

5. Sous la zone d’invite, utilisez le sélecteur de contexte de session Chat pour choisir l’étendue de votre session (personnel, organisation ou référentiel).

   • Dans la zone de recherche, tapez un nom de référentiel pour rechercher un référentiel à ajouter.

   • Sous Poser n’importe quelle question dans l’ensemble des dépôts, choisissez Chat pour poser des questions dans l’ensemble des dépôts. La portée par défaut correspond à vos dépôts personnels. Cliquez sur l’image à droite pour ouvrir le menu du compte, puis modifiez l’étendue en sélectionnant une organisation ou en recherchant par propriétaire du dépôt (un utilisateur ou une organisation).

   • Sous Travailler dans un dépôt, sélectionnez un dépôt récent dans lequel travailler. Les dépôts répertoriés reflètent la portée sélectionnée.

   Remarque

   • L’ajout d’un dépôt via le menu Joindre (une étape précédente) fournit une référence (éléments de contexte) pour votre prompt. Alors que le sélectionner ici sous Démarrer une session fait du référentiel le référentiel de travail (étendue) de la session. Au début de la session, le bac à sable dans le cloud crée une copie du référentiel et donne Copilot l’autorisation, dans les contraintes existantes, de travailler avec son contenu.
   • Si un référentiel n’est pas répertorié, il peut être exclu de Copilot par vos paramètres personnels ou d’une organisation ou d’une stratégie d’entreprise.

   Si vous avez sélectionné un dépôt ci-dessus, vous pouvez également cliquer sur main (ou le nom de la branche par défaut indiqué) pour choisir une branche que Copilot utilise comme contexte de travail et dans laquelle il s’exécute.

6. Ouvrez l’environnement pour choisir où Copilot s’exécute.

   • Cloud : (valeur par défaut) Exécuter dans un GitHubsandbox hébergé dans le cloud.
   • Actions : Exécuter dans un environnement basé sur GitHub Actions. Si vous avez déjà sélectionné un contexte de session de conversation, vous ne pouvez pas sélectionner cet environnement pour la session.
   • Environnements : développez la liste et sélectionnez l’un des environnements distants répertoriés.

7. Cliquez sur Envoyer un message ou appuyez sur Entrée pour envoyer l’invite et démarrer la session.

Copilot répond à votre invite et démarre la session en fonction du contexte et de l’environnement sélectionnés. Si cela est demandé, Copilot génère une liste de fichiers modifiés, une pull request, des artefacts qu’il a générés (par exemple, un plan de recherche) et d’autres sorties pertinentes.

Commencer à partir de Copilot un fichier, d’un problème ou d’une pull request

Lorsque vous ouvrez une session de conversation avec Copilot à partir d’une page contextuelle, la session commence avec le contexte de votre fichier ouvert, problème ou pull request.

Vous ne pouvez pas démarrer une nouvelle session d’agent à partir du panneau contextuel lui-même ; vous devez l’initier à partir de la page Copilot, de votre page d’accueil ou de l’onglet Agents.

Démarrage d’une session avec Copilot cloud agent

Démarrage d’une session à partir de l’onglet ou du panneau agents

Vous pouvez démarrer des sessions à partir de l’onglet Agents et du panneau Agents. La seule différence est le point d’entrée : une fois que vous voyez le formulaire « Nouvelle tâche de l’agent », les étapes sont identiques.

1. Ouvrez le panneau ou l’onglet agents :

   • Ouvrez l’onglet Agents dans un dépôt.
   • Accédez à la GitHub Copilot page de toutes les sessions : accédez à github.com/copilot. Vous pouvez également accéder ici en ouvrant le GitHub Copilot menu dans la barre de navigation supérieure, puis en cliquant sur Afficher toutes les sessions.
   • Ouvrez le panneau agents : à partir de l’onglet code d’un dépôt, cliquez à droite de la barre de recherche « Accéder au fichier ».

2. À l’aide du menu déroulant dans le champ de saisie, sélectionnez le référentiel dans lequel vous souhaitez Copilot travailler.

3. Ouvrez l’environnement pour choisir où Copilot s’exécute.

   • Cloud : (valeur par défaut) Exécuter dans un GitHubsandbox hébergé dans le cloud.
   • Actions : Exécuter dans un environnement basé sur GitHub Actions. Si vous avez déjà sélectionné un contexte de session de conversation, vous ne pouvez pas sélectionner cet environnement pour la session.
   • Environnements : développez la liste et sélectionnez l’un des environnements distants répertoriés.

4. Saisissez une invite décrivant votre demande. Vous pouvez également ajouter des entrées visuelles telles que des captures d’écran ou des maquettes d’interface utilisateur en collant, en faisant glisser ou en chargeant une image. Fichiers pris en charge : image/png, image/jpeg, image/gif, image/webp.

   Par exemple : Implement a user friendly message for common errors.

   Si vous souhaitez Copilot ouvrir une pull request, vous pouvez le demander dans votre invite, par exemple Open a pull request to implement a user friendly message for common errors.

5. Si vous le souhaitez, sélectionnez une branche de base pour les modifications de Copilot. Copilot créera une nouvelle branche basée sur cette branche.

6. Si vous le souhaitez, vous pouvez cliquer sur pour ouvrir le menu déroulant de l'agent, afin d'affecter un agent ou un élément avec un comportement spécialisé et des outils custom agent. Vous pouvez sélectionner un élément existant custom agent à partir de votre dépôt, de votre organisation ou de votre entreprise. Vous pouvez également cliquer sur Créer un agent pour créer un nouveau agent profile dans votre référentiel et branche sélectionnés. Pour plus d’informations, consultez « Création d’agents personnalisés pour Copilot cloud agent ».

   Remarque

   Third-party coding agents are available for all paid Copilot plans.

7. Si vous le souhaitez, vous pouvez utiliser le menu déroulant pour sélectionner le modèle, que Copilot utilisera. Si le modèle sélectionné prend en charge le raisonnement configurable, vous pouvez également utiliser le menu déroulant pour sélectionner le niveau de raisonnement. Pour plus d’informations, consultez « Modification du modèle IA pour GitHub Copilot agent cloud ».

8. Cliquez ou appuyez sur Entrée.

Copilot démarre une nouvelle session, qui apparaît dans la liste sous la zone d’invite. Copilot travaillera sur la tâche et envoie (push) les modifications de code.

Vous pouvez suivre Copilot le travail et ouvrir une pull request en un clic dans les journaux de session. Pour plus d’informations, consultez « [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents) ».

Démarrage d’une session à partir du tableau de bord

Vous pouvez demander à Copilot de commencer à travailler depuis la zone de saisie du tableau de bord. Le tableau de bord est votre vue d'ensemble personnalisée de votre activité sur GitHub, visible lorsque vous visitez https://github.com tout en étant connecté.

1. Accédez au tableau de bord à l’adresse https://github.com.

2. Cliquez sur le bouton Tâche .

3. À l’aide du menu déroulant dans le champ de saisie, sélectionnez le référentiel dans lequel vous souhaitez Copilot travailler.

4. Saisissez une invite décrivant votre demande.

   Par exemple : Implement a user friendly message for common errors.

   Si vous souhaitez Copilot ouvrir une pull request, vous pouvez le demander dans votre invite, par exemple Open a pull request to implement a user friendly message for common errors.

5. Si vous le souhaitez, sélectionnez une branche de base pour la pull request de Copilot. Copilot créera une nouvelle branche basée sur cette branche.

6. Si vous le souhaitez, vous pouvez cliquer sur pour ouvrir le menu déroulant de l'agent, afin d'affecter un agent ou un élément avec un comportement spécialisé et des outils custom agent. Vous pouvez sélectionner un élément existant custom agent à partir de votre dépôt, de votre organisation ou de votre entreprise. Vous pouvez également cliquer sur Créer un agent pour créer un nouveau agent profile dans votre référentiel et branche sélectionnés. Pour plus d’informations, consultez « Création d’agents personnalisés pour Copilot cloud agent ».

   Remarque

   Third-party coding agents are available for all paid Copilot plans.

7. Cliquez sur Envoyer maintenant ou appuyez surRetour.

   Vous accédez à l’onglet Agents et Copilot démarrez une nouvelle session, qui s’affiche dans la liste « Sessions récentes » sous la zone d’invite. Copilot travaillera sur la tâche et enverra les modifications de code.

   Remarque

   Si vous avez activé la nouvelle expérience de tableau de bord en préversion des fonctionnalités, la nouvelle session s’affiche dans « Sessions de l’agent » sous la zone d’invite de votre tableau de bord. Pour plus d’informations, consultez « Tableau de bord personnel ».

À partir de Copilot Chat

Lorsque vous démarrez une tâche depuis Copilot Chat, la nouvelle session Copilot cloud agent inclut le contexte de votre conversation en cours. Cela signifie que vous n’avez pas besoin de répéter les détails que vous avez déjà partagés avec Copilot dans votre prompt /task.

1. Ouvrez GitHub Copilot Chat sur GitHub.com.

2. Tapez /task pour demander à Copilot de créer une pull request et donnez des détails sur ce que vous souhaitez que Copilot modifie.

   Par exemple : /task Create a pull request to put backticks around file names and variables in output.

3. Si vous le souhaitez, sélectionnez une branche de base pour la pull request de Copilot. Copilot créera une nouvelle branche basée sur cette branche, puis poussera les modifications vers une pull request ciblant cette branche.

4. Si vous le souhaitez, vous pouvez cliquer sur pour ouvrir le menu déroulant de l'agent, afin d'affecter un agent ou un élément avec un comportement spécialisé et des outils custom agent. Vous pouvez sélectionner un élément existant custom agent à partir de votre dépôt, de votre organisation ou de votre entreprise. Vous pouvez également cliquer sur Créer un agent pour créer un nouveau agent profile dans votre référentiel et branche sélectionnés. Pour plus d’informations, consultez « Création d’agents personnalisés pour Copilot cloud agent ».

   Remarque

   Third-party coding agents are available for all paid Copilot plans.

5. Cliquez ou appuyez sur Entrée.

Copilot démarre une nouvelle session, qui apparaît dans la liste sous la zone d’invite. Copilot travaillera sur la tâche et poussera les modifications dans sa pull request, puis vous ajoutera en tant que réviseur une fois terminé, ce qui déclenchera une notification.

Affectation d’un problème à Copilot

Vous pouvez demander Copilot à commencer à travailler sur un problème en affectant le problème à Copilot. Copilot commencera à travailler sur la tâche, créera une pull request, puis vous demandera une révision lorsqu'il aura terminé.

1. Sur GitHub, accédez à la page principale du référentiel.

2. Sous le nom de votre référentiel, cliquez sur Problèmes.

   

3. Ouvrez le problème auquel vous souhaitez affecter Copilot.

4. Dans le menu de droite, cliquez sur Destinataires.

   

5. Cliquez sur Copilot dans la liste des assignés.

   

   Des options supplémentaires s'affichent.

   

6. Dans le champ d’invite facultatif , vous pouvez ajouter des instructions spécifiques pour Copilot. Ajoutez un contexte, des contraintes ou des exigences spécifiques qui vous aideront Copilot à comprendre et à terminer la tâche.

   Par exemple, vous pouvez inclure des instructions concernant les modèles ou les cadres de codage spécifiques à utiliser, les exigences en matière de tests, les préférences en matière de style de code, les fichiers ou répertoires qui doivent ou ne doivent pas être modifiés.

   En plus des détails que vous fournissez ici, Copilot utilisez toutes les instructions personnalisées qui ont été configurées pour le référentiel cible. Consultez « Ajout d’instructions personnalisées de référentiel pour GitHub Copilot ».

7. Vous pouvez utiliser les menus déroulants dans la boîte de dialogue pour modifier le référentiel dans lequel Copilot travaillera et la branche à partir de laquelle il bifurquera.

   Tous les référentiels dans lesquels vous avez ** au moins** accès de lecture sont affichés dans le menu déroulant du référentiel. Toutefois, vous ne pouvez sélectionner un référentiel que si vous y avez accès en écriture , et s’il Copilot cloud agent est activé pour ce référentiel.

   Si vous sélectionnez un référentiel dans une autre organisation que l’organisation source du problème ou si vous sélectionnez un dépôt public lorsque le problème se trouve dans un référentiel privé, un avertissement s’affiche.

   Si vous ne spécifiez pas de référentiel, Copilot fonctionne dans le même référentiel que le problème. Si vous ne spécifiez pas de branche, Copilot fonctionne à partir de la branche par défaut du référentiel sélectionné.

   Conseil

   Lorsque vous attribuez un problème à Copilot, il est envoyé le titre, la description du problème, les commentaires qui existent actuellement et toutes les instructions supplémentaires que vous fournissez. Une fois le problème attribué, Copilot ne sera pas informé des nouveaux commentaires, et donc ne réagira pas à ceux-ci. Si vous disposez d'informations supplémentaires ou si les exigences d'origine ont changé, ajoutez-les sous forme de commentaire dans la pull request créée par Copilot.

8. Si vous le souhaitez, vous pouvez cliquer sur pour ouvrir le menu déroulant de l'agent, afin d'affecter un agent ou un élément avec un comportement spécialisé et des outils custom agent. Vous pouvez sélectionner un élément existant custom agent à partir de votre dépôt, de votre organisation ou de votre entreprise. Vous pouvez également cliquer sur Créer un agent pour créer un nouveau agent profile dans votre référentiel et branche sélectionnés. Pour plus d’informations, consultez « Création d’agents personnalisés pour Copilot cloud agent ».

   Remarque

   Third-party coding agents are available for all paid Copilot plans.

9. Si vous le souhaitez, vous pouvez utiliser le menu déroulant pour sélectionner le modèle, que Copilot utilisera. Si le modèle sélectionné prend en charge le raisonnement configurable, vous pouvez également utiliser le menu déroulant pour sélectionner le niveau de raisonnement. Pour plus d’informations, consultez « Modification du modèle IA pour GitHub Copilot agent cloud ».

Vous pouvez également affecter des problèmes à Copilot depuis d'autres emplacements sur GitHub.com :

• Dans la liste des problèmes sur la page Problèmes d’un dépôt .
• Lors de l’affichage d’un problème dans GitHubProjets.

Amorçage d’un nouveau référentiel

Lors de la création d'un nouveau référentiel, vous pouvez demander à Copilot d'initialiser le nouveau référentiel en saisissant une invite.

1. Dans le coin supérieur droit de n’importe quelle page, sélectionnez sur , puis cliquez sur Nouveau référentiel.

   

2. Utilisez le menu déroulant Propriétaire pour sélectionner le compte auquel vous voulez donner la propriété du dépôt.

3. Dans le champ Invite , entrez une invite décrivant ce que vous souhaitez Copilot générer.

   Par exemple, Create a Rust CLI for converting CSV spreadsheets to Markdown1. Cliquez sur Créer le dépôt.

Copilot ouvrira immédiatement une pull request à l'état de brouillon. Copilot travaillera sur la tâche et poussera les modifications dans sa pull request, puis vous ajoutera en tant que réviseur une fois terminé, ce qui déclenchera une notification.

Résolution d’une exécution de flux de travail défaillante GitHub Actions

Lorsqu’une exécution de workflow GitHub Actions échoue sur une branche de pull request, vous pouvez demander à Copilot d’examiner et de corriger le problème.

1. Dans GitHub, accédez à la page du job d'exécution du workflow en échec.

2. Cliquez sur le bouton Corriger avec Copilot.

Copilot démarrera une nouvelle session, analysera la cause de l'échec et enverra un correctif vers votre branche.

Poursuite du travail sur une pull request

Vous pouvez demander à Copilot d’apporter des modifications ou de traiter les commentaires de révision sur une pull request existante. Vous pouvez ensuite suivre la session résultante et fournir des instructions de suivi.

Demander Copilot d’apporter des modifications

Vous pouvez mentionner @copilot dans un commentaire sur n’importe quelle pull request pour demander à Copilot d’apporter des modifications. Cela fonctionne sur les demandes de tirage créées par Copilot et sur les demandes de tirage que vous ou d’autres avez créées.

Par défaut, Copilot envoie les commits directement dans la branche de pull request. Pour créer une pull request distincte, décrivez cela dans votre commentaire. Vous pouvez également extraire la branche et envoyer vous-même les modifications.

Lorsque vous soumettez un commentaire de pull request (et non une révision ou un commentaire de révision) via l'interface web GitHub, sélectionnez un modèle à l'aide du sélecteur de modèles. Copilot utilise par défaut le modèle de la pull request d'origine.

Déléguer les commentaires de révision

Vous pouvez attribuer les commentaires de révision pour que Copilot applique les retours des réviseurs humains et GitHub Copilot code review.

1. Dans la pull request, ouvrez l’onglet Fichiers modifiés.
2. Accédez au premier commentaire de révision que vous souhaitez voir appliqué par Copilot.
   • Pour attribuer un commentaire, cliquez sur Corriger avec Copilot.
   • Pour déléguer plusieurs commentaires, cliquez sur Ajouter au lot. Continuez à ajouter les commentaires sur lesquels vous souhaitez faire travailler Copilot.
3. Dans le panneau Gérer les lots , ajoutez toutes les instructions supplémentaires, puis sélectionnez éventuellement un modèle avec le sélecteur de modèles.
4. Choisissez la façon dont vous souhaitez Copilot appliquer les modifications :
   • Pour valider les modifications directement dans la branche, cliquez sur Corriger et valider.
   • Pour que Copilot crée une nouvelle pull request avec les modifications, cliquez sur Corriger et ouvrir la pull request dans le menu déroulant.

Suivi et poursuite d’une session

Copilot répond uniquement aux commentaires des personnes qui ont accès en écriture au référentiel.

Lorsque Copilot démarre une nouvelle session en réponse à votre commentaire, une réaction avec l'emoji yeux (👀) apparaît sur le commentaire. Un événement « Copilot a commencé à travailler » apparaît dans la chronologie de la pull request.

Copilot mémorise le contexte des sessions antérieures sur la même pull request, de sorte que les requêtes de suivi sont plus rapides et plus fiables. Si la pull request a été créée par un custom agent, la mention de @copilot continue d'utiliser ce même agent.

Résolution des conflits de fusion

Vous pouvez solliciter Copilot pour résoudre les conflits de fusion sur un pull request de deux façons :

• À l’aide du bouton « Corriger avec Copilot » : Si un pull request comporte des conflits de fusion, cliquez sur le bouton « Corriger avec Copilot » qui s’affiche dans la zone de fusion.
• Utilisation d’une @copilot mention : Mentionnez @copilot dans un commentaire sur le pull request et demandez-lui de résoudre les conflits, par exemple, «@copilot résoudre les conflits de fusion sur ce PR ».

Copilot analyse les modifications en conflit, les résout et vérifie que le build, les tests et le linter réussissent toujours. Il demande ensuite votre révision pour vous permettre de confirmer la résolution avant la fusion.

Exécuter Copilot automatiquement avec automations

Vous pouvez configurer automations pour exécuter Copilot automatiquement, selon une planification définie ou en réponse à des événements tels que l’ouverture d’un ticket. Vous créez et gérez automations à partir du Automations volet sous l’onglet Agents d’un référentiel. Pour plus d’informations, consultez « Création d’automatisations avec Copilot agent cloud ».

Gestion des exécutions de workflow GitHub Actions

Par défaut, GitHub Actions les flux de travail ne s’exécutent pas automatiquement lorsque Copilot les modifications sont envoyées à une demande de tirage (pull request).

GitHub Actions Les flux de travail peuvent être privilégiés et avoir accès à des secrets sensibles. Inspectez les modifications proposées dans la demande de tirage et assurez-vous que vous êtes à l’aise pour exécuter vos workflows sur la branche de la demande de tirage. Vous devez être particulièrement averti des modifications proposées dans le .github/workflows/ répertoire qui affectent les fichiers de flux de travail.

Pour permettre aux workflows GitHub Actions de s'exécuter, cliquez sur le bouton Approuver et exécuter les workflows dans la boîte de fusion de la pull request.

Si vous le souhaitez, vous pouvez configurer Copilot cloud agent pour permettre GitHub Actions aux flux de travail de s’exécuter sans intervention humaine. Pour plus d’informations, consultez Configuration des paramètres de GitHub Copilot dans le cloud.

Donner votre feedback sur le travail de Copilot

Utilisez les boutons de commentaires sur les pull requests Copilot et les commentaires pour évaluer le résultat. Vos commentaires aident à améliorer la qualité de Copilot.

1. Sur une pull request ou un commentaire de Copilot, cliquez sur le bouton pouce levé (👍) ou pouce baissé (👎).
2. Si vous cliquez sur le bouton vers le bas, sélectionnez éventuellement une raison et laissez un commentaire, puis cliquez sur Envoyer des commentaires.

Lectures complémentaires

• GitHub Copilot sur GitHub.com et GitHub Mobile
• Bonnes pratiques pour l’utilisation de GitHub Copilot pour travailler sur des tâches
• Résolution des problèmes de l'agent du cloud GitHub Copilot