Les plug-ins regroupent des personnalisations pour les surfaces compatibles Copilot. Les formats de plug-in, les composants et les emplacements pris en charge varient selon la surface. Utilisez la documentation de la plateforme sur laquelle vous envisagez d’installer le plug-in.
Fichiers manifestes des plug-ins
Un plug-in est décrit par un plugin.json fichier manifeste. Agent Plugins définit un format de plug-in portable pour les surfaces compatibles. Le manifeste se trouve à la racine du répertoire du plug-in et déclare le schéma Agent Plugins. Pour Agent Plugins 1.0, utilisez https://agent-plugins.org/schemas/1.0.0/plugin.schema.json.
Copilot CLI reconnaît également le schéma 1.1.0.
Le format partagé Agent Plugins définit des emplacements standard pour certains composants. La prise en charge de ces composants peut différer par surface :
| Component | Emplacement des plug-ins de l’agent | Notes |
|---|---|---|
| Compétences | skills/ | Les appareils compatibles peuvent découvrir des skills à cet emplacement. |
| Serveurs MCP | ||
mcp.json à la racine du plug-in | Les surfaces compatibles peuvent découvrir la configuration du serveur MCP à cet emplacement. | |
| Composants propres à Surface | Un répertoire d’espace de noms tel que com.github.copilot/ | La disponibilité et les composants pris en charge dépendent de la surface. |
Un répertoire Agent Plugins 1.0 peut utiliser cette structure :
my-plugin/
├── plugin.json
├── skills/
│ └── deploy/
│ └── SKILL.md
├── mcp.json
└── com.github.copilot/
├── agents/
│ └── helper.agent.md
├── commands/
├── rules/
├── hooks/
│ └── hooks.json
└── lsp.json
Le fichier plugin.json manifeste déclare le schéma Agent Plugins. Les emplacements skills/ et racine mcp.json sont définis par les plug-ins de l’agent. Le com.github.copilot/ répertoire contient des composants spécifiques à Copilot, et non des composants Agent Plugins portables. Les composants qu’une surface charge à partir de ce répertoire varient selon la surface. Pour le Copilot CLI, consultez Référence du plug-in CLI GitHub Copilot.
Copilot CLI prend également en charge un ancien format de plug-in Copilot. Il utilise différents comportements de découverte de composants et chemins de composants configurables. Pour les champs de manifeste, la validation, les emplacements de fichiers et le comportement spécifique à l’interface CLI, consultez Référence du plug-in CLI GitHub Copilot.
Visual Studio Code documente son format de création de plug-in et son comportement pris en charge dans la référence de création des Agent Plugins. Ne supposez pas qu’un composant ou un comportement de manifeste pris en charge sur une surface est pris en charge sur une autre.
Catalogue Marketplace
Un marketplace.json catalogue fournit des métadonnées sur une place de marché et répertorie les plug-ins dans son tableau de niveau plugins supérieur. Chaque entrée de plug-in peut inclure son nom, sa description, sa version et sa source. La source identifie l’emplacement des fichiers de plug-in. Pour Copilot CLI, marketplace.json est le seul composant de la Place de marché requis. D’autres surfaces peuvent avoir des exigences supplémentaires.
Le nom de la marketplace provient de son champ name, et non du nom du dépôt. Un identificateur de plug-in combine le nom du plug-in avec le nom de la Place de marché :
PLUGIN-NAME@MARKETPLACE-NAME
Conservez les noms du marketplace et des plug-ins stables lorsque les paramètres font référence à ces derniers. La modification du nom d’un marketplace modifie les identificateurs de plug-in utilisés par ces paramètres.
Les champs de catalogue et les emplacements de fichiers pris en charge peuvent varier selon la surface. Pour connaître les champs et emplacements complets du catalogue de la place de marché de Copilot CLI, consultez Référence du plug-in CLI GitHub Copilot. Pour connaître les étapes de publication d’un catalogue dans un GitHub référentiel, consultez Création et partage d’une place de marché de plug-in sur GitHub.
Utiliser des plugins
L’ajout d’une place de marché permet de parcourir ses plug-ins. Installer un plug-in l’ajoute à une surface. L’activation d’un plug-in rend ses composants disponibles dans les sessions sur cette surface. Pour obtenir des instructions spécifiques à la surface, consultez :