{"meta":{"title":"Utiliser des liens directs pour ouvrir l’application GitHub Copilot","intro":"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.","product":"GitHub Copilot","breadcrumbs":[{"href":"/fr/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/fr/enterprise-cloud@latest/copilot/how-tos","title":"Procédures"},{"href":"/fr/enterprise-cloud@latest/copilot/how-tos/github-copilot-app","title":"GitHub Copilot app"},{"href":"/fr/enterprise-cloud@latest/copilot/how-tos/github-copilot-app/open-with-deep-links","title":"Ouvrir avec des liens profonds"}],"documentType":"article"},"body":"# Utiliser des liens directs pour ouvrir l’application GitHub Copilot\n\nUtilisez 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.\n\nLes 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.\n\nVous 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](#available-app-links).\n\n## Pourquoi utiliser des liens profonds\n\nUtilisez 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 :\n\n* Démarrez des sessions avec une requête de lancement préremplie.\n* Partagez des invites d’automatisation afin que les collègues puissent les ouvrir et les réutiliser rapidement.\n* Ajoutez des boutons de lancement dans des documents internes ou des fichiers Markdown pour ouvrir des flux de travail courants.\n* Lancez l’application à partir de commandes ou de scripts de terminal dans le cadre de flux de travail locaux.\n* Ouvrez l’application à partir de produits tiers, comme des systèmes de gestion des incidents ou de tickets.\n\n## Format de l’URL du lanceur\n\nUtilisez 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.\n\n```text\nhttps://github.com/copilot/app/launch?open=ENCODED_APP_LINK\n```\n\nUtilisez `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`.\n\nPar exemple, pour ouvrir un référentiel, le lien d’application est :\n\n```text\nghapp://github.com/OWNER/REPO\n```\n\nEncodé dans l’URL du lanceur, qui devient :\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO\n```\n\nLes 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://`.\n\n## Ouvrir un dépôt ou un élément de travail\n\nPour 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.\n\n* Pour ouvrir un référentiel, utilisez ce lien d’application :\n\n   ```text\n   ghapp://github.com/OWNER/REPO\n   ```\n\n   Encodé dans l’URL du lanceur, qui devient :\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO\n   ```\n\n* Pour ouvrir un problème, utilisez ce lien d’application :\n\n   ```text\n   ghapp://github.com/OWNER/REPO/issues/NUMBER\n   ```\n\n   Encodé dans l’URL du lanceur, qui devient :\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fissues%2F123\n   ```\n\n* Pour ouvrir une pull request, utilisez ce lien de l’application :\n\n   ```text\n   ghapp://github.com/OWNER/REPO/pull/NUMBER\n   ```\n\n   Encodé dans l’URL du lanceur, qui devient :\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fpull%2F123\n   ```\n\n* Pour reprendre une tâche d’agent, utilisez ce lien d’application :\n\n   ```text\n   ghapp://github.com/OWNER/REPO/tasks/TASK_ID\n   ```\n\n   Encodé dans l’URL du lanceur, qui devient :\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Ftasks%2FTASK_ID\n   ```\n\n   Utilisez l’ID de tâche GitHub pour `TASK_ID`. N’utilisez pas d’ID de session runtime ou d’URL de session locale d’application pour les liens qui reprendnt GitHubCopilot les tâches de l’agent.\n\n## Ouvrir des sessions\n\nPour 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](#session-parameters).\n\nPar exemple, pour démarrer une nouvelle session interactive avec un dépôt et une invite de lancement, utilisez ce lien d’application :\n\n```text\nghapp://session/new?repo=OWNER%2FREPO&mode=interactive&prompt=Investigate%20failing%20tests\n```\n\nEncodé dans l’URL du lanceur, qui devient :\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fsession%2Fnew%3Frepo%3DOWNER%252FREPO%26mode%3Dinteractive%26prompt%3DInvestigate%2520failing%2520tests\n```\n\n### Paramètres de session\n\nLes liens `ghapp://session/new` et `ghapp://session/new/OWNER/REPO` acceptent ces paramètres de requête.\n\n| Paramètre | Obligatoire | Remarques |\n| --- | --- | --- |\n| `repo` | Obligatoire pour `ghapp://session/new`; facultatif pour `ghapp://session/new/OWNER/REPO` | Dépôt au format `OWNER/REPO`. |\n| `pr` | Non | Numéro de pull request positif. Impossible de combiner avec `branch`. |\n| `branch` | Non | Branche de base pour la nouvelle session. Impossible de combiner avec `pr`. |\n| `prompt` | Non | Invite de lancement. N’incluez pas de secrets ou de contenu utilisateur sensible dans les URL. |\n| `mode` | Non | Un des `plan`, `interactive`ou `autopilot`. |\n\n## Ouvrir les automatisations\n\nPour 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](#automation-parameters).\n\n* Pour ouvrir la page Automations, utilisez ce lien d’application :\n\n   ```text\n   ghapp://automations\n   ```\n\n   Encodé dans l’URL du lanceur, qui devient :\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations\n   ```\n\n* Pour ouvrir un nouveau brouillon d’automatisation, utilisez ce lien d’application :\n\n   ```text\n   ghapp://automations/new?name=Daily%20triage&trigger=daily&time=09%3A00&prompt=Summarize%20new%20issues\n   ```\n\n   Encodé dans l’URL du lanceur, qui devient :\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2Fnew%3Fname%3DDaily%2520triage%26trigger%3Ddaily%26time%3D09%253A00%26prompt%3DSummarize%2520new%2520issues\n   ```\n\n* Pour ouvrir une automatisation existante, utilisez ce lien d’application :\n\n   ```text\n   ghapp://automations/AUTOMATION_ID\n   ```\n\n   Encodé dans l’URL du lanceur, qui devient :\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID\n   ```\n\n* Pour ouvrir une automatisation cloud, ajoutez-y `mode=cloud` le lien d’application avant de l’encoder :\n\n   ```text\n   ghapp://automations/AUTOMATION_ID?mode=cloud\n   ```\n\n   Encodé dans l’URL du lanceur, qui devient :\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID%3Fmode%3Dcloud\n   ```\n\n### Paramètres d’automatisation\n\nLe 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.\n\n| Paramètre | S’applique à | Remarques |\n| --- | --- | --- |\n| `name` | `ghapp://automations/new` | Nom de l’automatisation. |\n| `prompt` | `ghapp://automations/new` | Instruction d’automatisation. N’incluez pas de secrets ou de contenu utilisateur sensible dans les URL. |\n| `trigger` | `ghapp://automations/new` | Un des `manual`, , `hourly`, `daily`ou `weekly`. Les valeurs non valides sont ignorées. \n`interval` est également accepté comme alias. |\n| `time` | `ghapp://automations/new` | Heure 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. |\n| `day` | `ghapp://automations/new` | Jour hebdomadaire en tant que `0`-`6` (`0` = dimanche) ou nom de la semaine. Les valeurs non valides sont ignorées. \n`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`. |\n| `mode` | \n`ghapp://automations/AUTOMATION_ID` et `ghapp://automations/AUTOMATION_ID/RUN_ID` | Utiliser `cloud` pour les automatisations cloud. Omettez-le ou utilisez-le `local` pour les automatisations locales. |\n\n## Ouvrir des flux de plug-in\n\nPour 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](#plugin-parameters).\n\nPar exemple, pour ouvrir le formulaire d’installation du plug-in avec une source préremplie, utilisez ce lien d’application :\n\n```text\nghapp://plugins/install?source=my-plugin%40acme\n```\n\nEncodé dans l’URL du lanceur, qui devient :\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fplugins%2Finstall%3Fsource%3Dmy-plugin%2540acme\n```\n\n### Paramètres du plug-in\n\nLes liens de plug-in ouvrent la vue **Plug-ins** dans **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.\n\n| Lien | Paramètre | Obligatoire | Remarques |\n| --- | --- | --- | --- |\n| `ghapp://plugins/install` | `source` | Oui | Source du plug-in au `PLUGIN@MARKETPLACE` format. Encodez l’URL de la valeur, par exemple `source=my-plugin%40acme`. |\n| `ghapp://plugins/marketplace/add` | `source` | Oui | Source Marketplace sous la forme de `OWNER/REPO` ou d’une URL Git. Encodez l’URL de la valeur, par exemple `source=acme%2Fplugins`. |\n\n## Liens d’application disponibles\n\nLes 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.\n\n| Forme de lien d’application | S’ouvre | Remarques |\n| --- | --- | --- |\n| `ghapp://` | Domicile | Ouvre l’itinéraire d’accueil de l’application. |\n| `ghapp://chats` | Conversations | Ouvre les conversations. |\n| `ghapp://mywork` | Mon travail | Ouvre des problèmes et des demandes de tirage dans Mon travail. |\n| `ghapp://github.com/OWNER/REPO` | Configuration du référentiel | Ouvre ou clone le référentiel. |\n| `ghapp://github.com/OWNER/REPO/issues/NUMBER` | Problème | Ouvre le problème dans Mon travail lorsque le référentiel est déjà ajouté en tant que projet. |\n| `ghapp://github.com/OWNER/REPO/pull/NUMBER` | Demande de tirage (pull request) | Ouvre la pull request dans Mon travail lorsque le dépôt est déjà ajouté en tant que projet. Les segments de chemin de fin facultatifs sont conservés. |\n| `ghapp://github.com/OWNER/REPO/tasks/TASK_ID` | Tâche de l’agent | Reprend la tâche d’un agent GitHubCopilot. Utilisez l’ID de GitHub tâche, et non un ID de session local d’application. |\n| `ghapp://automations` | Automations | Ouvre les automatisations. |\n| `ghapp://automations/new` | Nouveau brouillon d’automatisation | Ouvre 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](#automation-parameters). |\n| `ghapp://automations/AUTOMATION_ID` | Automation | Ouvre une automatisation locale par défaut. Ajouter `?mode=cloud` pour une automatisation du cloud. |\n| `ghapp://automations/AUTOMATION_ID/RUN_ID` | Exécution d’automatisation | Ouvre une automatisation locale exécutée par défaut. Ajouter `?mode=cloud` pour une exécution d’automatisation cloud. |\n| `ghapp://recent` | Espaces de travail récents | Ouvre les espaces de travail récents. |\n| `ghapp://sessions/SESSION_ID` | Session de l’application | Ouvre 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. |\n| `ghapp://clone/OWNER/REPO` | Configuration du référentiel | Affiche une confirmation avant le clonage ou l’ouverture de la configuration du référentiel. |\n| `ghapp://repo/OWNER/REPO` | Configuration du référentiel | Affiche une confirmation avant le clonage ou l’ouverture de la configuration du référentiel. |\n| `ghapp://session/new` | Nouvelle session | Affiche une confirmation avant de créer une session. Utilisez les paramètres de requête pour fournir le référentiel, la pull request, la branche, le prompt ou le mode de session. Consultez [les paramètres de session](#session-parameters). |\n| `ghapp://session/new/OWNER/REPO` | Nouvelle session pour un référentiel | Affiche une confirmation avant de créer une session pour le référentiel. Consultez [les paramètres de session](#session-parameters). |\n| `ghapp://plugins/install` | Formulaire d’installation du plug-in | Affiche une confirmation, puis ouvre la vue **Plug-ins** dans l’onglet **Personnaliser** avec le formulaire d’installation prérempli. Consultez [les paramètres du plug-in](#plugin-parameters). |\n| `ghapp://plugins/marketplace/add` | Formulaire de la marketplace des plugins | Affiche une confirmation, puis ouvre la vue **Plug-ins** dans l’onglet **Personnaliser** avec le formulaire marketplace prérempli. Consultez [les paramètres du plug-in](#plugin-parameters). |"}