Informationen zum Erstellen von Copilot-Erweiterungen

Copilot-Erweiterungen sind Integrationen, die die Funktionalität von Copilot Chat erweitern, sodass Entwickler externe Tools, Dienste und benutzerdefinierte Verhaltensweisen in die Chatumgebung integrieren können. Du kannst Copilot-Erweiterungen auf vielfältige Weise einsetzen, um die Funktionen von Copilot Chat zu erweitern, z. B.:

• Abfrage von Dokumentation: Eine Copilot-Erweiterung kann Copilot Chat erlauben, den Dokumentationsdienst eines Drittanbieters abzufragen, um Informationen zu einem bestimmten Thema zu finden.
• KI-gestützte Codierung: Eine Copilot-Erweiterung kann ein KI-Modell eines Drittanbieters verwenden, um Codevorschläge bereitzustellen.
• Datenabruf: Eine Copilot-Erweiterung kann Copilot Chat erlauben, den Datendienst eines Drittanbieters abzufragen, um Informationen zu einem bestimmten Thema abzurufen.
• Aktionsausführung: Eine Copilot-Erweiterung kann Copilot Chat erlauben, eine bestimmte Aktion auszuführen, z. B. das Posten in einem Message Board oder das Aktualisieren eines Nachverfolgungselements in einem externen System.

Copilot-Erweiterungen sind ein Typ von Copilot-Erweiterung, der mit Apps erstellt wird. Copilot-Erweiterungen eignen sich am besten für Entwickler, die plattformübergreifende Kompatibilität und App-Verwaltung und Unterstützung von wünschen.

Copilot-Erweiterungen können privat, öffentlich und teilbar oder öffentlich und auf dem Marketplace gelistet sein. Welche Sichtbarkeitsoption Sie auswählen, hängt von Ihrem Anwendungsfall und Ihrer Zielgruppe ab.

• Private Erweiterungen werden häufig von großen Firmen oder Unternehmen bevorzugt, die:
  • Eine stärkere Anpassung und Kontrolle über den Datenzugriff wünschen
  • Interne Dokumente und Datenbanken in großem Umfang integrieren müssen
  • Strenge Sicherheitsrichtlinien haben, die das Autorisieren von Berechtigungen für Drittanbieter erschweren
• Öffentliche Erweiterungen eignen sich für:
  • Open-Source-Projekte
  • Gemeinsame Entwicklung und Nutzung in Organisationen innerhalb eines Unternehmens
  • Freigeben des Tool und Einholen von Feedback vor der Veröffentlichung auf dem Marketplace
• Marketplace-Erweiterungen eignen sich ideal für Drittanbieter, die:
  • Ihren Dienst einem breiteren Publikum anbieten möchten
  • Ihr Tool in den Entwicklerworkflow in und der IDE integrieren möchten
  • Das -Ökosystem nutzen möchten, um das Bewusstsein für ihr Produkt zu steigern

Die Berechtigungen variieren je nach Erweiterung, abhängig von der Autorisierungsstufe, die die Erweiterung benötigt, um auf deine Abfrage zu antworten. Du kannst die erforderlichen Berechtigungen auf der Installationsseite der Erweiterung anzeigen, die sich nach dem Abrechnungsinformationsschritt und vor dem Installations- und Autorisierungsschritt befindet.

Für Entwickelnde: Die Berechtigungen für Copilot Chat müssen mindestens auf „Read-only“ festgelegt werden. Weitere Berechtigungen können das Ausführen von Schreibaktionen auf anderen Oberflächen und das Autorisieren des Lesezugriffs auf Repository- und Organisationsdaten in umfassen.

Für Entwickelnde: Zusätzlich zu den oben genannten Fällen kannst du auch lokalen Kontext vom Editor einer benutzenden Person anfordern, um weitere Antworten anzupassen. Hierzu müssen die Berechtigungen des Copilot-Editor-Kontexts auf „Schreibgeschützt“ festgelegt werden. Benutzende werden benachrichtigt, damit sie die erforderliche Autorisierung bereitstellen.

Weitere Informationen zu Berechtigungen von App findest du unter Auswählen von Berechtigungen für eine -App.

Nur Organisationsadmins können Berechtigungen für Copilot-Erweiterungen-Instanzen für den Zugriff auf Organisationsressourcen erteilen. So gewährst du Mitgliedern der Organisation Zugriff:

• Der Organisationsadmin muss die Erweiterung installieren.
• Der Organisationsadmin muss die Erweiterungsberechtigung für den Zugriff auf bestimmte Repositorys erteilen.
• Der Organisationsadmin muss den Zugriff für alle oder bestimmte Repositorys autorisieren.

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.

Du kannst zulassen, dass deine Copilot-Erweiterung Kontext vom Editor erhält (z. B. die aktuell geöffnete Datei), indem du die Zugriffsebene Read-only für die Berechtigung „Copilot Editor Context“ in deinen App-Einstellungen aktivierst. Weitere Informationen findest du in Schritt 10 unter Konfigurieren deiner App.

Die Copilot Extensibility Platform verwaltet das Messaging automatisch, wenn impliziter und expliziter Kontext nicht verfügbar oder nicht autorisiert ist. Um die Kontextweitergabe zu aktivieren, musst du Berechtigungen von Benutzern anfordern. Um die Kontextübergabe zu aktivieren, musst du:

• Deine APIs aktualisieren, um neue Verweistypen zu verarbeiten
• Berechtigungen von Benutzenden anfordern Befolge beim Anfordern von Berechtigungen die folgenden Best Practices:
  • Kommuniziere klar, welchen Kontext du benötigst und wofür du ihn benötigst.
  • Implementiere die entsprechende Fehlerbehandlung für nicht verfügbaren Kontext, die deine eigene Anwendungslogik und API aufruft.
  • Wenn kein Kontext verfügbar ist, gib möglichst ohne diese Daten einen Wert an.
  • Fordere nur die mindestens erforderlichen Berechtigungen für deine Erweiterung an.

Die Kontextübergabe berücksichtigt Inhaltsausschlüsse, die sich auf alle Dateien beziehen, die in deinen Kontextausschlusseinstellungen aufgeführt sind, einschließlich Dateien, die mit . beginnen.

Weitere Informationen zur Kontextweitergabe findest du unter Kontextweitergabe für deinen Agent.

Für das Erstellen von Copilot-Erweiterungen ist die Verwendung der -API erforderlich. Optional kann die Copilot API für zusätzliche Funktionen verwendet werden. Ausführliche Informationen zur Anforderungs- und Antwortformatierung findest du in der OpenAI-API-Dokumentation.

verfügt über ein umfassendes Toolkit für Erweiterungsentwickler mit Codebeispielen, einem CLI-Debuggingtool, Schnellstart-SDKs und einem Benutzerfeedback-Repository. Weitere Informationen finden Sie in der Organisation der Copilot-Erweiterungen auf .

Bevor du deine eigene Copilot-Erweiterung von Grund auf neu erstellst, solltest du einen Copilot-Agent erkunden und ihn dann mit einer App integrieren, um zu sehen, wie er funktioniert. stellt einige Copilot-Agents als Beispiel bereit, die du klonen und als Grundlage für deine eigene Copilot-Erweiterung verwenden kannst:

• Blackbeard: Ein einfacher Copilot-Agent, der Anforderungen beantwortet wie ein Pirat unter Verwendung der LLM-API von Copilot und spezieller Systemansagen. Er ist ein guter Ausgangspunkt zum Lernen, wie eine Copilot-Erweiterung erstellt wird. Weitere Informationen findest du unter Blackbeard Copilot-Erweiterung.

• Models: Ein komplexerer Copilot-Agent, mit dem du über den Copilot Chat bei verschiedenen auf dem Marketplace gelisteten LLMs anfragen und damit interagieren kannst. Weitere Informationen findest du unter Models Copilot-Erweiterung.

  Hinweis

  Models befinden sich in der public preview und können noch geändert werden. Tragen Sie sich in die Warteliste ein, um Zugriff zu beantragen.

• Funktionsaufrufe: Ein In Go geschriebener Beispiel-Agent, der Funktionsaufrufe und Bestätigungsdialoge veranschaulicht. Weitere Informationen finden Sie unter Erweiterung für Funktionsaufrufe.

• RAG-Erweiterung: Ein In Go geschriebener Beispiel-Agent, der eine einfache Implementierung der erweiterten Abrufgenerierung veranschaulicht. Weitere Informationen finden Sie unter RAG-Erweiterung.

• Preview SDK: Ein SDK, das den Prozess der Erstellung von Copilot-Erweiterungen durch Überprüfen der Anforderungen, Formatieren der Antworten und API-Interaktionen vereinfacht. Es ermöglicht den Entwicklern, sich auf die Kernfunktionen ihrer Erweiterung statt auf Bausteine zu konzentrieren, weil es die Integration von Tools, APIs und Datenquellen in Copilot Chat optimiert. Weitere Informationen finden Sie unter Preview SDK.

Du kannst eine Copilot-Erweiterung erstellen, die exklusiv und nativ für Visual Studio Code ist, namens Copilot-fähige Visual Studio Code-Erweiterungen. Diese Option eignet sich am besten für Entwickler*innen, die Erweiterungen erstellen möchten, die VS Code-spezifische APIs und Funktionen verwenden oder vorhandene VS Code-Erweiterungen ausbauen möchten.

Auch bekannt als VS Code Chat-Erweiterungen, funktionieren Copilot-fähige Visual Studio Code-Erweiterungen ähnlich wie Copilot-Erweiterungen durch die Erweiterung der Funktionen von Copilot Chat, mit einigen wichtigen Unterschieden:

• VS Code Chat-Erweiterungen können nur in VS Code verwendet werden.
• VS Code Chat-Erweiterungen haben mehr Zugriff auf Features und APIs von VS Code, wodurch editorspezifische Interaktionen wie der Zugriff auf lokale Arbeitsbereichsdaten, das Bearbeiten der Schnittstelle von Visual Studio Code und Lese-/Schreibzugriff auf lokale Dateien ermöglicht werden.
• VS Code Chat-Erweiterungen werden im VS Code Marketplace veröffentlicht, nicht im Marketplace.
• VS Code Chat-Erweiterungen sind lokal auf dem Computer der Benutzer*innen gespeichert und können nicht durch die Richtlinien einer Organisation oder eines Unternehmens kontrolliert werden.

Weitere Informationen zu Copilot-fähige Visual Studio Code-Erweiterungen findest du unter Chat extensions in der Dokumentation zu Visual Studio Code.

• Glossar der Copilot-Erweiterungen