Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Créez le package de plug-in versionné exact que vous avez l’intention de tester et de publier. Cette étape intervient après que les composants du plug-in ont travaillé ensemble dans l’environnement de développement ou de test prévu.
Important
Un .zip fichier n’est pas automatiquement un package de plug-in pris en charge. Utilisez une voie d’empaquetage uniquement lorsqu’elle prend en charge les composants du plug-in et les expériences Microsoft 365 que vous avez l’intention de publier.
Cet article décrit le package d’application Microsoft 365 utilisé par le flux de travail du plug-in Copilot Cowork documenté. Certains outils créent le package pour vous ; D’autres workflows vous permettent de l’assembler manuellement. Utilisez les instructions du produit sélectionné pour les composants pris en charge, la version du manifeste et l’itinéraire de publication. Un format de package partagé ne garantit pas que tous les produits prennent en charge les mêmes fonctionnalités.
Les serveurs MCP distants, les API et les autres services connectés s’exécutent séparément. Le package inclut les déclarations prises en charge ou les références nécessaires pour s’y connecter, et non les services en cours d’exécution.
Avant de commencer
Effectuez les tests d’intégration. Confirmez que :
- Vous avez construit et testé les composants individuellement et ensemble.
- Vous avez configuré les dépendances, l’authentification, les autorisations, les connexions, les points de terminaison et les services externes.
- Vous savez quelles expériences Microsoft 365 le plug-in doit prendre en charge.
- Vous avez enregistré les versions des composants, les limitations connues et les problèmes non résolus.
N’utilisez pas d’empaquetage pour résoudre un composant ou une intégration inachevée. Retournez à Générer ou réutilisez lorsqu’un composant requis ne fonctionne pas.
Comprendre le package de l’application Microsoft 365
Le package est un fichier ZIP avec manifest.json les icônes référencées à la racine. Le schéma du manifeste de l’application Microsoft 365 définit ses déclarations d’identité, de métadonnées et de capacité.
| Contenu du package | Objectif |
|---|---|
manifest.json |
Identifie l’application, la version, le développeur, les noms, les descriptions, les icônes et les fonctionnalités prises en charge. |
| icônes ; | Fichiers image de couleur et de contour référencés par le manifeste de l’application. Les documents color.png de flux de travail Cowork et outline.png. |
| Compétences de l’agent | Le cas échéant, les dossiers de compétences contiennent SKILL.md et prennent en charge les fichiers associés. Le manifeste de l’application fait référence aux dossiers via agentSkills. |
| Configuration du connecteur distant | Lorsqu’elles sont incluses, agentConnectors les entrées dans le manifeste de l’application identifient les points de terminaison MCP distants et la configuration d’autorisation applicable. Le serveur lui-même n’est pas emballé. |
| Fichiers de composants référencés | Incluez les fichiers requis par les composants sélectionnés, tels qu’un fichier de description d’outil lorsque la configuration du connecteur y fait référence, ou des définitions d’agent dans un package d’agent pris en charge. |
Par exemple, la documentation de Cowork montre un package avec cette disposition :
manifest.json
color.png
outline.png
skills/
contract-analysis/
SKILL.md
references/
clause-taxonomy.md
tools/
contoso-legal-tools.json
Les dossiers de compétences ne sont présents que lorsque le plugin inclut des compétences. Le fichier de description de l’outil n’est nécessaire que lorsqu’il est référencé par la configuration du connecteur. Suivez les plug-ins de génération pour Copilot Cowork pour le fichier actuel, la version du schéma, l’icône et les exigences de compétence plutôt que de traiter l’exemple comme un modèle pour chaque produit.
Remarque
Le schéma de manifeste du plug-in 2.4 décrit un composant d’action d’API ou MCP pour un agent déclaratif, et non pour le package d’application Microsoft 365 externe. Ces actions ne sont disponibles que pour l’agent contenant. Utilisez le schéma du manifeste de l’application pour le package externe.
Choisir un chemin d’empaquetage pris en charge
| Itinéraire du package de plug-in | Création du package | Result (Résultat) |
|---|---|---|
| Un projet de plug-in Work IQ Dev Tools (itinéraire pro-code recommandé pour les scénarios pris en charge) | Suivez les étapes de validation à la source et d’approvisionnement documentées pour l’environnement sélectionné, puis exécutez .wiqd plugin package Consultez Créer un plug-in avec les outils de développement Work IQ. |
Package d’application avec version à valider avant partage ou publication. |
| Package de plug-in créé avec Microsoft 365 Agents Toolkit, lorsque le workflow sélectionné prend en charge les composants du plug-in et cible les expériences | Sélectionnez Compresser le package d’application Teams ou utilisez l’action de cycle de teamsApp/zipAppPackage vie. Consultez Personnaliser le manifeste d’une application dans Agents Toolkit. |
Package de plug-in produit par le workflow pris en charge. |
| Un package de plug-in Cowork assemblé manuellement | Suivez les instructions relatives au manifeste, à la compétence, au connecteur, à l’icône et à la disposition ZIP dans Créer des plug-ins pour Copilot Cowork. | Package d’application Microsoft 365 pour l’itinéraire Cowork documenté. |
Si aucune voie d’empaquetage ne prend en charge les composants de votre plug-in et ciblez les expériences, arrêtez. Choisissez une méthode prise en charge ou révisez le plug-in. Ne combinez pas ou ne renommez pas les artefacts pour créer un package non pris en charge.
Pour les compétences utilisées directement dans Copilot Chat, empaquetez les compétences au niveau du plug-in via la propriété du manifeste de agentSkills l’application. Cela diffère de la propriété du manifeste de l’agent agent_skills déclaratif. Un ZIP autonome SKILL.md ou de compétence accepté par le Chat n’est pas un package d’application de plug-in complet. Voir Créer un package de compétence dans un module.
Pour automatiser les vérifications de code source WIQD, l’empaquetage candidat et la validation du package en premier, consultez Configurer le plug-in CI/CD avec les outils de développement Work IQ.
Remarque
La validation de code source WIQD n’est pas une validation complète du package construit. Validez le ZIP exact après l’empaquetage, en utilisant la procédure de validation de package actuelle dans Test et validez votre plug-in.
Identifier le package et ses dépendances
Choisissez la voie de publication et de distribution prévue avant d’assembler l’artefact de mise en production. Pour chaque itinéraire, identifiez :
- Identité : L’ID d’application, la version du package et les identificateurs du composant.
- Métadonnées : Noms, descriptions, informations sur le développeur, icônes et liens de confidentialité et de conditions applicables.
- Authentification : Le modèle d’identité, la configuration d’autorisation prise en charge, les besoins en matière d’autorisation et de consentement, et les références d’informations d’identification.
- Connexions : Les points de terminaison, les références de connexion et la configuration spécifique à l’environnement.
- Dépendances externes : Services distants, sources de données, propriétaires et configuration nécessaires en dehors du package.
Placer uniquement les déclarations et les références prises en charge par le schéma dans le package. Conservez les détails opérationnels dans l’enregistrement de préparation à la publication et n’incluez pas d’informations d’identification ou de secrets.
| Voie de distribution | Éléments à confirmer pour ce package |
|---|---|
| Partage direct pour le test | L’audience sélectionnée, l’environnement de test, l’identité et les métadonnées du package, ainsi que l’authentification, les connexions et les services externes dont ces testeurs ont besoin. |
| Distribution de l’organisation | L’identité et les métadonnées du package pour la révision administrative, ainsi que l’authentification, la connexion, l’autorisation et la configuration des services externes nécessaires dans l’organisation. |
| Distribution publique | L’identité et les métadonnées du package pour la voie d’envoi choisie, ainsi que l’authentification, les connexions et les dépendances externes que les organisations clientes et les utilisateurs doivent configurer. |
Le partage ou la publication du package ne termine pas l’installation, l’affectation, le consentement ou la configuration de la connexion. Suivre les exigences actuelles de l’itinéraire choisi ; Cet article ne définit pas un contrat de soumission.
Création du package
- Ouvrez la procédure d’empaquetage pour l’itinéraire de plug-in sélectionné.
- Sélectionnez l’environnement prévu et les versions exactes des composants que vous avez testés.
- Exécutez la commande documentée, l’action d’interface utilisateur ou le flux de travail automatisé.
- Enregistrez le nom de l’artefact, l’emplacement, la version, l’environnement et la version de l’outil.
Vérifiez l’artefact généré
Vérifiez que :
- L’identité du plugin et la version du package sont correctes.
- Le package contient les manifestes, les métadonnées, la configuration et les ressources attendus.
- Les déclarations de composants, les fichiers, les identificateurs, les points de terminaison et les références de service correspondent aux versions que vous avez testées.
- Le package utilise la configuration d’environnement prévue.
- Les exigences d’authentification, d’autorisation, de consentement et de connexion sont déclarées sans informations d’identification, jetons ou secrets.
- Le package ne contient pas de fichiers temporaires, de journaux, de données de test ou d’artefacts non liés.
Préparation à la publication d’enregistrements
Testez et validez un enregistrement de préparation à la publication et terminez-le avant la publication. Enregistrement :
- Identité du package ou de l’artefact et version exacte.
- Composants, services distants et références externes.
- Outil de mise en package et méthode de publication prévue.
- Expériences et environnements Microsoft 365 testés.
- Exigences en matière d’authentification, d’autorisation, de consentement et de connexion.
- Preuve de validation et résultat.
- Limitations connues, combinaisons non prises en charge et risques acceptés.
- Propriétaire de la version et date de validation.