Dieser Artikel soll beim Erstellen einer neuen GitHub Copilot-Erweiterung helfen. Informationen zum schnellen Erstellen und Testen einer Demo einer Copilot-Erweiterung, 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 über Copilot-Agents informieren
Copilot-Agents enthalten den benutzerdefinierten Code für deine Copilot-Erweiterung und lassen sich mit einer GitHub App integrieren, um die eigentliche Copilot-Erweiterung zu bilden. Weitere Informationen finden Sie unter Informationen über Copilot-Agents.
Damit du einen Copilot-Agent erstellen kannst, muss du wissen, 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-Erweiterungen 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 du über den Copilot Chat bei verschiedenen auf dem GitHub Marketplace gelisteten LLMs anfragen und damit interagieren kannst. 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-Erweiterungen 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
Plane und erstelle deinen Copilot-Agent mithilfe 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. Deinen Copilot-Agent bereitstellen
Wenn du deinen Copilot-Agent für die Copilot-Plattform und GitHub verfügbar machen möchtest, musst du ihn auf einem Server bereitstellen, der über HTTP-Anforderungen erreichbar ist. Weitere Informationen findest du unter Konfigurieren deines Servers zum Hosten deiner Copilot-Erweiterung.
5. Eine GitHub App erstellen und die App mit deinem Copilot-Agent integrieren
Zum Erstellen einer Copilot-Erweiterung musst du eine GitHub App erstellen und konfigurieren und diese anschließend mit deinem 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 deiner Copilot-Erweiterung auswählen
Wähle eine von zwei Sichtbarkeitsebenen für deine Copilot-Erweiterung aus:
- Ö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 du deine Copilot-Erweiterung veröffentlichst, kannst du sie im GitHub Marketplace auflisten.
Informationen zum Ändern der Sichtbarkeit deiner Copilot-Erweiterung und zum Auflisten im GitHub Marketplace findest du unter Verwalten der Verfügbarkeit Ihrer Copilot-Erweiterung.
Nächste Schritte
Informationen zum Verwenden deiner Copilot-Erweiterung findest du unter Verwenden von Erweiterungen zum Integrieren externer Tools in Copilot Chat.
1. Sich über Github Copilot-Skillsets informieren
Github Copilot-Skillsets enthalten den benutzerdefinierten Code für deine Copilot-Erweiterung und lassen sich mit einer GitHub App integrieren, um die eigentliche Copilot-Erweiterung 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. Ein Copilot-Skillset erstellen
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. Dein Copilot-Skillset bereitstellen
Wenn du dein Copilot-Skillset für die Copilot-Plattform und GitHub verfügbar machen möchtest, 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. Eine GitHub App erstellen und die App mit deinem Copilot-Skillset integrieren
Zum Erstellen einer Copilot-Erweiterung 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. Die Verfügbarkeit deines Copilot-Skillset auswählen
Wähle eine von zwei Sichtbarkeitsebenen für deine Copilot-Erweiterung aus:
- Ö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 du deine Copilot-Erweiterung veröffentlichst, kannst du sie im GitHub Marketplace auflisten.
Informationen zum Ändern der Sichtbarkeit deiner Copilot-Erweiterung und zum Auflisten im GitHub Marketplace findest du unter Verwalten der Verfügbarkeit Ihrer Copilot-Erweiterung.
Nächste Schritte
Informationen zum Verwenden deiner Copilot-Erweiterung findest du unter Verwenden von Erweiterungen zum Integrieren externer Tools in Copilot Chat.