Démarrage rapide : Créer un package d’agent déclaratif existant en tant que plug-in avec les outils de développement Work IQ

Utilisez les outils de développement Work IQ avec la source locale d’un agent déclaratif existant pour le valider, le provisionner, l’empaqueter et le partager en tant que plug-in. Ce démarrage rapide démarre à partir d’un projet source existant, et non d’un nouvel engin automatique automatique.

Cette procédure ne permet pas de créer un agent ni de reconstruire la source à partir d’un agent installé. Si vous démarrez un nouveau plug-in à la place, suivez Créer un plug-in avec les outils de développement Work IQ.

Conseil

Regardez Work IQ Dev Tools générer un plug-in Copilot à partir d’une invite et le publier dans le magasin d’agents dans la démo interactive.

Configuration requise

  • CLI GitHub Copilot avec un abonnement Copilot actif
  • Plug-in d’assistant de codage WIQD pour l’interface de ligne de commande GitHub Copilot (voir les commandes d’installation dans cette section)
  • Node.js 24.15 ou version ultérieure et npm, disponible sur votre PATH, pour l’interface de ligne de commande WIQD et le script d’installation
  • 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

Après avoir installé l’interface de ligne de commande GitHub Copilot, installez le plug-in coding-assistant WIQD :

copilot plugin install wiqd@awesome-copilot

Vous pouvez également ajouter la place de marché WIQD et installer le plugin à partir de là :

copilot plugin marketplace add microsoft/wiqd
copilot plugin install wiqd@wiqd

Installez l’interface de ligne de commande WIQD à l’aide du script d’installation.

Démarrez une nouvelle session CLI GitHub Copilot après l’installation.

Le plug-in coding-assistant fournit des instructions de création ; il n’installe pas l’interface de wiqd ligne de commande. Installez l’interface de ligne de commande séparément avant d’exécuter les commandes de validation et de cycle de vie. Confirmez l’installation de CLI avec wiqd --version et case activée ses prérequis avec wiqd doctor.

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. Les outils de développement Work IQ ne prennent pas en charge la reconstruction du 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, commencez par le démarrage rapide WIQD pour créer un plug-in et ajouter un agent déclaratif. WIQD est le point de départ pro-code recommandé pour les scénarios pris en charge.

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

Sélectionnez explicitement la validation de source hors connexion avant de provisionner ou de créer un package du plug-in. Dans l’interface de ligne de commande GitHub Copilot, demandez :

Validate the plugin source offline in the dev environment

Provisionner le plug-in

Important

Cet exemple utilise l’environnement partagé dev standard. Vérifiez la configuration du cycle de vie effectif et le fichier d’environnement sélectionné sous environmentFolderPath (par défaut env) avant AGENT_SCOPE=shared de mettre en service le partage. Un environnement nommé dev seul n’établit pas d’étendue partagée. Conservez le même environnement pour l’approvisionnement, l’empaquetage, la validation et le partage.

Demandez à GitHub Copilot de provisionner le plug-in.

Provision the plugin using the dev environment

Attendez la fin de l’approvisionnement. L’approvisionnement n’établit pas que toutes les fonctionnalités de plug-in sont disponibles dans Copilot Chat ; la prise en charge dépend du composant et de l’expérience Microsoft 365 cible.

Empaqueter le plug-in

Demandez à GitHub Copilot d’empaqueter le module.

Package the plugin using the dev environment

Important

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

Après l’empaquetage, localisez le fichier zip généré et vérifiez que le fichier existe. Dans l’interface de ligne de commande GitHub Copilot, indiquez son chemin d’accès réel et demandez :

Validate this existing plugin ZIP in package mode using the dev environment

La validation de package utilise --mode package et un fichier zip existant est fourni par l’intermédiaire --package-filede , pas une build automatique. Examiner le verdict et les conclusions rendus. Le code 0 de sortie signifie que les vérifications sélectionnées ont réussi ; les avertissements peuvent toujours être signalés. Le blocage des résultats ou des résultats incomplets ne sont pas une réussite, et la validation du package ne prouve pas le comportement d’exécution.

Les modes de validation actuels sont source, packageet marketplace. sourceest la case activée hors connexion explicite. La valeur par défaut, package, nécessite un code postal existant, charge une copie capturée vers le service de validation Microsoft 365 et peut nécessiter une authentification. marketplace ajoute des vérifications des politiques et des preuves ; Ce n’est pas l’approbation officielle du magasin. La validation ne génère pas automatiquement un ZIP, ne vous connecte pas ou ne provisionne pas le plug-in. Pour plus d’informations, consultez Validation et MVL.

Partager le plug-in

Vous pouvez désormais demander à GitHub Copilot de partager votre déploiement de plug-in, soit avec des utilisateurs spécifiques au sein de votre organisation, soit avec l’ensemble de votre organisation. Confirmez AGENT_SCOPE=shared dans l’environnement sélectionné avant de partager. L’audience de partage (--scope users ou --scope tenant) ne modifie pas l’étendue du déploiement.

Share the plugin with AmberR@contoso.com using the dev environment

Ou :

Share the plugin with my organization using the dev environment

Important

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 examiner votre plug-in et approuver ou refuser la demande.

Submit my plugin to the organization catalog for admin approval using the dev environment

Le partage accorde un accès direct ; L’envoi de catalogue est une opération distincte et n’est pas une approbation de l’administrateur ou une installation utilisateur terminée.

Supprimer le package (facultatif)

Si ce plug-in n’est qu’un plug-in de test, demandez à GitHub Copilot de le supprimer. Cette action supprime toutes les ressources cloud provisionnées.

Delete the plugin using the dev environment