Les places de marché distribuent des plug-ins pour les Copilot clients pris en charge. Ils peuvent être hébergés dans un GitHub référentiel, un autre hôte Git ou un répertoire local. Cet article explique comment publier une marketplace dans un dépôt GitHub. Pour obtenir une vue d’ensemble, consultez Plug-ins pour GitHub Copilot.
Avant de commencer
- Créez un ou plusieurs plug-ins qui fonctionnent dans les applications clientes où les utilisateurs les utiliseront. Pour des conseils sur le format GitHub Copilot CLI et la création, consultez Création d’un plug-in pour GitHub Copilot CLI.
- Pour obtenir Visual Studio Code des conseils sur la mise en forme et la création, consultez la référence de création des Agent Plugins.
- Choisissez un nom de marketplace stable en kebab-case, tel que
engineering-tools. Les identificateurs de plug-in incluent ce nom, donc le modifier change l’identifiant que les utilisateurs emploient dans les paramètres et les commandes.
Créer le dépôt de la place de marché
Créez un dépôt pour la place de marché. Vous pouvez commencer par le modèle de démarrage de la marketplace des plugins et suivre son fichier README pour installer ses dépendances de développement et définir le nom de la marketplace, ou créer les fichiers vous-même. Si vous utilisez le modèle, supprimez les plug-ins d’exemple que vous ne souhaitez pas partager.
- Ajoutez un
marketplace.jsonfichier catalogue à.github/plugin/. - Ajoutez chaque répertoire de plug-in au chemin d’accès répertorié par son champ
source. Par exemple, si la source est./plugins/frontend-design, ajoutez le répertoirefrontend-designdans le référentiel, sousplugins/. - Ajoutez une valeur stable, en kebab-case, pour la place de marché
name. - Mettez à jour
.github/CODEOWNERS, les instructions de contribution et les modèles d’issues et de pull requests pour correspondre à la façon dont vous souhaitez maintenir la marketplace. - Si vous utilisez le modèle de démarrage, suivez son fichier README pour exécuter
npm run verify. Le modèle décrit cette commande comme vérifiant le catalogue, les manifestes, les tests et la couverture d’évaluation. Conservez son.github/workflows/validate.ymlflux de travail activé pour exécuter des vérifications sans modèle sur les pull requests et les pushes. Vérifiez le fichier README et le flux de travail actuels, car les vérifications de modèle peuvent changer.
Le marketplace.json fichier est le catalogue de la Place de marché requis. Il fournit les métadonnées de la Place de marché et répertorie les plug-ins. Le champ de niveau plugins supérieur est un tableau d’entrées de plug-in avec des métadonnées telles que le nom, la description, la version et la source de chaque plug-in.
Pour voir un exemple de catalogue, consultez marketplace.json dans github/awesome-copilot.
Pour connaître les champs de catalogue pris en charge et d’autres emplacements de fichiers de la Place de marché, consultez Informations de référence sur le plug-in et le marketplace.
Vérifier et gérer la place de marché
Passez en revue les modifications apportées au plugin pour l’infrastructure d’agent partagé. Testez le comportement du plug-in avant de publier des mises à jour et conservez les évaluations avec le contexte qu’elles sont destinées à évaluer. Passez en revue les entrées de catalogue et les sources de plug-in lorsque vous mettez à jour le référentiel.
Partager Marketplace
Les personnes qui ajoutent la Place de marché ou reçoivent ses plug-ins ont besoin d’un accès en lecture au référentiel et doivent être connectées à GitHub dans leur client. Pour une place de marché privée, hébergez-la dans votre organisation et accordez l’accès à ses utilisateurs. L’appartenance à l’organisation seule ne garantit pas l’accès à un dépôt privé.
Après avoir publié le dépôt, partagez son URL avec les personnes qui doivent l’ajouter dans un client. Vous pouvez également rendre les plug-ins disponibles via les paramètres partagés :
- Pour une utilisation personnelle, ajoutez la Place de marché dans le client où vous souhaitez utiliser ses plug-ins. Pour obtenir des instructions du client, consultez Utilisation de plug-ins dans Visual Studio Code, Recherche et installation de plug-ins pour GitHub Copilot CLI ou Personnalisation de l’application GitHub Copilot.
- Pour un dépôt, déclarez les valeurs par défaut de la Place de marché et du plug-in dans
.github/copilot/settings.json. Les contributeurs peuvent remplacer les valeurs par défaut du dépôt localement dans les interfaces prises en charge. Copilot in the cloud utilise ces paramètres du dépôt et n’a pas de surcharge locale. Consultez « GitHub Copilot le répertoire de configuration du CLI ». - Pour les exigences de l’entreprise, utilisez les paramètres gérés pour rendre les marketplaces disponibles et exiger ou bloquer des plug-ins. Consultez « Gestion des marketplaces de plug-ins et des plug-ins avec des paramètres gérés par l’entreprise ».