Démarrage rapide pour l’utilisation de GitHub Copilot sur GitHub.com

Comprendre le code et travailler plus rapidement en posant des questions et en affectant des Copilot in the cloud tâches de codage sans quitter GitHub.

Qui peut utiliser cette fonctionnalité ?

Copilot in the cloud est activé par défaut pour tous les plans payants Copilot .

L’agent est disponible dans tous les référentiels stockés sur GitHub, à l’exception des référentiels détenus par comptes d’utilisateur managés et où il a été désactivé explicitement.
Sign up for Copilot

Dans cet article

GitHub Copilot est intégré GitHub, vous pouvez donc l’utiliser sans installer quoi que ce soit.

Ce guide de démarrage rapide prend environ quinze minutes et montre comment poser des questions sur un référentiel, demander et examiner une modification de code, et poursuivre votre travail sur GitHub Mobile avec Copilot.

Prerequisites

  • Pour la tâche 1, vous avez besoin d’un accès en lecture à un référentiel, tel que le dépôt github/docs public.
  • Pour les tâches 2 et 3, vous avez besoin d’un accès en écriture à un référentiel. Nous vous recommandons d’utiliser un dépôt dont vous êtes propriétaire ou pour lequel vous êtes autorisé à apporter des modifications.
  • Pour effectuer chaque tâche dans ce guide de démarrage rapide, Copilot doit être disponible pour votre compte et activé pour le référentiel que vous utiliserez. Pour obtenir des conseils d’installation, consultez Activez Copilot.
  • Pour effectuer la tâche 3, vous devez avoir GitHub Mobile installé et configuré pour votre compte. Consultez « GitHub Mobile ».

Tâche 1 : Poser des questions Copilot sur un référentiel

  1. Démarrez une session avec Copilot, à partir de la page d’accueil Copilot .

  2. Sous la zone d’invite, ouvrez le sélecteur d’étendue de session Chat.

  3. Sous Travailler dans un dépôt, recherchez et sélectionnez le dépôt que vous souhaitez explorer.

    • Si vous avez besoin d’un dépôt à essayer, utilisez le dépôt github/docs public.

  4. Si un fichier, un problème ou une pull request spécifique est pertinent, tapez @ dans la zone d’invite et sélectionnez-la dans les suggestions. Cela donne Copilot un endroit spécifique pour rechercher le contexte.

  5. Posez une question sur le référentiel. Par exemple:

    Copilot prompt
    I'm new to github/docs. How is this repository organized,
and where should I start to understand how the site is built?
    Copilot prompt
    In /package.json, which scripts look relevant for validating
a change, and what command does each run?
    Copilot prompt
    What behavior does
/src/color-schemes/tests/color-mode-script.ts cover?
Suggest one additional test case that would fit the
existing tests, and explain why.

    Pour créer une invite à partir des exemples ci-dessus, sélectionnez Copier et collez-la dans la zone d’invite. Appuyez ensuite sur Entrée pour envoyer le prompt.

    La réponse de Copilot s’affiche dans la conversation. Posez une question ciblée sur un fichier, une fonctionnalité ou une erreur pour obtenir une réponse plus utile.

  6. Posez une question de suivi en la tapant dans la même zone d’invite et en appuyant sur Entrée. La conversation donne un Copilot contexte pour votre prochaine question.

Tâche 2 : Demander et examiner une modification du code

  1. Démarrez une session avec Copilot, à partir de votre Copilot page d’accueil.

  2. Dans un dépôt où vous avez accès en écriture, utilisez le sélecteur de portée de session Chat et sélectionnez le dépôt sous Travailler dans un dépôt.

  3. Demander une modification de code. Indiquez le résultat souhaité et tout fichier ou comportement approprié. Par exemple, copiez et envoyez cette invite :

    Copilot prompt
    Add a small ASCII art image to the top of the README file.

    Collez l’invite dans la zone d’invite et appuyez sur Entrée pour l’envoyer. Copilot traite la tâche en arrière-plan.

    Important

    Passez en revue toutes les Copilot demandes d’autorisations ou d’action avant d’autoriser les modifications.

  4. Pendant que Copilot traite la demande, vous pouvez continuer à utiliser la session. Vous pouvez également développer chacune des étapes réalisées par Copilot dans le journal de session pour voir le travail effectué et les outils utilisés.

  5. Une fois que Copilot est terminé, les modifications s’affichent au-dessus de la zone d’invite et une option permettant de créer une pull request est proposée.

  6. Cliquez sur Modifications pour afficher les modifications proposées.

  7. Pour apporter d’autres modifications, tapez une demande de suivi dans la même zone d’invite, puis appuyez sur Entrée. La session conserve le contexte de vos invites antérieures.

  8. Cliquez sur Créer une pull request, puis cliquez sur le lien Afficher la pull request pour afficher vos modifications.

Passez à la tâche 3 pour poursuivre votre session sur GitHub Mobile.

Tâche 3 : Poursuivre votre session sur GitHub Mobile

  1. Ouvrez GitHub Mobile sur votre appareil.

  2. Dans la page d’accueil, appuyez sur l’icône dans le coin inférieur droit de l’écran.

  3. Sous la liste des sessions récentes, appuyez sur le nom de la session que vous avez créée ci-dessus. Le nom est souvent basé sur la première invite que vous avez envoyée. Dans cet exemple, il peut s’agir de quelque chose comme README ascii art.

  4. Cliquez sur Voir la PR, puis sur Fichiers modifiés, pour revoir les modifications proposées.

  5. Si vous le souhaitez, pour demander une autre modification, cliquez sur la ligne affectée. Ajoutez un commentaire qui mentionne @copilot et décrit ce qu’il faut modifier. Ensuite, sélectionnez Commentaire, puis cliquez sur Terminer votre révision pour que Copilot puisse voir votre demande et y donner suite.

Copilot reconnaîtra votre commentaire avec une réaction et démarrera une session pour apporter les modifications demandées si possible. Les événements de la chronologie sur la page de pull request s’afficheront quand Copilot sera terminé, et Copilot demandera à nouveau votre relecture et répondra à votre commentaire précédent avec les résultats.

  1. Lorsque vous êtes satisfait de votre pull request, vous devez Marquer comme prête pour révision.

  2. Passez en revue les modifications apportées par Copilot pour vous assurer qu’elles répondent à vos attentes. Si nécessaire, cliquez sur Approuver, puis sur terminez votre révision pour mettre la PR à l’état prêt pour la fusion.

  3. Cliquez sur Fusionner pour fusionner la pull request.

    Ensuite, vérifions votre fichier README mis à jour.

  4. Revenez à votre page d’accueil sur GitHub Mobile pour rechercher votre dépôt, puis ouvrez-le.

  5. Faites défiler jusqu’au bas de la page pour afficher le fichier README du dépôt et admirez votre œuvre d’art !

Étapes suivantes