Démarrage rapide : Créer votre premier plug-in avec les outils de développement Work IQ

L’interface en ligne de commande (CLI) des outils de développement Work IQ vous permet de packager votre agent déclaratif, votre compétence ou votre serveur MCP (Model Context Protocol) existant en tant que plug-in. L’interface de ligne de commande peut également valider le package, approvisionner le plug-in et le partager avec votre client.

Importante

L’arborescence de commandes entière wiqd plugin est alpha et susceptible d’être modifiée. Si les étapes de cette procédure pas à pas ne fonctionnent pas, confirmez les commandes actuelles, les combinaisons de composants prises en charge, les expériences cibles et les exigences de fonctionnalité dans Créer un plug-in avec les outils de développement Work IQ.

Configuration requise

  • Node.js 24 ou version ultérieure
  • PowerShell 7 ou version ultérieure (Windows uniquement)
  • Un compte Microsoft 365 avec accès à Copilot
  • Chargement d’application personnalisé activé dans votre locataire
  • Un projet source d’agent déclaratif pris en charge

Vérifiez que vous disposez d’un projet de démarrage pris en charge

Commencez à partir du dossier racine d’un projet source d’agent déclaratif local. Le dossier doit contenir au minimum :

contoso-support-agent/
|-- appPackage/
|   |-- manifest.json
|   |-- declarativeAgent.json
|   `-- <the instruction and action files referenced by the manifests>
`-- <a supported lifecycle file>

Le fichier de cycle de vie peut être m365agents.yml, m365agents.local.yml, teamsapp.ymlou teamsapp.local.yml. Le projet peut contenir d’autres dossiers et fichiers d’environnement.

Ce guide de démarrage rapide ne s’applique pas lorsque :

  • Vous n’avez qu’un agent publié ou un package installé et aucun projet source local. Work IQ Dev Tools ne documente pas de méthode prise en charge pour reconstruire le projet source à partir d’un titre déployé. Récupérez le référentiel source d’origine ou utilisez l’outil de création d’origine.
  • L’agent existe uniquement dans une expérience de création managée, telle que Agent Builder ou Copilot Studio. Utilisez la procédure de publication et de partage de cet outil.
  • Vous disposez d’un agent de moteur personnalisé. Cette route Work IQ Dev Tools prend en charge les agents déclaratifs.
  • Vous disposez uniquement d’un package .zipd’agent. Les commandes de cycle de vie nécessitent le projet source et son fichier de cycle de vie.

Si vous n’avez pas de projet existant, vous pouvez suivre les étapes de la section Didacticiel : Créer des agents déclaratifs à l’aide de Microsoft 365 Agents Toolkit et de JSON pour créer un agent de base.

Remarque

wiqd plugin importImportations prises en charge Open Plugin, Claude plugin ou Cursor plugin formats. Il n’importe pas un projet ou un package d’agent déclaratif Microsoft 365 existant. Pour plus d’informations, voir Importation / exportation (interopérabilité).

Créer votre plug-in

  1. Si vous ne l’avez pas déjà fait, installez Work IQ Dev Tools.

  2. Ouvrez votre CLI dans le répertoire dans lequel vous souhaitez créer votre plug-in et connectez-vous à l’aide de la commande suivante :

    wiqd auth login --interactive

  3. Dans votre CLI, lancez GitHub Copilot à l’aide de la copilot commande.

  4. Demandez à GitHub Copilot de créer un plug-in avec votre agent déclaratif, votre compétence ou votre serveur MCP existant. Par exemple :

    Create a plugin named My Plugin by using the agent in "..\My Agent"

Valider le projet de plug-in

Si GitHub Copilot n’a pas validé le plug-in automatiquement, demandez-lui de valider le projet avant de le provisionner ou de le mettre en package.

Validate the plugin

Provisionner le plug-in

Demandez à GitHub Copilot de provisionner le plug-in.

Provision the plugin using the dev environment

Attente de la fin de la mise en service Vous pouvez maintenant tester votre plugin dans Microsoft Copilot Chat.

Importante

Le plug-in doit être approvisionné à l’aide de l’environnement dev du projet pour activer le partage d’agent.

Empaqueter le plug-in

Demandez à GitHub Copilot d’empaqueter le module.

Package the plugin

Importante

Vous devez provisionner le plug-in avant de le créer. Si vous créez un package avant la mise en service, le package résultant n’est pas valide.

Valider le package

Demandez à GitHub Copilot de valider le plug-in empaqueté. Cette étape exécute une validation plus détaillée par rapport au package ZIP généré.

Validate the packaged zip

Partager le plug-in

Vous pouvez désormais GitHub Copilot demander de partager votre package, soit avec des utilisateurs ou des groupes spécifiques au sein de votre organization, soit avec l’ensemble de votre organization.

Share the plugin with AmberR@contoso.com

Ou :

Share the plugin with my organization

Importante

Le partage de plug-ins personnalisés dépend des paramètres de votre organisation pour autoriser ou bloquer le partage de plug-ins. Si vous rencontrez des erreurs au cours de cette étape, contactez vos administrateurs en case activée. Pour plus d’informations, consultez Paramètres de partage et de publication de l’agent.

Publiez le plug-in dans le registre des plug-ins de votre organisation

Au lieu de partager votre plug-in, vous pouvez demander à publier votre plug-in dans le registre des plug-ins de votre organisation. Les administrateurs de votre organisation peuvent ensuite examiner votre plug-in et approuver ou refuser la demande.

Publish my package to the plugin registry so all users in my tenant can use it

Supprimer le package (facultatif)

S’il ne s’agissait que d’un plug-in de test, vous pouvez demander à GitHub Copilot de supprimer l’agent. Cette action supprime toutes les ressources cloud provisionnées.

Delete the plugin

Contenu connexe

  • Last updated on