Plugins bündeln Anpassungen für kompatible Copilot Oberflächen. Plug-In-Formate, Komponenten und unterstützte Speicherorte variieren je nach Plattform. Verwenden Sie die Dokumentation für die Plattform, auf der Sie das Plug-in installieren möchten.
Plug-In-Manifeste
Ein Plug-In wird durch ein plugin.json Manifest beschrieben. Agent Plugins definieren ein portables Plug-In-Format für kompatible Oberflächen. Das Manifest befindet sich im Stammverzeichnis des Plug-In-Verzeichnisses und deklariert das Agent-Plug-In-Schema. Für Agent Plugins 1.0 verwenden Sie https://agent-plugins.org/schemas/1.0.0/plugin.schema.json.
Copilot CLI erkennt auch das 1.1.0-Schema.
Das Shared Agent Plugins-Format definiert Standardspeicherorte für einige Komponenten. Die Unterstützung für diese Komponenten kann sich je nach Oberfläche unterscheiden:
| Component | Speicherort der Agent-Plug-Ins | Notes |
|---|---|---|
| Qualifikationen | skills/ | Kompatible Geräte können an dieser Stelle Skills entdecken. |
| MCP-Server | ||
mcp.json im Plugin-Stammverzeichnis | Kompatible Oberflächen können die MCP-Serverkonfiguration an diesem Speicherort ermitteln. | |
| Surface-spezifische Komponenten | Ein Namespace-Verzeichnis wie com.github.copilot/ | Verfügbarkeit und unterstützte Komponenten hängen von der Plattform ab. |
Ein Agent Plugins 1.0-Verzeichnis kann diese Struktur verwenden:
my-plugin/
├── plugin.json
├── skills/
│ └── deploy/
│ └── SKILL.md
├── mcp.json
└── com.github.copilot/
├── agents/
│ └── helper.agent.md
├── commands/
├── rules/
├── hooks/
│ └── hooks.json
└── lsp.json
Das plugin.json Manifest deklariert das Agent-Plug-In-Schema. Die skills/ Speicherorte und Root-mcp.json-Speicherorte werden durch Agent-Plug-Ins definiert. Das com.github.copilot/ Verzeichnis enthält Copilot spezifische Komponenten, keine portablen Agent-Plug-In-Komponenten. Welche Komponenten eine Oberfläche aus diesem Verzeichnis lädt, hängt von dieser Oberfläche ab. Für Copilot CLI, siehe GitHub Copilot CLI-Plug-In-Referenz.
Copilot CLI unterstützt auch ein älteres Copilot Plug-In-Format. Es verwendet ein anderes Verhalten bei der Komponentenermittlung und konfigurierbare Komponentenpfade. Informationen zu Manifestfeldern, Überprüfungen, Dateispeicherorten und CLI-spezifischem Verhalten finden Sie unter GitHub Copilot CLI-Plug-In-Referenz.
Visual Studio Code dokumentiert das Erstellungsformat des Plug-Ins und das unterstützte Verhalten in der Referenz zur Erstellung von Agent-Plug-Ins. Gehen Sie nicht davon aus, dass eine Komponente oder ein Manifestverhalten, das auf einer Oberfläche unterstützt wird, auf einer anderen Oberfläche unterstützt wird.
Marketplace-Katalog
Ein marketplace.json Katalog stellt Metadaten zu einem Marketplace bereit und listet Plug-Ins in seinem Array auf oberster Ebene plugins auf. Jeder Plug-In-Eintrag kann den Namen, die Beschreibung, die Version und die Quelle enthalten. Die Quelle gibt an, wo sich die Plug-In-Dateien befinden. Für Copilot CLI, marketplace.json ist die einzige erforderliche Marketplace-Komponente. Andere Oberflächen können zusätzliche Anforderungen haben.
Der Marketplace-Name stammt aus seinem name Feld, nicht aus dem Repositorynamen. Ein Plug-In-Bezeichner kombiniert den Plugin-Namen mit dem Marketplace-Namen:
PLUGIN-NAME@MARKETPLACE-NAME
Halten Sie Marketplace- und Plug-In-Namen stabil, wenn Einstellungen darauf verweisen. Wenn Sie einen Marketplace-Namen ändern, werden die Plug-in-IDs geändert, die für diese Einstellungen verwendet werden.
Katalogfelder und unterstützte Dateispeicherorte können je nach Oberfläche variieren. Die vollständigen Marketplace-Katalogfelder und -standorte von Copilot CLI finden Sie unter GitHub Copilot CLI-Plug-In-Referenz. Schritte zum Veröffentlichen eines Katalogs in einem GitHub Repository finden Sie unter Einen Plug-in-Marktplatz auf GitHub erstellen und teilen.
Plug-Ins verwenden
Durch das Hinzufügen eines Marketplace werden die Plug-Ins zum Durchsuchen verfügbar. Durch die Installation eines Plug-Ins wird es zu einem Arbeitsbereich hinzugefügt. Durch aktivieren eines Plug-Ins werden seine Komponenten in Sitzungen auf dieser Oberfläche verfügbar. Informationen zu oberflächenspezifischen Anweisungen finden Sie unter: