Tester et valider votre plug-in pour Microsoft 365 Copilot

Validez et testez l’artefact versionné exact que vous avez créé dans Créez un package de votre plug-in. Il s’agit de la troisième étape de Package et test : valider le package, l’installer et confirmer son accès, son comportement et les expériences Microsoft 365 prises en charge.

Les composants et services externes référencés par le plugin doivent déjà fonctionner individuellement et ensemble. Cet article teste le plug-in packagé ; Il ne remplace pas les tests ou la certification au niveau des composants.

Importante

Utilisez l’artefact exact que vous avez l’intention de publier. Si votre itinéraire d’empaquetage ne prend pas en charge les composants prévus et les expériences cibles, revenez à Créer un package de votre plug-in et choisissez un itinéraire pris en charge.

Avant de commencer

Préparer :

  • Package de plug-in versionné exact que vous avez l’intention de publier.
  • La procédure d’installation ou de chargement latéral pour votre itinéraire d’emballage.
  • Un environnement de test et des identités avec l’accès requis.
  • Scénarios représentatifs et résultats attendus pour chaque expérience Microsoft 365 cible.

Valider le package

Utilisez la procédure de validation de votre itinéraire d’emballage.

Itinéraire d’empaquetage Procédure de validation
Outils de développement Work IQ Après avoir créé le package, utilisez-la wiqd agent validate --mode deep pour valider le package d’application résolu. Dans les workflows automatisés, inspectez le résultat JSON data.valid au lieu de vous fier uniquement au code de sortie du processus. Voir Validation et couche Microsoft Validation.
Package de plug-in Alpha WIQD Après avoir wiqd plugin package créé l’artefact, exécutez wiqd plugin validate --mode deep. Cette validation du package d’abord vérifie le manifeste d’application de niveau supérieur, les compétences et les connecteurs MCP distants que la validation statique du plug-in ne couvre pas. Dans les workflows automatisés, inspectez le résultat de la validation structurée plutôt que de vous fier uniquement au code de sortie du processus. Consultez Créer un plug-in avec les outils de développement Work IQ.
Microsoft 365 Agents Toolkit Utilisez Valider un package d’application à l’aide de règles de validation ou exécutez .atk validate --app-package-file-path <path> Consultez Valider votre application.
Copilot Studio Terminez la publication et configurez le workflow et résolvez les erreurs avant de télécharger le .zip.
Un autre flux de travail spécifique au plug-in Suivez la procédure de validation documentée pour ce type de package.

Vérifiez que l’artefact généré répond aux exigences définies pour son type de package, utilise l’identité, la version et l’environnement prévus et ne contient aucune information d’identification, aucun secret, aucune donnée de test, aucun journal ou fichier non lié.

Corrigez les erreurs de package, créez une nouvelle version de package et répétez la validation avant de l’installer.

Installer ou charger une version test du package

  1. Utilisez la procédure d’installation ou de chargement latéral pour votre itinéraire d’emballage.
  2. Installez l’artefact exact qui a réussi la validation du package.
  3. Enregistrez la version de l’artefact, l’environnement de test, l’identité et le résultat de l’installation.
  4. Vérifiez que le plug-in installé et les composants attendus sont reconnus.

En cas d’échec de l’installation, corrigez le package, créez une nouvelle version, réinstallez-la et effectuez un nouveau test.

Tester le plug-in empaqueté

  1. Exécutez les scénarios utilisateur complets via le plug-in installé.
  2. Vérifiez que les composants attendus se chargent et que les composants appropriés sont sélectionnés.
  3. Testez les scénarios de réussite, d’échec et de récupération requis par les composants et les expériences Microsoft 365 prises en charge par votre plug-in.
  4. Enregistrez le résultat attendu et réel pour chaque scénario.

Si un composant ne respecte pas ses propres exigences, revenez à ses instructions de build ou de validation de composant. Ne redéfinissez pas un échec de composant comme un succès de plugin-package.

Tester l’authentification et l’accès

Tester :

  • Connexion, consentement, renouvellement de jeton et reconnexion.
  • Accès refusé, autorisations insuffisantes, connexions manquantes et services indisponibles.
  • Données et actions en dehors des autorisations de l’utilisateur.

Enregistrez les identités, les autorisations, l’authentification, le consentement, les connexions, les points de terminaison et les versions de service testées.

Tester les expériences prises en charge

Installez et testez le package dans chaque expérience Microsoft 365 que vous avez l’intention de prendre en charge. Ne déduisez pas le soutien d’une expérience des résultats d’une autre.

Enregistrez les expériences, les environnements, les limitations, les combinaisons non prises en charge et les risques acceptés pour la mise en production.

Évaluer la qualité de l’agent si nécessaire

Si le package inclut un agent et que l’évaluation de la qualité de l’agent fait partie des critères de publication, évaluez la version déployée exacte et ajoutez les résultats à l’enregistrement de préparation à la publication. Commencez par la vue d’ensemble de l’évaluation des agents.

L’évaluation des agents mesure la qualité des réponses et les régressions. Il ne remplace pas la validation de package, les tests d’installation, les tests d’accès ou les tests dans chaque expérience Microsoft prise en charge.

Déterminer la disponibilité de la mise en production

Attribuez un résultat :

  • Prêt : le package de plug-in exact a réussi toutes les vérifications requises et n’a pas de bloqueur de mise en production non résolu.
  • Bloqué : un échec de package, de référence, d’accès, de compatibilité ou de runtime empêche la publication.
  • Prêt avec les limites : les vérifications requises ont réussi et les limitations restantes sont documentées, acceptées et adaptées à la divulgation dans le processus de publication.

Pour chaque échec de blocage, enregistrez le propriétaire et la résolution requise. Résolvez le problème, reconditionnez le plug-in, réinstallez le nouvel artefact et répétez les tests affectés.

Le plug-in n’est prêt à être publié que lorsque cet artefact exact a réussi les vérifications de package, d’installation, d’accès, de scénario, d’expérience et de qualité d’agent applicables.

Continuez à publier et à distribuer le plug-in.

Étapes suivantes