Konfigurieren deiner GitHub-App für deine Copilot-Erweiterung

Hier erfährst du, wie du deine GitHub App so konfigurierst, dass sie deiner Copilot agent zugeordnet ist.

Tool navigation

In diesem Artikel

Note

GitHub Copilot Extensions befinden sich in der public preview und können noch geändert werden.

Wenn du deinen Server konfiguriert und deine GitHub App erstellt hast, musst du deine GitHub App für das Verwenden mit deinem Copilot-Agent konfigurieren.

Voraussetzungen

Konfigurieren Ihrer GitHub App

  1. Klicke auf GitHub in der oberen rechten Ecke einer beliebigen Seite auf dein Profilfoto.

  2. 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:
      1. Klicke Sie auf Ihre Organisationen.
      2. Klicken Sie rechts neben der Organisation auf Einstellungen.
    • Für eine App im Besitz eines Unternehmens:
      1. Wenn Sie Enterprise Managed Users verwenden, klicken Sie auf Ihr Unternehmen, um direkt zu den Enterprise-Konto Einstellungen zu wechseln.
      2. Wenn Sie persönliche Konten verwenden, klicken Sie auf Ihre Unternehmen und dann rechts neben dem Unternehmen auf Einstellungen.

  3. Navigieren Sie zu den GitHub App-Einstellungen.

    • Für eine App, die einem persönlichen Konto oder einer Organisation gehört:
      1. Klicken Sie in der linken Randleiste auf Entwicklereinstellungen, und dann auf GitHub Apps.
    • Für eine App im Besitz eines Unternehmens:
      1. Klicken Sie in der linken Randleiste unter „Einstellungen“, auf GitHub Apps.

  4. Klicken Sie rechts neben der GitHub App, die Sie für Ihre Copilot Extension konfigurieren möchten, auf Bearbeiten.

  5. Gib im Abschnitt „Identifying and authorizing users“ unter „Callback URL“ die Rückruf-Endpunkt-URL ein und klicke auf Save changes.

    Note

    Der Hostname Ihres Servers ist der Weiterleitungsendpunkt, den Sie beim Konfigurieren des Servers aus Ihrem Terminal kopiert haben. Weitere Informationen findest du unter Konfigurieren deines Servers zum Hosten deiner Copilot-Erweiterung.

    Wenn Sie eine kurzlebige Domäne in ngrok verwenden, müssen Sie diese URL jedes Mal aktualisieren, wenn Sie den ngrok-Server neu starten.

  6. Klicken Sie in der linken Randleiste auf Berechtigungen und Ereignisse.

  7. Um den Abschnitt „Kontoberechtigungen“ zu erweitern, klicken Sie auf eine beliebige Stelle im Abschnitt.

  8. Wählen Sie in der Zeile GitHub Copilot Chat Einblendmenü Zugriff: und klicken Sie dann auf Schreibgeschützt.

  9. Wähle in der Zeile „Copilot Editor Context“ das Dropdownmenü Access: aus, und klicke dann auf Read-only, um den Empfang von Editor-Inhalten für die Anwendung zu aktivieren (z. B. die aktuell geöffnete Datei).

  10. Klicken Sie auf Änderungen speichern.

  11. Klicken Sie in der linken Randleiste auf Copilot.

  12. 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.

  13. Wählen Sie im Abschnitt „App-Typ“ das Einblendmenü aus, und klicken Sie dann auf "Agent".

  14. 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.

  15. 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 Datenfeld deiner Erweiterung zeigen.

  16. 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.

  17. 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.

  18. Klicke oben rechts auf einer beliebigen Seite auf GitHub auf das GitHub Copilot-Symbol neben der Suchleiste.

    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.

  19. 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.

    Screenshot der neuen Konversationstaste, hervorgehoben durch einen dunkelorangenen Umriss.

  20. Rufen Sie Ihre Erweiterung auf, indem @EXTENSION-NAME angeben und dabei Leerzeichen im Namen der Erweiterung durch - ersetzen, und drücken Sie dann Enter.

  21. 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..

  22. Stellen Sie Ihrer Erweiterung im Chatfenster eine Frage. Beispiel: What is the software development lifecycle?.

  1. Klicke auf GitHub in der oberen rechten Ecke einer beliebigen Seite auf dein Profilfoto.

  2. 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:
      1. Klicke Sie auf Ihre Organisationen.
      2. Klicken Sie rechts neben der Organisation auf Einstellungen.
    • Für eine App im Besitz eines Unternehmens:
      1. Wenn Sie Enterprise Managed Users verwenden, klicken Sie auf Ihr Unternehmen, um direkt zu den Enterprise-Konto Einstellungen zu wechseln.
      2. Wenn Sie persönliche Konten verwenden, klicken Sie auf Ihre Unternehmen und dann rechts neben dem Unternehmen auf Einstellungen.

  3. Navigieren Sie zu den GitHub App-Einstellungen.

    • Für eine App, die einem persönlichen Konto oder einer Organisation gehört:
      1. Klicken Sie in der linken Randleiste auf Entwicklereinstellungen, und dann auf GitHub Apps.
    • Für eine App im Besitz eines Unternehmens:
      1. Klicken Sie in der linken Randleiste unter „Einstellungen“, auf GitHub Apps.

  4. Klicken Sie rechts neben der GitHub App, die Sie für Ihre Copilot Extension konfigurieren möchten, auf Bearbeiten.

  5. Gib im Abschnitt „Identifying and authorizing users“ unter „Callback URL“ die Rückruf-Endpunkt-URL ein und klicke auf Save changes.

    Note

    Der Hostname Ihres Servers ist der Weiterleitungsendpunkt, den Sie beim Konfigurieren des Servers aus Ihrem Terminal kopiert haben. Weitere Informationen findest du unter Konfigurieren deines Servers zum Hosten deiner Copilot-Erweiterung.

    Wenn Sie eine kurzlebige Domäne in ngrok verwenden, müssen Sie diese URL jedes Mal aktualisieren, wenn Sie den ngrok-Server neu starten.

  6. Klicken Sie in der linken Randleiste auf Berechtigungen und Ereignisse.

  7. Um den Abschnitt „Kontoberechtigungen“ zu erweitern, klicken Sie auf eine beliebige Stelle im Abschnitt.

  8. Wählen Sie in der Zeile GitHub Copilot Chat Einblendmenü Zugriff: und klicken Sie dann auf Schreibgeschützt.

  9. Wähle in der Zeile „Copilot Editor Context“ das Dropdownmenü Access: aus, und klicke dann auf Read-only, um den Empfang von Editor-Inhalten für die Anwendung zu aktivieren (z. B. die aktuell geöffnete Datei).

  10. Klicken Sie auf Änderungen speichern.

  11. Klicken Sie in der linken Randleiste auf Copilot.

  12. 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.

  13. Wähle im Abschnitt „App type“ das Dropdownmenü aus, und klicke dann auf Skillset.

  14. 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.

  15. Für jeden Skill, den du hinzufügen möchtest (maximal 5):

    1. Klicke auf Add new skill.
    2. Gib einen verständlichen Name für den Skill ein, z. B. „Generate Lorem Ipsum Data“.
    3. Schreibe eine detaillierte Inference description, damit Copilot weiß, wann dieser Skill angewendet werden soll.
    4. Füge deine API-Endpunkt-URL hinzu, die die POST-Anforderungen empfängt.
    5. Füge im Feld Parameter das JSON-Schema hinzu, das das erwartete Anforderungsformat definiert.
    6. Klicke auf Add Definition, um den Skill zu speichern.

  16. Klicke auf Save, um das Skillset zu speichern.

  17. 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.

  18. Klicke oben rechts auf einer beliebigen Seite auf GitHub auf das GitHub Copilot-Symbol neben der Suchleiste.

    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.

  19. 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.

    Screenshot der neuen Konversationstaste, hervorgehoben durch einen dunkelorangenen Umriss.

  20. Rufen Sie Ihre Erweiterung auf, indem @EXTENSION-NAME angeben und dabei Leerzeichen im Namen der Erweiterung durch - ersetzen, und drücken Sie dann Enter.

  21. 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..

  22. Stellen Sie Ihrer Erweiterung im Chatfenster eine Frage. Beispiel: What is the software development lifecycle?.