{"meta":{"title":"Deep Links zum Öffnen der GitHub Copilot-App verwenden","intro":"Verwenden Sie Deep-Links, um die GitHub Copilot app über das Terminal, Tickets und interne Tools zu starten, damit Personen direkt zum richtigen Repository, Pull Request, zur richtigen Automatisierung oder Sitzung springen können.","product":"GitHub Copilot","breadcrumbs":[{"href":"/de/copilot","title":"GitHub Copilot"},{"href":"/de/copilot/how-tos","title":"Vorgehensweisen"},{"href":"/de/copilot/how-tos/github-copilot-app","title":"GitHub Copilot app"},{"href":"/de/copilot/how-tos/github-copilot-app/open-with-deep-links","title":"Öffnen mit Deep-Links"}],"documentType":"article"},"body":"# Deep Links zum Öffnen der GitHub Copilot-App verwenden\n\nVerwenden Sie Deep-Links, um die GitHub Copilot app über das Terminal, Tickets und interne Tools zu starten, damit Personen direkt zum richtigen Repository, Pull Request, zur richtigen Automatisierung oder Sitzung springen können.\n\nDeep-Links helfen Menschen, ihre Arbeit im GitHub Copilot app mit weniger Kontextwechsel zu beginnen. Sie können z. B. Startaufforderungen freigeben, Links zur App in Markdowndateien einfügen, die App über Terminalskripts starten oder eine Schaltfläche hinzufügen, um die App in externen Tools zu öffnen.\n\nSie können die GitHub Copilot app über Browserlinks öffnen, die einen App-Link im gehosteten Startprogramm umschließen. Das gehostete Startprogramm öffnet die App, wenn möglich, und zeigt eine Fallbackseite an, wenn der Browser nicht an die App übergeben kann. Eine vollständige Liste der unterstützten App-Links finden Sie unter [\"Verfügbare App-Links\"](#available-app-links).\n\n## Gründe für die Verwendung von Deep-Links\n\nVerwenden Sie Deep-Links, wenn Sie direkt von einer Webseite oder einem Workflow zu einer bestimmten Seite oder Aufgabe in der App wechseln möchten. Zu den gängigen Anwendungsfällen gehören:\n\n* Starten Sie Sitzungen mit einem vorausgefüllten Kickoff-Prompt.\n* Geben Sie Automatisierungsaufforderungen frei, damit Teamkollegen sie schnell öffnen und wiederverwenden können.\n* Fügen Sie Startschaltflächen in internen Dokumenten oder Markdowndateien hinzu, um allgemeine Workflows zu öffnen.\n* Starten Sie die App über Terminalbefehle oder Skripts als Teil lokaler Workflows.\n* Öffnen Sie die App aus Drittanbieterprodukten wie Issue- oder Ticketsystemen.\n\n## Startprogramm-URL-Format\n\nVerwenden Sie die gehostete Launcher-URL, in der der vollständige App-Link im Abfrageparameter `open` codiert ist. Das gehostete Startprogramm öffnet die App, wenn möglich, und zeigt eine Fallbackseite an, wenn der Browser nicht an die App übergeben kann.\n\n```text\nhttps://github.com/copilot/app/launch?open=ENCODED_APP_LINK\n```\n\nVerwenden Sie `encodeURIComponent` oder das entsprechende Äquivalent in Ihrer Programmiersprache, um den vollständigen App-Link zu codieren. Wenn der App-Link Abfrageparameter enthält, kodieren Sie deren Werte, bevor Sie den vollständigen App-Link für `open` kodieren.\n\nUm beispielsweise ein Repository zu öffnen, lautet der App-Link:\n\n```text\nghapp://github.com/OWNER/REPO\n```\n\nIn der Launcher-URL codiert ergibt das:\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO\n```\n\nÖffentliche Links sollten das offizielle `ghapp://` Schema verwenden. Die App akzeptiert aus Kompatibilitätsgründen auch `github-app://`- und `gh://`-Links, aber generierte und dokumentierte Links sollten `ghapp://` verwenden.\n\n## Öffnen Sie ein Repository oder Arbeitselement\n\nUm eine Seite im GitHub Copilot app zu öffnen, erstellen Sie eine Launcher-URL mithilfe des App-Links der Seite, die Sie öffnen möchten.\n\n* Um ein Repository zu öffnen, verwenden Sie diesen App-Link:\n\n   ```text\n   ghapp://github.com/OWNER/REPO\n   ```\n\n   In der Launcher-URL codiert ergibt das:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO\n   ```\n\n* Verwenden Sie diesen App-Link, um ein Issue zu öffnen:\n\n   ```text\n   ghapp://github.com/OWNER/REPO/issues/NUMBER\n   ```\n\n   In der Launcher-URL codiert ergibt das:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fissues%2F123\n   ```\n\n* Verwenden Sie diesen App-Link, um eine Pullanforderung zu öffnen:\n\n   ```text\n   ghapp://github.com/OWNER/REPO/pull/NUMBER\n   ```\n\n   In der Launcher-URL codiert ergibt das:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Fpull%2F123\n   ```\n\n* Um eine Agentaufgabe fortzusetzen, verwenden Sie diesen App-Link:\n\n   ```text\n   ghapp://github.com/OWNER/REPO/tasks/TASK_ID\n   ```\n\n   In der Launcher-URL codiert ergibt das:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fgithub.com%2FOWNER%2FREPO%2Ftasks%2FTASK_ID\n   ```\n\n   Verwenden Sie die GitHub Aufgaben-ID für `TASK_ID`. Verwenden Sie keine Laufzeitsitzungs-ID oder eine App-lokale Sitzungs-URL für Links, die GitHubCopilot-Agent-Aufgaben fortsetzen.\n\n## Öffnen von Sitzungen\n\nUm eine neue Sitzung über einen Deep-Link zu starten, verwenden Sie `ghapp://session/new` mit Abfrageparametern, um das Repository, den Branch, den Pull-Request, den Prompt oder den Modus vorab zu füllen. Verfügbare Parameter finden Sie unter [Sitzungsparameter](#session-parameters).\n\nUm beispielsweise eine neue interaktive Sitzung mit einem Repository und einer Startaufforderung zu starten, verwenden Sie diesen App-Link:\n\n```text\nghapp://session/new?repo=OWNER%2FREPO&mode=interactive&prompt=Investigate%20failing%20tests\n```\n\nIn der Launcher-URL codiert ergibt das:\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### Sitzungsparameter\n\nDie Links `ghapp://session/new` und `ghapp://session/new/OWNER/REPO` akzeptieren diese Abfrageparameter.\n\n| Parameter | Erforderlich | Hinweise |\n| --- | --- | --- |\n| `repo` | Erforderlich für `ghapp://session/new`; optional für `ghapp://session/new/OWNER/REPO` | Repository in `OWNER/REPO`-Format. |\n| `pr` | No | Positive Pull-Request-Nummer. Kann nicht mit `branch` kombiniert werden. |\n| `branch` | No | Basisbranch für die neue Sitzung. Kann nicht mit `pr` kombiniert werden. |\n| `prompt` | No | Auftakt-Prompt Schließen Sie keine geheimen oder vertraulichen Benutzerinhalte in URLs ein. |\n| `mode` | No | Einer der folgenden Werte: `plan`, `interactive` oder `autopilot`. |\n\n## Offene Automatisierungen\n\nUm Automatisierungen zu öffnen oder einen neuen Automatisierungsentwurf über einen Deep-Link zu erstellen, verwenden Sie die Automatisierungs-App-Links. Verfügbare Parameter beim Erstellen eines neuen Automatisierungsentwurfs finden Sie unter [Automatisierungsparameter](#automation-parameters).\n\n* Um die Seite \"Automatisierungen\" zu öffnen, verwenden Sie diesen App-Link:\n\n   ```text\n   ghapp://automations\n   ```\n\n   In der Launcher-URL codiert ergibt das:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations\n   ```\n\n* Verwenden Sie diesen App-Link, um einen neuen Automatisierungsentwurf zu öffnen:\n\n   ```text\n   ghapp://automations/new?name=Daily%20triage&trigger=daily&time=09%3A00&prompt=Summarize%20new%20issues\n   ```\n\n   In der Launcher-URL codiert ergibt das:\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* Verwenden Sie diesen App-Link, um eine vorhandene Automatisierung zu öffnen:\n\n   ```text\n   ghapp://automations/AUTOMATION_ID\n   ```\n\n   In der Launcher-URL codiert ergibt das:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID\n   ```\n\n* Um eine Cloud-Automatisierung zu öffnen, fügen Sie dem App-Link `mode=cloud` hinzu, bevor Sie ihn kodieren:\n\n   ```text\n   ghapp://automations/AUTOMATION_ID?mode=cloud\n   ```\n\n   In der Launcher-URL codiert ergibt das:\n\n   ```text\n   https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations%2FAUTOMATION_ID%3Fmode%3Dcloud\n   ```\n\n### Automatisierungsparameter\n\nDer `ghapp://automations/new` Link öffnet das neue Automatisierungsdialogfeld. Die Automatisierung wird erst erstellt, wenn der Benutzer das Dialogfeld überprüft und in der App bestätigt. Schließen Sie keine geheimen oder vertraulichen Benutzerinhalte in Eingabeaufforderungen ein, die in URLs eingebettet sind.\n\n| Parameter | Gilt für: | Hinweise |\n| --- | --- | --- |\n| `name` | `ghapp://automations/new` | Automatisierungsname. |\n| `prompt` | `ghapp://automations/new` | Automatisierungsaufforderung. Schließen Sie keine geheimen oder vertraulichen Benutzerinhalte in URLs ein. |\n| `trigger` | `ghapp://automations/new` | Einer von `manual`, `hourly`, , `daily`oder `weekly`. Ungültige Werte werden ignoriert. \n`interval` wird auch als Alias akzeptiert. |\n| `time` | `ghapp://automations/new` | Uhrzeit im `HH:mm` lokalen 24-Stunden-Format. Wird für `daily`- und `weekly`-Trigger unterstützt. Tägliche Trigger akzeptieren auch kommagetrennte oder wiederholte Zeiten, wenn alle Einträge dieselbe Minute aufweisen, z. B `time=08:00,13:00`. . . Ungültige Werte werden ignoriert. |\n| `day` | `ghapp://automations/new` | Wochentag als `0`-`6` (`0` = Sonntag) oder ein Wochentagsname. Ungültige Werte werden ignoriert. \n`schedule_day` wird ebenfalls als Alias akzeptiert, und wöchentliche Trigger akzeptieren durch Kommas getrennte oder wiederholte Werte, z. B. `schedule_day=1,3,5`. |\n| `mode` | \n`ghapp://automations/AUTOMATION_ID` und `ghapp://automations/AUTOMATION_ID/RUN_ID` | Verwenden Sie `cloud` für Cloud-Automatisierungen. Lassen Sie es weg oder verwenden Sie `local` für lokale Automatisierungen. |\n\n## Öffnen von Plug-In-Flüssen\n\nUm Plug-In-Installations- oder Marketplace-Flows über einen Deep-Link zu öffnen, verwenden Sie die Plug-In-App-Links. Verfügbare Parameter finden Sie unter [Plug-In-Parameter](#plugin-parameters).\n\nUm z. B. das Plug-In-Installationsformular mit einer bereits ausgefüllten Quelle zu öffnen, verwenden Sie diesen App-Link:\n\n```text\nghapp://plugins/install?source=my-plugin%40acme\n```\n\nIn der Launcher-URL codiert ergibt das:\n\n```text\nhttps://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fplugins%2Finstall%3Fsource%3Dmy-plugin%2540acme\n```\n\n### Plugin-Parameter\n\nPlugin-Links öffnen in **Customize** die Ansicht **Plugins** mit einem vorausgefüllten Formular. Sie installieren kein Plug-In oder fügen einen Marketplace hinzu, bis der Benutzer in der App bestätigt.\n\n| Link | Parameter | Erforderlich | Hinweise |\n| --- | --- | --- | --- |\n| `ghapp://plugins/install` | `source` | Yes | Plug-In-Quelle im `PLUGIN@MARKETPLACE` Format. URL-kodieren Sie den Wert, z. B. `source=my-plugin%40acme`. |\n| `ghapp://plugins/marketplace/add` | `source` | Yes | Marketplace-Quelle als `OWNER/REPO` oder Git-URL. URL-kodieren Sie den Wert, z. B. `source=acme%2Fplugins`. |\n\n## Verfügbare App-Links\n\nDie folgenden App-Links können in den gehosteten Launcher eingebettet werden. Abfragezeichenfolgen und Hashes bleiben erhalten, wenn die App den Link öffnet.\n\n| App-Link-Form | Öffnet | Hinweise |\n| --- | --- | --- |\n| `ghapp://` | Heim | Öffnet die Startseitenroute der App. |\n| `ghapp://chats` | Chats | Öffnet Chats. |\n| `ghapp://mywork` | Meine Arbeit | Öffnet Issues und Pull Requests in „Meine Arbeit“. |\n| `ghapp://github.com/OWNER/REPO` | Einrichtung des Repositorys | Öffnet oder klont das Repository. |\n| `ghapp://github.com/OWNER/REPO/issues/NUMBER` | Issue | Öffnet das Problem in \"Meine Arbeit\", wenn das Repository bereits als Projekt hinzugefügt wurde. |\n| `ghapp://github.com/OWNER/REPO/pull/NUMBER` | Pull-Anfrage | Öffnet die Pullanforderung in \"Meine Arbeit\", wenn das Repository bereits als Projekt hinzugefügt wurde. Optionale abschließende Pfadsegmente bleiben erhalten. |\n| `ghapp://github.com/OWNER/REPO/tasks/TASK_ID` | Agent-Aufgabe | Setzt die Aufgabe eines GitHubCopilot Agents fort. Verwenden Sie die GitHub Aufgaben-ID, keine app-lokale Sitzungs-ID. |\n| `ghapp://automations` | Automations | Öffnet Automatisierungen. |\n| `ghapp://automations/new` | Neuer Automatisierungsentwurf | Öffnet das neue Automatisierungsdialogfeld mit bereits ausgefüllten unterstützten Abfrageparametern. Siehe [Automatisierungsparameter](#automation-parameters). |\n| `ghapp://automations/AUTOMATION_ID` | Automation | Öffnet standardmäßig eine lokale Automatisierung. Hinzufügen `?mode=cloud` für eine Cloudautomatisierung. |\n| `ghapp://automations/AUTOMATION_ID/RUN_ID` | Automatisierungslauf | Öffnet standardmäßig eine lokale Automatisierungsausführung. \n`?mode=cloud` für einen Cloud-Automatisierungslauf hinzufügen. |\n| `ghapp://recent` | Zuletzt verwendete Arbeitsbereiche | Öffnet zuletzt verwendete Arbeitsbereiche. |\n| `ghapp://sessions/SESSION_ID` | App-Sitzung | Öffnet einen app-lokalen Arbeitsbereich oder eine App-Sitzung. Verwenden Sie diese Form nicht, um GitHub Copilot-Agent-Aufgaben fortzusetzen. |\n| `ghapp://clone/OWNER/REPO` | Einrichtung des Repositorys | Zeigt eine Bestätigung vor dem Klonen oder Öffnen des Repository-Setups an. |\n| `ghapp://repo/OWNER/REPO` | Einrichtung des Repositorys | Zeigt eine Bestätigung vor dem Klonen oder Öffnen des Repository-Setups an. |\n| `ghapp://session/new` | Neue Sitzung | Zeigt eine Bestätigung vor dem Erstellen einer Sitzung an. Verwenden Sie Query-Parameter, um das Repository, den Pull Request, den Branch, den Prompt oder den Sitzungsmodus anzugeben. Siehe [Sitzungsparameter](#session-parameters). |\n| `ghapp://session/new/OWNER/REPO` | Neue Sitzung für ein Repository | Zeigt eine Bestätigung vor dem Erstellen einer Sitzung für das Repository an. Siehe [Sitzungsparameter](#session-parameters). |\n| `ghapp://plugins/install` | Plug-In-Installationsformular | Zeigt eine Bestätigung an und öffnet dann die **Plug-In-Ansicht** auf der Registerkarte **\"Anpassen** \", wobei das Installationsformular bereits ausgefüllt ist. Siehe [Plug-In-Parameter](#plugin-parameters). |\n| `ghapp://plugins/marketplace/add` | Plugin-Marktplatzformular | Zeigt eine Bestätigung an, und öffnet dann die **Plug-In-Ansicht** auf der Registerkarte **\"Anpassen** \", wobei das Marketplace-Formular bereits ausgefüllt ist. Siehe [Plug-In-Parameter](#plugin-parameters). |"}