Note
GitHub Copilot Extensions befinden sich in der public preview und können noch geändert werden.
Dieser Artikel soll beim Erstellen einer neuen GitHub Copilot Extension helfen. Informationen zum schnellen Erstellen und Testen einer Demo einer Copilot Extension, die von GitHub erstellt wurden, findest du unter Schnellstart für GitHub Copilot-Erweiterungen mithilfe von Agents.
Mit Skillsets und Agents können die Funktionen und der Kontext von Copilot mithilfe der Copilot Extensibility Platform erweitert werden. Damit kannst du externe Dienste und APIs mit Copilot Chat integrieren. Jede Instanz hat verschiedene Anwendungsfälle und unterschiedliche Kontrollmöglichkeiten und Komplexitätsniveaus:
- Skillsets sind einfach, optimiert und für Entwickler erstellt, die Copilot zum Durchführen bestimmter Aufgaben mit geringem Setup benötigen, z. B. Abrufen von Daten oder einfache Vorgänge. Routing, das Erstellen von Prompts, das Auswerten von Funktionen und das Generieren von Antworten wird automatisch verarbeitet. Daher eignen sich Skillsets ideal für schnelle und einfache Integrationen. Weitere Informationen zu Skillsets findest du unter Informationen zu Copilot-Skillsets.
- Agents sind für komplexe Integrationen vorgesehen, die vollständige Kontrolle darüber erfordern, wie Anforderungen verarbeitet und Antworten generiert werden. So kannst du benutzerdefinierte Logik implementieren, mit anderen LLMs und/oder der Copilot-API integrieren, Unterhaltungskontext verwalten und dich um alle Aspekte der Benutzerinteraktion kümmern. Während Agents mehr Engineering und Wartung erfordern, bieten sie maximale Flexibilität für anspruchsvolle Workflows. Weitere Informationen zu Agents findest du unter Informationen über Copilot-Agents.
1. Sich informieren über Copilot agents
Copilot agents enthalten den benutzerdefinierten Code für Ihre Copilot Extension und lassen sich in eine GitHub App integrieren, um die eigentliche Copilot Extension zu bilden. Weitere Informationen finden Sie unter Informationen über Copilot-Agents.
Zum erfolgreichen Erstellen eines Copilot agent müssen Sie verstehen, wie der Agent mit Folgendem kommuniziert:
- Copilot-Plattform mit vom Server gesendeten Ereignissen. Weitere Informationen findest du unter Konfigurieren Ihres Copilot-Agents für die Kommunikation mit der Copilot-Plattform.
- GitHub-API. Weitere Informationen findest du unter Konfigurieren Ihres Copilot-Agents für die Kommunikation mit GitHub.
2. Beispiel für Copilot agents und Copilot Extensions-SDK durchsehen
Um die vorangehenden Konzepte in der Praxis zu sehen und mehr über Agent-Implementierungen zu erfahren, sollten Sie die folgenden Beispiel-Agents und das Software Development Kit (SDK) durchsehen, die in der copilot-extensions-Organisation zur Verfügung stehen:
- Blackbeard (bester Ausgangspunkt): Ein einfacher Agent, der Anforderungen beantwortet wie ein Pirat unter Verwendung der umfangreichen LLM-API von Copilot und spezieller Systemansagen.
- GitHub Models: Ein komplexerer Agent, mit dem Sie über den Copilot Chat bei verschiedenen auf dem GitHub Marketplace gelisteten LLMs anfragen und damit interagieren können. Der GitHub Models-Agent verwendet Funktionsaufrufe.
- Funktionsaufrufe: Ein In Go geschriebener Beispiel-Agent, der Funktionsaufrufe und Bestätigungsdialoge veranschaulicht.
- RAG-Erweiterung: Ein In Go geschriebener Beispiel-Agent, der eine einfache Implementierung der erweiterten Abrufgenerierung veranschaulicht.
- Preview SDK: Ein SDK, das die Entwicklung von Copilot Extensions durch automatisches Überprüfen der Anforderungen, Parsen der Payload und Formatieren der Antworten optimiert. Dank dieses SDK können sich Erweiterungsentwickler mehr auf die Erstellung von Kernfunktionen als auf Codebausteine konzentrieren.
3. Einen Copilot agent erstellen
Planen und erstellen Sie Ihren Copilot agent anhand des Referenzmaterials aus den vorherigen Schritten. Sie können sich für beliebige der folgenden Optionen entscheiden:
- Um die Erstellung und Verwaltung einer eigenen LLM-Bereitstellung zu vermeiden, kann Ihr Agent die Copilot-LLM-Bereitstellung aufrufen. Weitere Informationen findest du unter Verwenden des LLM von Copilot für Ihren Agent.
- Um Benutzereingaben schnell zu interpretieren und aus einer Vielzahl vordefinierter Funktionen auszuwählen, können Sie Funktionsaufrufe in Ihrem Agent implementieren. Weitere Informationen finden Sie unter Wie man Funktionsaufrufe mit Azure OpenAI Service verwendet in der Azure OpenAI-Dokumentation und unter Funktionsaufrufe in der OpenAI-Dokumentation.
4. Ihren Copilot agent bereitstellen
Um Ihren Copilot agent für die Copilot-Plattform und GitHub verfügbar zu machen, müssen Sie ihn auf einem Server bereitstellen, der durch eine HTTP-Anforderung erreichbar ist. Weitere Informationen findest du unter Konfigurieren deines Servers zum Hosten deiner Copilot-Erweiterung.
5. Eine GitHub App erstellen und in Ihren Copilot agent integrieren
Zum Erstellen einer Copilot Extension müssen Sie eine GitHub App erstellen und konfigurieren und sie dann in Ihren Copilot agent integrieren. Weitere Informationen findest du unter Erstellen einer GitHub-App für Ihre Copilot-Erweiterung und Konfigurieren deiner GitHub-App für deine Copilot-Erweiterung.
6. Die Verfügbarkeit Ihrer Copilot Extension auswählen
Für Ihre Copilot Extension können Sie eine von zwei Sichtbarkeitsebenen wählen:
- Öffentlich: Jedes Benutzer- oder Organisationskonto mit dem Link zur Installationsseite für die Erweiterung kann sie installieren.
- Privat: Nur das Benutzer- oder Organisationskonto, das die Erweiterung erstellt hat, kann sie installieren.
Wenn Sie Ihre Copilot Extension öffentlich machen, können Sie sie auf dem GitHub Marketplace listen.
Informationen zum Ändern der Sichtbarkeit deiner Copilot Extension und zum Auflisten auf dem GitHub Marketplace findest du unter Verwalten der Verfügbarkeit Ihrer Copilot-Erweiterung.
Nächste Schritte
Informationen zum Verwenden deiner Copilot Extension findest du unter Verwenden von Erweiterungen zum Integrieren externer Tools in Copilot Chat.
1. Weitere Informationen zu Github Copilot skillsets
Github Copilot skillsets enthalten den benutzerdefinierten Code für deine Copilot Extension und lassen sich mit einer GitHub App integrieren, um die eigentliche Copilot Extension zu bilden.
Im Gegensatz zu Copilot agents werden die Logik hinter der Prompterstellung, die Funktionsauswertung und die Antwortgenerierung durch Copilot skillsets verarbeitet. Dadurch sind sie für Entwickler ideal, die schnelle und effektive Integrationen mit minimalem Aufwand suchen. Weitere Informationen finden Sie unter Informationen zu Copilot-Skillsets.
2. Erstellen eines Copilot skillsets
Ein Beispiel für die Implementierung eines Skillsets findest du im Repository skillset-example in der copilot-extensions-Organisation.
Weitere Informationen zum Erstellen eines Skillsets findest du unter Erstellen von Copilot-Skillsets.
3. Bereitstellen deines Copilot skillsets
Um dein Copilot skillset für die Copilot-Plattform und GitHub verfügbar zu machen, musst du es auf einem Server bereitstellen, der über HTTP-Anforderungen erreichbar ist. Weitere Informationen findest du unter Konfigurieren deines Servers zum Hosten deiner Copilot-Erweiterung.
4. Erstellen einer GitHub App und Integrieren der App mit deinem Copilot skillset
Zum Erstellen einer Copilot Extension musst du eine GitHub App erstellen und konfigurieren und diese anschließend mit deinem Copilot skillset integrieren. Weitere Informationen findest du unter Erstellen einer GitHub-App für Ihre Copilot-Erweiterung und Konfigurieren deiner GitHub-App für deine Copilot-Erweiterung.
5. Auswählen der Verfügbarkeit deines Copilot skillsets
Für Ihre Copilot Extension können Sie eine von zwei Sichtbarkeitsebenen wählen:
- Öffentlich: Jedes Benutzer- oder Organisationskonto mit dem Link zur Installationsseite für die Erweiterung kann sie installieren.
- Privat: Nur das Benutzer- oder Organisationskonto, das die Erweiterung erstellt hat, kann sie installieren.
Wenn Sie Ihre Copilot Extension öffentlich machen, können Sie sie auf dem GitHub Marketplace listen.
Informationen zum Ändern der Sichtbarkeit deiner Copilot Extension und zum Auflisten auf dem GitHub Marketplace findest du unter Verwalten der Verfügbarkeit Ihrer Copilot-Erweiterung.
Nächste Schritte
Informationen zum Verwenden deiner Copilot Extension findest du unter Verwenden von Erweiterungen zum Integrieren externer Tools in Copilot Chat.