Note
GitHub Copilot Extensions befinden sich in der public preview und können noch geändert werden.
Wenn Sie Ihren Server konfiguriert und Ihre GitHub App erstellt haben, müssen Sie Ihre GitHub App für die Verwendung mit Ihrem Copilot-Agent konfigurieren.
Voraussetzungen
- Sie haben Ihren Server so konfiguriert, dass Ihr Copilot agent bereitgestellt wird, und Sie haben Ihren Hostnamen (auch als Weiterleitungsendpunkt bezeichnet). Weitere Informationen finden Sie unter Configuring your server to host your Copilot agent.
- Sie haben eine GitHub App für Ihren Copilot-Agent erstellt. Weitere Informationen finden Sie unter Erstellen einer GitHub-App für Ihre Copilot-Erweiterung.
Konfigurieren Ihrer GitHub App
-
Klicke auf GitHub in der oberen rechten Ecke einer beliebigen Seite auf dein Profilfoto.
-
Navigieren Sie zu den Einstellungen für Ihr Konto.
- Klicken Sie bei einer App, die zu einem persönlichen Konto gehört, auf Einstellungen.
- Für eine App im Besitz einer Organisation:
- Klicke Sie auf Ihre Organisationen.
- Klicken Sie rechts neben der Organisation auf Einstellungen.
- Für eine App im Besitz eines Unternehmens:
- Wenn Sie Enterprise Managed Users verwenden, klicken Sie auf Ihr Unternehmen, um direkt zu den Enterprise-Konto Einstellungen zu wechseln.
- Wenn Sie persönliche Konten verwenden, klicken Sie auf Ihre Unternehmen und dann rechts neben dem Unternehmen auf Einstellungen.
-
Navigieren Sie zu den GitHub App-Einstellungen.
- Für eine App, die einem persönlichen Konto oder einer Organisation gehört:
- Klicken Sie in der linken Randleiste auf Entwicklereinstellungen, und dann auf GitHub Apps.
- Für eine App im Besitz eines Unternehmens:
- Klicken Sie in der linken Randleiste unter „Einstellungen“, auf GitHub Apps.
- Für eine App, die einem persönlichen Konto oder einer Organisation gehört:
-
Klicken Sie rechts neben der GitHub App, die Sie für Ihre Copilot Extension konfigurieren möchten, auf Bearbeiten.
-
Geben Sie im Abschnitt „Identifizieren und Autorisieren von Benutzern“ unter „Rückruf-URL“ den Hostnamen Ihres Servers ein und klicken Sie dann auf Änderungen speichern.
Note
Dieser Schritt ist nur erforderlich, wenn Sie während der Installation die Benutzerautorisierung (OAuth) anfordern möchten.
Der Hostname Ihres Servers ist der Weiterleitungsendpunkt, den Sie beim Konfigurieren des Servers aus Ihrem Terminal kopiert haben. Weitere Informationen findest du unter Configuring your server to host your Copilot agent.
Wenn Sie eine kurzlebige Domäne in ngrok verwenden, müssen Sie diese URL jedes Mal aktualisieren, wenn Sie den ngrok-Server neu starten.
-
Klicken Sie in der linken Randleiste auf Berechtigungen und Ereignisse.
-
Um den Abschnitt „Kontoberechtigungen“ zu erweitern, klicken Sie auf eine beliebige Stelle im Abschnitt.
-
Wählen Sie in der Zeile GitHub Copilot Chat Einblendmenü Zugriff: und klicken Sie dann auf Schreibgeschützt. Klicke auf Änderungen speichern.
-
Klicken Sie in der linken Randleiste auf Copilot.
-
Lesen Sie die GitHub Marketplace Entwicklervereinbarung und die GitHub Lizenzbedingungen vor der Veröffentlichung, und akzeptieren Sie dann die Bedingungen zum Erstellen einer Copilot Extension.
-
Wählen Sie im Abschnitt „App-Typ“ das Einblendmenü aus, und klicken Sie dann auf "Agent".
-
Geben Sie unter „URL“ den Hostnamen Ihres Servers (auch als Weiterleitungsendpunkt bezeichnet) ein, den Sie aus Ihrem Terminal kopiert haben.
Note
Wenn Sie eine kurzlebige Domäne in ngrok verwenden, müssen Sie diese URL jedes Mal aktualisieren, wenn Sie den ngrok-Server neu starten.
-
Geben Sie unter „Rückschlussbeschreibung“ eine kurze Beschreibung Ihres Agents ein und klicken Sie dann auf Speichern. Dies ist die Beschreibung, die Benutzern angezeigt wird, wenn sie mit dem Mauszeiger im Chatfenster auf das Platzhalterfeld Ihres Agents zeigen.
-
Ihre Vorautorisierungs-URL ist ein Link auf Ihrer Website, der den Autorisierungsprozess für Ihre Erweiterung startet. Benutzer werden zu dieser URL umgeleitet, wenn sie sich für die Autorisierung Ihrer Erweiterung entscheiden. Wenn Sie eine Vorautorisierungs-URL verwenden, geben Sie unter „Vorautorisierungs-URL“ die URL ein und klicken Sie dann auf Änderungen speichern.
-
Klicken Sie in Ihren GitHub App-Einstellungen in der linken Randleiste auf App installieren und dann neben dem Konto, auf dem Sie Ihre App installieren möchten, auf Installieren.
-
Klicken Sie auf einer beliebigen Seite in GitHub auf das Symbol GitHub Copilot unten rechts auf der Seite.
Der Bereich GitHub Copilot Chat wird angezeigt. Um die Größe des Bereichs zu ändern, klicken Sie auf den oberen oder linken Rand und ziehen Sie ihn.
-
Wenn der Bereich eine frühere Konversation enthält, die Sie mit Copilot geführt haben, klicken Sie auf das Symbol „Neue Konversation“ (ein Pluszeichen) oben rechts im Bereich.
-
Rufen Sie Ihre Erweiterung auf, indem
@EXTENSION-NAME
angeben und dabei Leerzeichen im Namen der Erweiterung durch-
ersetzen, und drücken Sie dannEnter
. -
Wenn Sie die Erweiterung zum ersten Mal verwenden, werden Sie aufgefordert, sich zu authentifizieren. Gehen Sie zum Autorisieren Ihrer Erweiterung nach den am Bildschirm angezeigten Schritten vor..
-
Stellen Sie Ihrer Erweiterung im Chatfenster eine Frage. Beispiel:
What is the software development lifecycle?
.