Skip to main content
Skip to content

Utiliser des liens directs pour ouvrir l’application GitHub Copilot

Utilisez des liens directs pour lancer le GitHub Copilot app depuis le terminal, les tickets et les outils internes, afin d’accéder directement au bon dépôt, à la bonne pull request, à la bonne automatisation ou à la bonne session.

Qui peut utiliser cette fonctionnalité ?

Le GitHub Copilot app est disponible pour tous les Copilot forfaits.
Télécharger le fichier GitHub Copilot app

Les liens profonds aident les utilisateurs à commencer à travailler dans le GitHub Copilot app sans avoir à changer autant de contexte. Par exemple, vous pouvez partager des invites de lancement, inclure des liens vers l’application dans des fichiers Markdown, lancer l’application à partir de scripts de terminal ou ajouter un bouton pour ouvrir l’application dans des outils externes.

Vous pouvez ouvrir le GitHub Copilot app à partir de liens de navigateur qui encapsulent un lien d’application dans le lanceur hébergé. Le lanceur hébergé ouvre l’application lorsque cela est possible et affiche une page de secours si le navigateur ne peut pas se remettre à l’application. Pour obtenir la liste complète des liens d’application pris en charge, consultez Liens d’application disponibles.

Utilisez des liens approfondis lorsque vous souhaitez passer d’une page web ou d’un flux de travail directement dans une page ou une tâche spécifique dans l’application. Les cas d’utilisation courants sont les suivants :

  • Démarrez des sessions avec une requête de lancement préremplie.
  • Partagez des invites d’automatisation afin que les collègues puissent les ouvrir et les réutiliser rapidement.
  • Ajoutez des boutons de lancement dans des documents internes ou des fichiers Markdown pour ouvrir des flux de travail courants.
  • Lancez l’application à partir de commandes ou de scripts de terminal dans le cadre de flux de travail locaux.
  • Ouvrez l’application à partir de produits tiers, comme des systèmes de gestion des incidents ou de tickets.

Format de l’URL du lanceur

Utilisez l’URL du lanceur hébergé avec le lien d’application complet encodé dans le paramètre de open requête. Le lanceur hébergé ouvre l’application lorsque cela est possible et affiche une page de secours si le navigateur ne peut pas se remettre à l’application.

https://github.com/copilot/app/launch?open=ENCODED_APP_LINK

Utilisez encodeURIComponent, ou l’équivalent dans votre langage de programmation, pour encoder le lien complet de l’application. Si le lien d’application inclut des paramètres de requête, encodez ces valeurs de paramètres de requête avant d’encoder le lien d’application complet pour open.

Par exemple, pour ouvrir un référentiel, le lien d’application est :

ghapp://github.com/OWNER/REPO

Encodé dans l’URL du lanceur, qui devient :

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO

Les liens publics doivent utiliser le schéma officiel ghapp:// . L’application accepte également les liens github-app:// et gh:// à des fins de compatibilité, mais les liens générés et documentés doivent utiliser ghapp://.

Ouvrir un dépôt ou un élément de travail

Pour ouvrir une page dans le GitHub Copilot app, créez une URL de lancement à l’aide du lien d’application de la page que vous souhaitez ouvrir.

  • Pour ouvrir un référentiel, utilisez ce lien d’application :

    ghapp://github.com/OWNER/REPO
    

    Encodé dans l’URL du lanceur, qui devient :

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO
    
  • Pour ouvrir un problème, utilisez ce lien d’application :

    ghapp://github.com/OWNER/REPO/issues/NUMBER
    

    Encodé dans l’URL du lanceur, qui devient :

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fissues%2F123
    
  • Pour ouvrir une pull request, utilisez ce lien de l’application :

    ghapp://github.com/OWNER/REPO/pull/NUMBER
    

    Encodé dans l’URL du lanceur, qui devient :

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fpull%2F123
    
  • Pour reprendre une tâche d’agent, utilisez ce lien d’application :

    ghapp://github.com/OWNER/REPO/tasks/TASK_ID
    

    Encodé dans l’URL du lanceur, qui devient :

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Ftasks%2FTASK_ID
    

    Utilisez l’ID de tâche GitHub pour TASK_ID. N’utilisez pas d’ID de session runtime ou d’URL de session locale à l’application pour les liens permettant de reprendre GitHub Copilot les tâches de l’agent.

Ouvrir des sessions

Pour démarrer une nouvelle session à partir d’un lien direct, utilisez ghapp://session/new avec des paramètres de requête pour préremplir le référentiel, la branche, la pull request, l’instruction ou le mode. Pour connaître les paramètres disponibles, consultez Paramètres de session.

Par exemple, pour démarrer une nouvelle session interactive avec un dépôt et une invite de lancement, utilisez ce lien d’application :

ghapp://session/new?repo=OWNER%2FREPO&mode=interactive&prompt=Investigate%20failing%20tests

Encodé dans l’URL du lanceur, qui devient :

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fsession%2Fnew%3Frepo%3DOWNER%252FREPO%26mode%3Dinteractive%26prompt%3DInvestigate%2520failing%2520tests

Pour préparer une invite sans sélectionner de référentiel, omettre repo et fournir prompt ou agent:

ghapp://session/new?prompt=Investigate%20failing%20tests

Encodé dans l’URL du lanceur, qui devient :

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fsession%2Fnew%3Fprompt%3DInvestigate%2520failing%2520tests

Une fois que vous avez approuvé le lien, l’application ouvre la nouvelle page de session sans référentiel sélectionné. Un prompt fourni remplace tout prompt non envoyé sur la nouvelle page de session. Rien n’est envoyé tant que vous n’avez pas examiné et soumis l’invite.

Paramètres de session

Les liens ghapp://session/new et ghapp://session/new/OWNER/REPO acceptent ces paramètres de requête.

ParamètreObligatoireRemarques
repoObligatoire, sauf si le référentiel se trouve dans le chemin d’accès ou si le lien fournit prompt ou agent sans paramètres spécifiques au référentielDépôt au format OWNER/REPO. Les paramètres spécifiques au dépôt, tels que pr et branch, nécessitent un dépôt.
prNonNuméro de pull request positif. Impossible de combiner avec branch.
branchNonBranche de base pour la nouvelle session. Impossible de combiner avec pr.
promptNonInvite de lancement. N’incluez pas de secrets ou de contenu utilisateur sensible dans les URL.
modeNonUn des plan, interactiveou autopilot.
agentNonID ou nom de l’agent personnalisé. Uniquement pris en charge sans dépôt.

Création d’un projet

Utilisez ghapp://project/new pour créer un nouveau projet persistant après avoir cliqué sur Autoriser. Ce lien n’ouvre pas de projet existant.

ghapp://project/new?name=Release&repo=OWNER%2FREPO

Encodé dans l’URL du lanceur, qui devient :

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fproject%2Fnew%3Fname%3DRelease%26repo%3DOWNER%252FREPO

Tous les paramètres sont facultatifs :

ParamètreRemarques
nameNom du Project, jusqu’à 40 caractères.
colorL’un des éléments suivants : neutral, green, blue, violet, pink, red, orange ou yellow.
iconNom de l’icône Lucide, tel que Rocket ou BookOpen.
repoRéférentiel à cloner et configurer pour le Project, au format OWNER/REPO. Répétez ce paramètre pour plusieurs dépôts.
promptInvite de lancement qui s’exécute après approbation, même sans dépôts. N’incluez pas de secrets ou de contenu utilisateur sensible dans les URL.

Sans instruction, le Project configure tous les référentiels fournis. Sans invite de commande ni dépôts, il offre une configuration de dépôt.

Sélectionner un modèle

Permet ghapp://?select_model=MODEL_ID d’ouvrir la nouvelle page de session dans l’application et de sélectionner un modèle activé après confirmation. Remplacez MODEL_ID par l’ID du modèle, ou utilisez auto pour sélectionner Copilot Fusion ou Auto, en fonction des paramètres de votre application :

ghapp://?select_model=auto

Encodé dans l’URL du lanceur, qui devient :

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2F%3Fselect_model%3Dauto

Cela modifie uniquement la sélection du modèle. Il conserve votre brouillon de session non envoyé et le niveau d’effort automatique actuel, et ne crée pas de session ou n’envoie pas d’invite. Les liens de sélection de modèle fonctionnent pour les sessions locales ou de worktree, et non pour les sessions cloud. Si le modèle demandé n’est pas disponible ou désactivé par stratégie, l’application affiche une erreur au lieu de sélectionner un autre modèle.

Ouvrir les automatisations

Pour ouvrir des automatisations ou créer un brouillon d’automatisation à partir d’un lien profond, utilisez les liens d’application Automation. Pour connaître les paramètres disponibles lors de la création d’un brouillon d’automatisation, consultez paramètres Automation.

  • Pour ouvrir la page Automations, utilisez ce lien d’application :

    ghapp://automations
    

    Encodé dans l’URL du lanceur, qui devient :

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations
    
  • Pour ouvrir un nouveau brouillon d’automatisation, utilisez ce lien d’application :

    ghapp://automations/new?name=Daily%20triage&trigger=daily&time=09%3A00&prompt=Summarize%20new%20issues
    

    Encodé dans l’URL du lanceur, qui devient :

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2Fnew%3Fname%3DDaily%2520triage%26trigger%3Ddaily%26time%3D09%253A00%26prompt%3DSummarize%2520new%2520issues
    
  • Pour ouvrir une automatisation existante, utilisez ce lien d’application :

    ghapp://automations/AUTOMATION_ID
    

    Encodé dans l’URL du lanceur, qui devient :

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID
    
  • Pour ouvrir une automatisation cloud, ajoutez-y mode=cloud le lien d’application avant de l’encoder :

    ghapp://automations/AUTOMATION_ID?mode=cloud
    

    Encodé dans l’URL du lanceur, qui devient :

    https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID%3Fmode%3Dcloud
    

Paramètres d’automatisation

Le lien ghapp://automations/new ouvre la nouvelle boîte de dialogue d’automatisation. Elle ne crée pas l’automatisation tant que l’utilisateur n’a pas examiné la boîte de dialogue et qu’il confirme dans l’application. N’incluez pas de secrets ou de contenu utilisateur sensible dans les invites incorporées dans les URL.

ParamètreS’applique àRemarques
nameghapp://automations/newNom de l’automatisation.
promptghapp://automations/newInstruction d’automatisation. N’incluez pas de secrets ou de contenu utilisateur sensible dans les URL.
triggerghapp://automations/newUn des manual, , hourly, dailyou weekly. Les valeurs non valides sont ignorées.
interval est également accepté comme alias.
timeghapp://automations/newHeure au format HH:mm local sur 24 heures. Pris en charge pour les déclencheurs daily et weekly. Les déclencheurs quotidiens acceptent également des heures séparées par des virgules ou répétées lorsque toutes les entrées partagent la même minute, par exemple time=08:00,13:00. Les valeurs non valides sont ignorées.
dayghapp://automations/newJour hebdomadaire en tant que 0-6 (0 = dimanche) ou nom de la semaine. Les valeurs non valides sont ignorées.
schedule_day est également accepté en tant qu’alias, et les déclencheurs hebdomadaires acceptent des valeurs séparées par des virgules ou répétées, telles que schedule_day=1,3,5.
mode
ghapp://automations/AUTOMATION_ID et ghapp://automations/AUTOMATION_ID/RUN_IDUtiliser cloud pour les automatisations cloud. Omettez-le ou utilisez-le local pour les automatisations locales.

Ouvrir des flux de plug-in

Pour ouvrir l’installation du plug-in ou les flux de la Place de marché à partir d’un lien profond, utilisez les liens de l’application de plug-in. Pour connaître les paramètres disponibles, consultez Paramètres du plug-in.

Par exemple, pour ouvrir le formulaire d’installation du plug-in avec une source préremplie, utilisez ce lien d’application :

ghapp://plugins/install?source=my-plugin%40acme

Encodé dans l’URL du lanceur, qui devient :

https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fplugins%2Finstall%3Fsource%3Dmy-plugin%2540acme

Paramètres du plug-in

Les liens de plug-in ouvrent la page Personnaliser avec un formulaire prérempli. Ils n’installent pas de plug-in ou n’ajoutent pas de place de marché tant que l’utilisateur n’a pas confirmé dans l’application.

LienParamètreObligatoireRemarques
ghapp://plugins/installsourceOuiSource du plug-in au PLUGIN@MARKETPLACE format. Encodez l’URL de la valeur, par exemple source=my-plugin%40acme.
ghapp://plugins/marketplace/addsourceOuiSource Marketplace sous la forme de OWNER/REPO ou d’une URL Git. Encodez l’URL de la valeur, par exemple source=acme%2Fplugins.

Les liens d’application suivants peuvent être encapsulés dans le lanceur hébergé. Les chaînes de requête et les hachages sont conservés lorsque l’application ouvre le lien.

Forme de lien d’applicationS’ouvreRemarques
ghapp://NouveauOuvre la nouvelle vue pour démarrer une nouvelle session.
ghapp://?select_model=MODEL_IDSélection du modèle sur la nouvelle page de sessionAffiche une confirmation avant de sélectionner le modèle demandé. Voir Sélectionner un modèle.
ghapp://project/newNouveau projetAffiche une confirmation avant de créer un projet persistant. Consultez Créer un projet.
ghapp://chatsConversationsOuvre les conversations.
ghapp://myworkMon travailOuvre des problèmes et des demandes de tirage dans Mon travail.
ghapp://github.com/OWNER/REPOConfiguration du référentielOuvre ou clone le référentiel.
ghapp://github.com/OWNER/REPO/issues/NUMBERProblèmeOuvre l’issue dans l’application lorsque le dépôt est déjà connecté à l’application.
ghapp://github.com/OWNER/REPO/pull/NUMBERDemande de tirage (pull request)Ouvre la pull request dans l’application lorsque le dépôt est déjà connecté à l’application. Les segments de chemin de fin facultatifs sont conservés.
ghapp://github.com/OWNER/REPO/tasks/TASK_IDTâche de l’agentReprend une tâche d’agent GitHub Copilot . Utilisez l’ID de GitHub tâche, et non un ID de session local d’application.
ghapp://automationsAutomationsOuvre les automatisations.
ghapp://automations/newNouveau brouillon d’automatisationOuvre la nouvelle boîte de dialogue d’automatisation préremplie avec les paramètres de requête pris en charge. Consultez les paramètres d’automatisation.
ghapp://automations/AUTOMATION_IDAutomationOuvre une automatisation locale par défaut. Ajouter ?mode=cloud pour une automatisation du cloud.
ghapp://automations/AUTOMATION_ID/RUN_IDExécution d’automatisationOuvre une automatisation locale exécutée par défaut. Ajouter ?mode=cloud pour une exécution d’automatisation cloud.
ghapp://recentEspaces de travail récentsOuvre les espaces de travail récents.
ghapp://sessions/SESSION_IDSession de l’applicationOuvre un espace de travail ou une session local d’application. N’utilisez pas cette forme pour reprendre les tâches de l’agent Copilot GitHub.
ghapp://clone/OWNER/REPOConfiguration du référentielAffiche une confirmation avant le clonage ou l’ouverture de la configuration du référentiel.
ghapp://repo/OWNER/REPOConfiguration du référentielAffiche une confirmation avant le clonage ou l’ouverture de la configuration du référentiel.
ghapp://session/newNouvelle sessionAffiche une confirmation avant de créer une session de dépôt ou de préparer un brouillon sans dépôt. Consultez les paramètres de session.
ghapp://session/new/OWNER/REPONouvelle session pour un référentielAffiche une confirmation avant de créer une session pour le référentiel. Consultez les paramètres de session.
ghapp://plugins/installFormulaire d’installation du plug-inAffiche une confirmation, puis ouvre Customize avec le formulaire d’installation prérempli. Consultez les paramètres du plug-in.
ghapp://plugins/marketplace/addFormulaire de la marketplace des pluginsAffiche une confirmation, puis ouvre Personnaliser avec le formulaire place de marché prérempli. Consultez les paramètres du plug-in.