# Informations de référence sur le plug-in et le marketplace

Recherchez des termes du plug-in partagé et de la marketplace, des formats de fichiers et des liens vers une documentation spécifique à la surface.

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/NAME/SKILL.md`                                                                        | 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 :

```text
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](/fr/copilot/reference/copilot-cli-reference/cli-plugin-reference#components).

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](/fr/copilot/reference/copilot-cli-reference/cli-plugin-reference).

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](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference). 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é :

```text
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](/fr/copilot/reference/copilot-cli-reference/cli-plugin-reference#marketplacejson). 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](/fr/copilot/how-tos/copilot-on-github/customize-copilot/create-and-share-plugin-marketplaces).

## 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 :

* [Utilisation de plug-ins dans Visual Studio Code](/fr/copilot/how-tos/copilot-in-your-ide/customize-copilot/extend-copilot-with-tools-and-context/using-plugins)
* [Recherche et installation de plug-ins pour GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)
* [Personnalisation de l’application GitHub Copilot](/fr/copilot/how-tos/github-copilot-app/customize-github-copilot-app)
* [Configuration des paramètres de GitHub Copilot dans le cloud](/fr/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings)