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.
Testez l’artefact versionné exact produit par Créez le package de plug-in. Dans le test du package &, connectez la preuve du composant à ce code ZIP, installez-la via une route prise en charge et vérifiez la version livrée, l’accès et le comportement d’exécution réel dans chaque expérience Microsoft revendiquée.
Terminez par cette preuve : « J’ai testé ces composants, empaqueté ces références exactes, installé cette version exacte, exécuté ces scénarios et conservé ces résultats. » Une case activée du schéma, une commande d’approvisionnement ou une réponse plausible réussie n’établit pas cette chaîne.
Avant de commencer
Avoir :
- Effectuer les tests de composants et d’intégration, y compris les données de test connues et les résultats attendus.
- Le fichier ZIP candidat, l’identité/la version de son package, ainsi que les versions des composants, les points de terminaison et les références de connexion qu’il contient.
- Un client de développement, des données hors production, un itinéraire d’installation pris en charge pour les composants du package et l’autorisation de l’utiliser.
- Tester les identités des utilisateurs autorisés et restreints ; un administrateur autorisé pour les tests de disponibilité et de blocage.
- Licences, connexion, consentement, connexions et services externes requis pour chaque expérience cible.
- Un enregistrement de test pour chaque scénario et identité.
Avant le test, définissez les vérifications requises du package, de l’installation, de l’accès et de l’exécution, ainsi que les preuves qui établiront chaque résultat. Utilisez les critères de preuve spécifiques au composant pour les revendications d’exécution et les preuves d’installation décrites dans Confirmer la version livrée.
Obtenez une approbation avant de télécharger un package, de l’installer, d’accorder votre consentement, de le partager ou de modifier les paramètres d’administration. Ces procédures changent l’état du locataire ; Utilisez des identités et des audiences de test contrôlées.
Valider les schémas et les références de composants
Ouvrez le ZIP candidat sans le modifier. Lire sa racine manifest.json, enregistrement idversion, et manifestVersion. Confirmez que :
- Le manifeste utilise le schéma de manifeste de l’application Microsoft 365 requis par votre itinéraire.
- Les définitions d’agent et les manifestes d’action inclus utilisent leurs schémas applicables. Un manifeste de plug-in d’API décrit une action d’agent, et non le plug-in de registre externe.
- Les dossiers de compétences, les fichiers associés, les icônes et les descriptions d’outils référencés existent au niveau de leurs chemins de package déclarés.
- Les versions, identificateurs, points de terminaison et références de connexion correspondent aux enregistrements de test du composant et à l’environnement prévu.
- Aucun élément d’identification, secret, journal ou fichier de test non lié n’est inclus.
Pour les outils de développement Work IQ, utilisez les prérequis CLI documentés, notamment Node.js 24.15+, npm et PowerShell 7+ pour ces exemples Windows. Une case activée de code source hors connexion facultative dans le projet existant est :
wiqd plugin validate --mode source --env "<test-environment>"
Vérifiez : Les vérifications des sources applicables réussissent et les capacités ignorées ou non couvertes sont enregistrées.
Vérifie en mode source les diagnostics d’agent déclaratif enregistrés et les protections de projet de base. Il ne valide pas entièrement le schéma de l’application, le contenu des compétences, la racine agentConnectors[]ou le contenu API/OpenAPI référencé. Un projet de compétence uniquement ou de connecteur uniquement ne peut avoir aucune vérification d’agent applicable. Utilisez source explicitement : le mode par défaut est la validation de package, pas une case activée hors ligne.
Valider le package exact
Sélectionnez un fichier ZIP explicitement plutôt que de vous fier à un répertoire de construction avec plusieurs candidats. Dans PowerShell, remplacez l’exemple de chemin d’accès par votre artefact :
$packageFile = (Resolve-Path '.\appPackage\build\<candidate>.zip').Path
Get-FileHash -LiteralPath $packageFile -Algorithm SHA256
Vérifiez : Le fichier résolu est le candidat prévu. Conserver éventuellement le hachage calculé localement pour détecter les modifications ultérieures ; Un hachage local ne prouve pas quels octets l’hôte exécute.
Avant une validation authentifiée, connectez-vous avec l’identité Microsoft 365 souhaitée :
wiqd auth login --interactive wiqd doctorVérifiez : Les vérifications d’authentification et de préparation réussissent pour le client prévu.
Avec l’approbation pour charger ce fichier ZIP vers le service de validation de plateforme, exécutez :
wiqd plugin validate --mode package --package-file "$packageFile"Vérifiez : Les résultats de ce fichier ZIP exact satisfont aux vérifications requises ; conserver les rapports JSON et HTML immuables renvoyés.
Si votre itinéraire de publication nécessite la stratégie de place de marché supplémentaire et des vérifications de preuves, exécutez :
wiqd plugin validate --mode marketplace --package-file "$packageFile"Vérifiez : Les vérifications des packages, des politiques et des preuves requises sont réussies, sans qu’aucune preuve requise ne manque.
Les deux package et marketplace utiliser le fichier ZIP généré, le charger et peut nécessiter une connexion. Ils ne le créent pas ou ne se connectent pas automatiquement. Ils acceptent également un fichier ZIP sans son projet source. Le mode Place de marché ajoute des vérifications de stratégie et de preuves. Son rapport n’est pas une approbation officielle du Store ou de l’Espace partenaires. Suivez le contrat de validation WIQD actuel, et non les noms obsolètes deep, staticou manifest de mode.
Lisez les résultats, la couverture, les vérifications ignorées et les preuves requises, pas seulement le résultat de sortie de la commande. Pour un itinéraire de package Officers Toolkit pris en charge, utilisez Valider le package d’application à l’aide de règles de validation ou atk validate --app-package-file-path <path> comme documenté dans Valider votre application.
Si quelque chose change dans le fichier ZIP, créez un nouveau candidat et répétez la validation. Les modifications apportées au service distant nécessitent un nouveau test d’exécution pertinent, même lorsque le fichier ZIP reste inchangé.
Installer ou charger une version test du package
Utilisez un itinéraire qui accepte votre package d’application Microsoft 365 natif et prend en charge ses composants. Un lien d’installation et de test de l’approvisionnement WIQD identifie un déploiement ; son ouverture n’établit pas que votre ZIP validé final a été installé.
Installation ZIP exacte personnelle
Suivez la procédure de chargement indépendant personnel de Cowork pour l’installation, l’authentification et l’installation du package CLI, lorsque ce package et l’expérience cible sont pris en charge. Transmettre le fichier exact sélectionné dans Valider le package exact, en utilisant $packageFile comme valeur et --file-pathPersonal comme étendue.
Vérifiez : L’installation réussit pour le compte souhaité. Enregistrez l’identité/version du package retourné TitleId ainsi AppId que la sortie du programme d’installation. Dans l’expérience prise en charge, vérifiez que le plug-in installé expose les composants et l’identité attendus et que les connexions requises sont terminées.
Si la stratégie désactive l’itinéraire personnel ou si l’itinéraire n’est pas pris en charge pour le candidat, utilisez un itinéraire compatible approuvé plutôt que de modifier les contrôles de sécurité.
Chargement du package Cowork
Pour un package Cowork pris en charge, suivez Télécharger un package de plug-in et ses conseils de partage. Choisissez le fichier ZIP Microsoft 365 natif validé exact et limitez l’accès à l’identité de test ou à une audience de test explicitement autorisée. Suivez Utilisez des plug-ins avec Cowork pour activer le plug-in et effectuer les connexions requises dans une nouvelle conversation.
Vérifiez : Le fichier sélectionné et l’identité de plug-in affichée correspondent à l’enregistrement candidat. Le plug-in est installé pour l’identité prévue, les compétences attendues et le status de connecteur s’affichent, et les opérations protégées utilisent le compte connecté prévu.
Les chargements au format étranger peuvent être convertis automatiquement. Une telle conversion n’est pas la preuve que votre ZIP Microsoft 365 d’origine a été testé inchangé. Rétablissez l’artefact et la preuve de validation si l’itinéraire le transforme.
Confirmer la version livrée
Conservez un enregistrement d’installation qui relie le code postal sélectionné exact et son manifeste idversion à l’installation réussie, au compte prévu et aux identités d’installation retournées. Pour l’itinéraire de chargement indépendant personnel documenté, conservez la commande avec son chemin de fichier résolu, les métadonnées du manifeste du candidat et la sortie du programme d’installation contenant TitleId et AppId. Pour un téléchargement de Cowork natif pris en charge, conservez le fichier sélectionné et l’enregistrement de téléchargement/installation réussi avec l’identité du plug-in affichée et le compte de test.
Utilisez cette chaîne comme preuve d’installation pour le candidat testé. Mettez en corrélation les métadonnées de version exposées par l’hôte ou l’administration avec le candidat et examinez les incompatibilités avant de les tester. Enregistrez les preuves d’installation séparément de l’invocation.
Les étapes d’installation personnelle mentionnées ne documentent pas une requête de version installée universelle ou un hachage de package côté serveur. Ni l’un ni l’autre n’est requis par cette procédure : l’enregistrement d’installation établit quel candidat a été soumis et installé avec succès, et non une vérification indépendante des octets exécutés par l’hôte. Si vos critères de publication exigent une version indépendante côté hôte ou une vérification des octets, obtenez cette preuve ; son absence reste non vérifiée et bloque cette affirmation de version. Un lien d’approvisionnement, un nom de plug-in, une réponse réussie ou un hachage local n’établissent pas à eux seuls la chaîne d’installation.
Pour un candidat géré par l’administrateur, suivez la procédure actuelle de téléchargement et d’installation du registre, délimitez les utilisateurs de test et conservez l’enregistrement d’artefact et d’installation accepté. Si l’itinéraire accepte un type d’artefact différent ou ne peut pas établir sa relation avec le ZIP validé, traitez la case activée de liaison d’artefact comme non vérifiée et non équivalente.
Tester le plug-in empaqueté
Répétez les scénarios d’intégration complets avec le candidat installé, et non le déploiement de développement antérieur :
Démarrez une nouvelle conversation dans chaque expérience revendiquée. Utilisez le même rôle d’identité, le même enregistrement connu, la même entrée et le même résultat attendu que les tests du composant.
Vérifiez : Le composant installé prévu est sélectionné.
Recueillez les preuves spécifiques au composant. Pour les appels à distance, mettez en corrélation les journaux de service authentifiés avec la requête, les entrées et les données renvoyées.
Vérifiez : La preuve de l’hôte identifie la compétence sélectionnée ou chargée, le cas échéant. Les appels d’outils obligatoires ont des preuves d’appel corrélées et leurs données renvoyées contribuent à la réponse.
Inspectez les fichiers de sortie et les citations. Répétez les cas d’échec et les cas limites applicables.
Vérifiez : L’exactitude, les limites d’accès, les approbations et le comportement des échecs répondent aux critères prédéfinis.
Pour les compétences de note de publication, réutilisez Added CSV export; Fixed duplicate rows; Updated help text. les fonctionnalités de vérification, les correctifs, les autres et les fichiers promis. Pour effectuer une recherche MCP, comparez le titre, le status et l’URL exacts du problème connu lié aux journaux de service. Utiliser les outils de données probantes propres aux composantes ; Une route de diagnostic d’agent seule n’établit pas qu’un plug-in installé autonome a été exécuté.
Séparez l’exactitude et les résultats d’appel. Les preuves manquantes pour une case activée requise restent non vérifiées. Enregistrez les diagnostics supplémentaires non disponibles en tant que limitations, et non en tant que détails d’exécution vérifiés ou en tant qu’échecs automatiques. Répétez les tests de découverte, de connexion, de sélection et d’exécution séparément dans Chat et Cowork lorsque vous revendiquez les deux.
Tester l’authentification et l’accès
Demandez à un administrateur autorisé de préparer des paramètres de test contrôlés via Définir la disponibilité des plug-ins pour les utilisateurs et Gérer les plug-ins, les compétences et les serveurs MCP. Enregistrez les paramètres d’origine et restaurez-les après le test approuvé. Utilisez la même recherche inoffensive ou un scénario équivalent pris en charge par votre plug-in. Pour un case activée inapplicable, tel que le consentement à un service dans un scénario de compétence uniquement, enregistrez la raison plutôt que d’ajouter une fonctionnalité.
| Test | Installation et action | Résultat attendu |
|---|---|---|
| Utilisateur autorisé | Incluez l’identité de test dans l’audience approuvée. Connectez-vous en tant qu’utilisateur et effectuez les consentements/connexions requis. | Le scénario pris en charge réussit dans les autorisations sources de cet utilisateur ; Les preuves d’appel identifient la capacité attendue. |
| Utilisateur restreint | Limitez la disponibilité à l’audience approuvée, puis testez avec un compte en dehors de cette audience. | L’utilisateur ne peut pas utiliser le plug-in. Dans le canal Copilot, le listing peut rester détectable comme bloqué ; Les utilisateurs éligibles peuvent demander l’accès. La visibilité seule n’est pas un échec. |
| Consentement refusé | Utilisez une identité/connexion de test sans octroi existant. Refusez le consentement requis de l’opération et réessayez la recherche protégée. | L’opération n’obtient pas l’accès protégé demandé. Enregistrez l’erreur de connexion/consentement et assurez-vous qu’aucun résultat protégé n’est présenté comme réussite. Les fonctionnalités autorisées non liées peuvent toujours fonctionner. |
| Bloquer et débloquer | Demandez à l’administrateur de suivre Bloquer un plug-in ou une compétence pour le candidat. Répétez la demande avec un utilisateur précédemment autorisé, puis demandez à l’administrateur de sélectionner Débloquer pour le plug-in et de répéter la demande à nouveau. | Lorsqu’ils sont bloqués, le plug-in et les agents dépendants ne peuvent pas être utilisés. Les serveurs/connecteurs MCP associés restent disponibles pour les autres plug-ins. Après le déblocage, l’utilisateur précédemment autorisé peut à nouveau utiliser le plug-in, sous réserve de la disponibilité, de l’autorisation et des exigences de connexion d’origine. |
Les restrictions de catégorie d’éditeur sont des contrôles distincts. Si vous en testez un, enregistrez la catégorie et le résultat de sa politique ; Ne modifiez pas les paramètres à l’échelle de l’organisation simplement pour tester un candidat. Testez le renouvellement/reconnexion de la connexion, les autorisations sources et les connexions manquantes, le cas échéant.
Pour l’authentification par code d’autorisation Microsoft Entra, le consentement refusé renvoie une erreur d’autorisation ; utilisez l’erreur du fournisseur réel au lieu d’attendre un libellé identique dans chaque hôte.
Tester les expériences prises en charge
Enregistrez un résultat par expérience, rôle d’identité et scénario, y compris les preuves d’installation et de version remise. Un pass dans Cowork n’établit pas de pass dans le Chat ou un autre hôte. Utilisez l’itinéraire pris en charge pour chacun ; Les preuves d’installation ou de version non résolues empêchent une revendication de mise en production pour cette expérience.
Enregistrer des résultats de qualité agent
Si un agent est inclus et que vos critères de publication nécessitent une évaluation de la qualité, évaluez la version déployée correspondante et liez ses résultats à l’enregistrement candidat. Commencez par la vue d’ensemble de l’évaluation des agents. Les scores de qualité ne remplacent pas les preuves de package, de version installée, d’accès ou d’appel.
Répéter les tests de régression pour un candidat
Réexécutez les scénarios de base enregistrés, les tests d’accès, les cas d’échec et toute évaluation d’agent requise par rapport au candidat installé. Ajoutez des cas spécifiques aux modifications sans supprimer la ligne de base. Conservez les deux ensembles d’enregistrements de test, comparez les résultats et résolvez les régressions ou les vérifications non vérifiées requises avant l’approbation.
Pour la préparation de base et le cycle de vie de la mise à jour, y compris les décisions de publication, de déploiement, de remplacement et de restauration, suivez Surveiller, mettre à jour et retirer votre plug-in ou agent. Ne présumez pas qu’il s’agit de mises à niveau automatiques, d’affectations conservées ou d’un déclencheur de renouvellement de consentement particulier. Après le déploiement, répétez la vérification de la version livrée et du runtime.
Déterminer la disponibilité de la mise en production
Complétez l’enregistrement de test partagé avec l’identité et la version du package, le fichier ZIP exact et le hachage facultatif, les versions et points de terminaison des composants, l’environnement, l’identité du test, le rôle, le scénario, les résultats attendus et réels, les preuves d’appel nettoyées, le status et le propriétaire. Joignez les rapports de validation et les preuves d’installation et de version.
Attribuez un résultat :
- Prêt - Le candidat exact a passé toutes les vérifications requises avec des preuves complètes et aucun blocage de libération non résolu.
- Bloqué : une case activée requise a échoué ou reste non vérifiée, y compris la liaison d’artefact, la version livrée, l’accès ou l’appel.
- Prêt avec des limites - Vérifications requises réussies ; les limitations non bloquantes restantes sont documentées, acceptées et adaptées à la divulgation.
Appliquer les critères de vérification et de preuve requis définis avant le test. Une limitation diagnostique acceptée ne peut pas transformer les preuves requises manquantes en réussite ; Les diagnostics supplémentaires ne sont pas obligatoires lorsque les vérifications requises disposent déjà de preuves suffisantes. Pour chaque bloqueur, enregistrez un propriétaire et une résolution. Créez un nouveau candidat lorsque l’artefact change, réinstallez-le et répétez les tests affectés et de régression.
Contenu associé
- Créer le package de plug-in
- Testez les composants de votre plug-in ensemble
- Surveiller, mettre à jour et retirer votre plug-in ou agent
Étape suivante
Lorsque les preuves requises sont complètes, continuez à publier & distribuer :