# Plug-ins pour GitHub Copilot

Les personnalisations associées au package de plug-ins vous permettent de les installer ensemble sur les plateformes prises en charge Copilot .

Les plug-ins regroupent les personnalisations associées afin que vous puissiez les installer et les gérer ensemble au lieu de configurer chacune séparément. Par exemple, un plug-in de test peut combiner une compétence pour exécuter des tests, un agent pour la révision du code et un serveur MCP pour un service de rapports de test.

## Où vous pouvez utiliser des plug-ins

Les plug-ins sont disponibles sur ces Copilot surfaces :

* Visual Studio Code. Parcourez et installez les plug-ins à partir de **Personnaliser** dans le panneau latéral de conversation ou la fenêtre Agents. Pour plus d’informations sur le format du plugin VS Code, consultez la [référence de création des Plugins Agent](https://code.visualstudio.com/docs/agents/reference/agent-plugin-reference).
* GitHub Copilot CLI. Parcourez et installez des plug-ins à partir d’un marketplace enregistré.
* Le GitHub Copilot app. Parcourez et installez les plug-ins à partir de **Personnalisation**.
* Copilot in the cloud. Configurez les plug-ins via les paramètres du référentiel.

Un plug-in peut contenir des composants qui fonctionnent uniquement dans un environnement particulier. Vérifiez que le plug-in prend en charge la surface que vous utilisez. Par exemple, la configuration du serveur LSP décrite dans cette catégorie concerne Copilot CLI. Pour plus d’informations, consultez « [Informations de référence sur le plug-in et le marketplace](/fr/copilot/reference/plugin-and-marketplace-reference) ».

## Que contiennent les plug-ins?

Un plug-in peut empaqueter certains ou tous ces composants. Les composants disponibles et leurs emplacements dépendent du format du plug-in et de l’aire :

* **Agents personnalisés** — Assistants IA spécialisés (`*.agent.md` fichiers dans `agents/`)
* **Compétences** : instructions, scripts et ressources spécifiques aux tâches (sous-répertoires de compétences dans `skills/`, contenant un fichier `SKILL.md`)
* **Hooks** — gestionnaires d’événements qui répondent aux actions de l’agent (un fichier `hooks.json` à la racine du plug-in, ou dans `hooks/`)
* **Extensions** : code spécifique à la surface qui ajoute des fonctionnalités telles que des outils et des commandes slash
* **Configurations de serveur MCP** — intégrations du Model Context Protocol (racine `mcp.json` dans Agent Plugins 1.0)
* **Configurations du serveur LSP** : intégrations du protocole Language Server sur les plateformes prises en charge

## Formats de plug-in

Agent Plugins est un format permettant de partager des manifestes de plug-in, des compétences et des configurations de serveur MCP sur des surfaces compatibles. Les plug-ins Agent Plugins 1.0 déclarent le schéma canonique dans `plugin.json`; ses emplacements de schéma et de composant ne sont pas pris en charge par chaque surface de la même façon.
Copilot CLI prend également en charge un ancien format de plug-in Copilot. Dans l’interface CLI, un manifeste sans le schéma Agent Plugins utilise ce format hérité.

Choisissez les plug-ins de l’agent lorsque vous souhaitez partager des compétences et des serveurs MCP sur les plateformes compatibles. Utilisez le format CLI hérité lorsque vous avez besoin de chemins de composant configurables ou assurez la maintenance d’un plug-in spécifique à Copilot existant.

Pour créer un nouveau plug-in, utilisez Agent Plugins 1.0, sauf si vous avez besoin de chemins d’accès des composants configurables. Utilisez le format hérité principalement pour les plug-ins hérités existants.

## Comment les plug-ins sont structurés

Un plug-in est un répertoire avec une structure spécifique et un `plugin.json` fichier manifeste. Agent Plugins 1.0 exige que le fichier manifeste se trouve à la racine du plug-in. Les plugins hérités prennent en charge des emplacements supplémentaires pour les manifestes. Le manifeste donne au plug-in un nom et des métadonnées. Selon le format, il peut également pointer vers des composants. Outre le manifeste, le répertoire peut contenir des agents, des compétences, des hooks, des configurations de serveur MCP et des configurations de serveur LSP.

### Structure des plug-ins d’agent 1.0

Agent Plugins 1.0 stocke les compétences et les serveurs MCP dans des emplacements standard afin que les clients compatibles puissent les découvrir. D’autres composants, notamment les agents, les hooks, les commandes et les serveurs LSP, sont spécifiques au client.
Copilot lit ces composants à partir du `com.github.copilot` répertoire. D’autres clients ignorent ce répertoire, de sorte que le même module d’extension peut combiner des compétences partagées et des serveurs MCP avec des composants spécifiques à Copilot.

Un répertoire Agent Plugins 1.0 peut ressembler à ceci :

```text
my-plugin/
├── plugin.json               # Required manifest
├── skills/                   # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── mcp.json                  # MCP server config (optional)
└── com.github.copilot/       # Copilot components (optional)
    ├── agents/
    │   └── helper.agent.md
    ├── commands/
    ├── rules/
    ├── hooks/
    │   └── hooks.json
    └── lsp.json
```

Le manifeste doit inclure les plug-ins de l’agent 1.0 `$schema`. Pour connaître les champs de manifeste de niveau supérieur pris en charge, les exigences de nom et les emplacements des composants, consultez [les champs de manifeste Agent Plugins 1.0](/fr/copilot/reference/copilot-cli-reference/cli-plugin-reference#agent-plugins-10-manifest-fields).

### Ancienne structure de plugin

Un ancien répertoire de plugin Copilot peut ressembler à ceci :

```text
my-plugin/
├── plugin.json           # Required manifest
├── agents/               # Custom agents (optional)
│   └── helper.agent.md
├── skills/               # Skills (optional)
│   └── deploy/
│       └── SKILL.md
├── hooks.json            # Hook configuration (optional)
├── .mcp.json             # MCP server config (optional)
└── lsp.json              # LSP server config (optional)
```

Pour obtenir l’ensemble complet de champs que vous pouvez inclure dans le manifeste, consultez [Référence du plug-in CLI GitHub Copilot](/fr/copilot/reference/copilot-cli-reference/cli-plugin-reference). Pour obtenir des instructions pas à pas sur la création d’un plug-in, consultez [Création d’un plug-in pour GitHub Copilot CLI](/fr/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating).

## Pourquoi utiliser des plug-ins ?

Les plug-ins offrent les avantages suivants :

* Réutilisation entre les projets
* Configuration partagée Copilot entre dépôts
* Partagez une expertise de domaine (par exemple, en fournissant les compétences d’un expert Rails ou d’un expert Kubernetes)
* Encapsuler des configurations de serveur MCP complexes

## Où proviennent les plug-ins

La place de marché intégrée dans Visual Studio Code, Copilot CLI et le GitHub Copilot app est [awesome-copilot](https://github.com/github/awesome-copilot?utm_source=customization-plugin-doc-awesome\&utm_medium=docs\&utm_campaign=universe-2026). D’autres places de marché doivent être ajoutées avant la disponibilité de leurs plug-ins.

L’ajout d’une place de marché permet de parcourir ses plug-ins. Il n’installe pas ou ne les active pas. L’identificateur d’un plug-in combine le nom du plug-in avec le nom de la Place de marché sous la forme `PLUGIN-NAME@MARKETPLACE-NAME`. Le nom de la Place de marché provient du `name` champ dans son `marketplace.json` fichier, et non du nom du référentiel.

## Ce qui détermine si un plug-in est activé

Les plug-ins peuvent être disponibles, installés ou activés. L’ajout d’une place de marché permet de parcourir ses plug-ins. L’installation d’un plug-in l’ajoute à une surface et son activation rend ses composants disponibles dans les sessions de cette surface. La configuration partagée peut définir une valeur par défaut ou imposer si un plug-in est activé :

| Source de configuration                  | Effect                                                                                                                                             | Un membre peut-il désactiver le plug-in ?                    |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| Paramètres gérés par l’entreprise        | Exiger ou bloquer un plug-in sur les surfaces prises en charge.                                                                                    | No. La politique gérée l’emporte toujours.                   |
| Paramètres gérés par l’équipe Enterprise | Ajoutez les plug-ins requis via `enabledPlugins` dans les fichiers d’équipe d’entreprise, superposés à la configuration de référence d’entreprise. | No. Ces entrées sont gérées par une stratégie.               |
| Valeurs par défaut du référentiel        | Activez un plug-in pour tous ceux qui travaillent dans un dépôt.                                                                                   | Oui, si l’interface prend en charge une substitution locale. |

Les valeurs par défaut du référentiel ne rendent pas obligatoire un plug-in. Ils ne peuvent pas activer un plug-in qu’une règle gérée bloque ou utiliser une place de marché qu’une règle interdit. Les paramètres managés ne peuvent pas activer un plug-in facultatif par défaut. Ils nécessitent ou bloquent uniquement des plug-ins.

Les fichiers de l’équipe Enterprise ajoutent des entrées managées `enabledPlugins` à la base de référence d’entreprise. Les membres ne peuvent pas désactiver les plug-ins requis. Consultez « [Remplacement des paramètres gérés par l’entreprise pour les équipes d’entreprise](/fr/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/override-settings-for-teams) ».

Les valeurs par défaut du dépôt utilisent `.github/copilot/settings.json`. Pour connaître les remplacements locaux spécifiques à la configuration et à la surface, consultez [GitHub Copilot le répertoire de configuration du CLI](/fr/copilot/reference/copilot-cli-reference/cli-config-dir-reference#repository-settings-githubcopilotsettingsjson).

Les administrateurs d’entreprise peuvent spécifier des places de marché et des plug-ins supplémentaires qui sont requis ou bloqués. Consultez « [Gestion des marketplaces de plug-ins et des plug-ins avec des paramètres gérés par l’entreprise](/fr/copilot/how-tos/administer-copilot/manage-for-enterprise/use-managed-settings/manage-plugin-marketplaces-and-plugins) ».

## Fonctionnement des places de marché des plug-ins

Une place de marché de plug-ins est un registre de plug-ins à partir duquel vous pouvez parcourir et installer. Une place de marché peut être hébergée dans un référentiel sur GitHub.com, un autre hôte Git ou un répertoire local. Étant donné que les plug-ins d’une Place de marché sont versionnés, les marketplaces facilitent la découverte, l’installation et la mise à jour des plug-ins.

Une place de marché est définie par un fichier `marketplace.json`, qui fournit des métadonnées sur la Place de marché et répertorie ses plug-ins.

Pour obtenir des instructions spécifiques à la plateforme pour utiliser des plug-ins ou publier un Marketplace dans un référentiel GitHub, voir [Pour en savoir plus](#further-reading).

## Plug-ins par rapport à la configuration manuelle

Toutes les fonctionnalités que vous pouvez ajouter avec un plug-in peuvent également être ajoutées en configurant Copilot manuellement, par exemple en ajoutant des profils d’agent personnalisés ou des serveurs MCP. Toutefois, les plug-ins offrent plusieurs avantages par rapport à la configuration manuelle :

| Feature              | Configuration manuelle dans un référentiel | Plug-in                                            |
| -------------------- | ------------------------------------------ | -------------------------------------------------- |
| Scope                | Référentiel unique                         | Tout projet                                        |
| Partage              | Copier/coller manuellement                 | Commande d’installation ou entrée `enabledPlugins` |
| Gestion des versions | Historique Git                             | Versions du Marketplace                            |
| Discovery            | Recherche de référentiels                  | Navigation sur la Place de marché                  |

## Pour en savoir plus

* [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#adding-plugins)
* [Configuration des paramètres de GitHub Copilot dans le cloud](/fr/copilot/how-tos/use-copilot-agents/cloud-agent/configuring-agent-settings#configuring-plugins-for-github-copilot-cloud-agent)
* [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)