Testez les composants de votre plug-in ensemble

Testez le contenu ou les références de votre package de plug-in : compétences, connecteurs MCP distants et agent déclaratif si vous en incluez un. Ce package & tâche de test établit le comportement et l’intégration des composants avant de créer l’artefact de mise en production. La validation finale du package, l’installation et les vérifications de l’expérience de mise en production suivent dans Tester et valider votre plug-in. Choisissez les tests pour vos composants, conservez un registre des tests, puis terminez Avant de mettre en package.

Choisissez vos tests

Vérifier les composants du scénario intégré

Dans votre plug-in Tester avec Section
Compétences au niveau du plug-in, avec ou sans agent Session de développement cowork ; sélection de compétences de chat prise en charge Tester des compétences
Connecteurs de plug-in pointant vers des serveurs MCP distants Inspecteur, puis la même tâche via le plugin dans Cowork Tester les connecteurs MCP distants
Agent déclaratif, le cas échéant Work IQ Dev Tools ask command et DevUI Tester un agent déclaratif inclus
Dépendances utilisées par votre solution Connector diagnostics, puis répéter la tâche intégrée Tester les dépendances

Sachez quel connecteur vous testez

  • Connecteur de plug-in : Une entrée de manifeste agentConnectors[] d’application. Cet article teste le type MCP distant : le package référence un serveur ; Il ne contient pas le service en cours d’exécution.
  • Connecteur Copilot (synchronisé) : Ingère les connaissances dans Microsoft Graph. Testez son ingestion et sa récupération ultérieure en tant que dépendances.
  • Connecteur Copilot (fédéré) : Récupère les données actives sous l’identité connectée. Testez l’accès en direct séparément de l’ingestion.
  • Connecteur Power Platform : Un outil Copilot Studio. Le fait de le tester n’établit pas que son agent est un plug-in de registre.

La référence de création de plug-in documente également un itinéraire explicite pour les références de connecteur personnalisé OpenAPI existantes. Utilisez les exigences de cette route, le cas échéant ; la procédure MCP décrite dans cet article ne teste pas ce type de connecteur.

Comment juger un résultat

Vérifiez chaque composant indépendamment, puis exécutez une tâche qui utilise les composants ensemble. Un appel de service direct réussi établit le comportement du serveur. La tâche intégrée établit la sélection, la saisie, l’authentification et l’utilisation des données renvoyées.

Avant les essais, définissez les vérifications requises et les preuves acceptables pour chaque composant et l’expérience cible. Incluez la sélection de composants, les résultats corrects et les limites d’accès. Utilisez des preuves appropriées à l’affirmation :

Composant ou revendication Preuves à conserver
Sélection des compétences et comportement Hébergez des preuves qui identifient la compétence sélectionnée ou chargée, ainsi que les sorties et fichiers requis. Dans le panneau latéral de Cowork, Compétences identifie les compétences chargées. La sélection explicite n’établit pas l’appel automatique.
Appel MCP à distance Les journaux de service authentifiés sont corrélés à la demande de l’hôte, identifiant l’opération, les entrées et le résultat. Un appel direct d’inspecteur n’établit pas l’appel via le plug-in.
Agent inclus Identité, requête et réponse de l’agent déployé, et diagnostics de sélection, de récupération et de citation des fonctionnalités disponibles. Les diagnostics de l’agent seuls n’établissent pas l’appel de chaque compétence ou script inclus.
Exécution du script de compétence Execution diagnostics when expos. Les fichiers de sortie requis établissent le résultat de sortie, et non la preuve qu’un script particulier s’est exécuté. Si l’exécution de ce script est une exigence de mise en production, procurez-vous des preuves qui l’établissent.
  • Jugez l’exactitude de la réponse séparément de la preuve d’invocation. Un agent peut produire des notes de mise à jour plausibles sans charger votre compétence.
  • Les preuves manquantes pour une case activée requise restent non vérifiées et bloquent la préparation. N’affaiblissez pas une case activée requise, car les diagnostics ne sont pas disponibles.
  • Lorsqu’un hôte n’expose aucun détail de diagnostic supplémentaire, enregistrez cette limitation sans prétendre que les détails ont été vérifiés. Les diagnostics indisponibles ne sont pas un bloqueur distinct lorsque les preuves satisfont déjà aux vérifications requises.
  • Traitez le rétablissement silencieux ou un résultat incomplet comme un échec.
  • Conservez les preuves nettoyées dans un stockage approuvé, jamais les informations d’identification. Les instantanés d’agent peuvent contenir du contenu sensible.

Conditions préalables et données de test connues

Utilisez un projet de plug-in existant, un client de développement, des identités de test connues et des données de non-production. Sélectionnez les environnements et les expériences Microsoft que vous souhaitez prendre en charge. Autorisez la connexion, le consentement, les connexions et les services externes requis avant le test.

Pour les commandes suivantes, installez les outils de développement Work IQ : Node.js 24.15+ et npm sont requis pour l’interface de ligne de commande, ainsi que PowerShell 7+ sous Windows.

Préparer :

  • Enregistrement connu : Problème 123 dans un référentiel de test, avec son titre exact, son status et son URL enregistrés à partir de la source.
  • Entrée de compétences :Added CSV export; Fixed duplicate rows; Updated help text. Pour une compétence Notes de publication, attendez-vous respectivement aux fonctionnalités, corrections et autres, ainsi qu’à tout fichier promis ou contenu produit par un script.

Remplacez les exemples de noms, les ID et les espaces réservés. Se connecter et case activée préparation avant les commandes de client :

wiqd auth login --interactive
wiqd doctor

Vérifiez : Les vérifications de connexion et de préparation réussissent pour le client prévu.

Pour les invites facultatives de l’assistant, installez l’interface de ligne de commande GitHub Copilot. Si son plug-in de guide WIQD n’est pas déjà installé, exécutez ces commandes, puis démarrez une nouvelle session dans votre projet de plug-in existant :

copilot plugin install wiqd@awesome-copilot
copilot plugin list --json
copilot

Vérifiez : L’inventaire affiche le guide WIQD installé et activé. Les installations existantes doivent suivre le guide d’installation plutôt que d’ajouter des doublons. Ce plug-in de guide n’installe pas l’interface de ligne de commande WIQD. Collez les invites de l’assistant dans la session coding-assistant ; les demandes d’agent déployé utilisent à la place l’option -q de Test d’un agent déclaratif inclus.

Tester des compétences

Composant du plug-in : Compétences au niveau du plug-in enregistrées via app-manifest agentSkills.

Ce que cela prouve : La compétence prévue charge et produit la sortie attendue dans un déploiement de développement.

Encore à prouver après l’emballage : L’artefact exact est validé, s’installe via votre itinéraire de distribution et s’exécute dans chaque expérience revendiquée.

Preuves à conserver : Déploiement/version, compétence chargée, fichiers d’entrée, de sortie et journaux d’appels à distance disponibles.

Utilisez Copilot Cowork pour le déploiement de développement. Réutilisez le lien d’installation/test imprimé lorsqu’il est disponible.

  1. Si l’approvisionnement est nécessaire, inspectez m365agents.yml et le fichier d’environnement sélectionné sous sa configuration environmentFolderPath est d’abord. Confirmez le locataire et effectif AGENT_SCOPE; les modèles automatiques standard sont utilisés local pour une portée personnelle et dev pour une étendue partagée, mais les noms seuls ne sont pas une preuve. Approuvez les modifications proposées, puis exécutez :

    wiqd plugin provision --env "<test-environment>"
    

    Vérifiez : L’approvisionnement réussit et renvoie le lien installer/tester du déploiement.

  2. Ouvrez ce lien renvoyé et terminez l’installation et les connexions requises à l’aide de l’identité de test. Démarrez une session de cowork et demandez des notes de publication à l’aide de l’entrée connue.

    Vérifiez : Votre compétence s’affiche sous Compétences dans le panneau latéral de la session.

  3. Inspectez la réponse et tous les fichiers sousAperçu du dossier> de sortie ou Téléchargement.

    Vérifiez : Toutes les modifications apparaissent dans les catégories prévues et les fichiers promis correspondent aux exigences.

  4. Exécutez les tests de détection et d’appel dans chaque expérience prise en charge, à l’aide de ce déploiement et de l’entrée connue.

    Vérifiez : La découverte, la sélection et le comportement d’échec répondent aux exigences de la compétence pour cette expérience.

Un test de compétence téléchargé personnellement diffère de l’inscription du plugin ; les compétences attachées à l’agent agentSkillssont plutôt utilisées agent_skills dans le manifeste de l’agent déclaratif. La preuve de compétence chargée n’établit pas l’exécution par script.

Au cours du cycle de vie documenté, l’approvisionnement crée ou met à jour le déploiement du locataire dans l’étendue sélectionnée et écrit les liaisons d’environnement. La réutilisation d’une identité de ressource existante peut affecter les utilisateurs actuels ; autorisez ces modifications. L’approvisionnement n’exécute pas les commandes de publication ou de partage séparées. Le lien d’installation n’est pas une preuve de publication du registre, de disponibilité du public ou d’installation de votre code zip final. Continuez séparément via Publier & distribuer et Mettre à disposition & régir, y compris l’approbation, l’installation, le consentement et les connexions applicables.

Vous préférez utiliser l’interface de ligne de commande GitHub Copilot ?

Help test <skill-name> in this plugin's existing Cowork development deployment.
Reuse its printed install link. Ask before provisioning; inspect the actual
environment scope first. Don't publish or share. Request release notes for
"Added CSV export; Fixed duplicate rows; Updated help text." Compare categories
and promised files; test missing input. Guide explicit/automatic Chat selection
if supported. Let me operate inaccessible UI and handle sign-in/consent.
Show actual evidence and ask before installs, exposure, or external changes.

Tester les connecteurs MCP distants

Composant du plug-in :agentConnectors[] les entrées pointant vers des services MCP distants.

Ce que cela prouve : Comportement du serveur indépendamment, puis utilisation authentifiée via votre plug-in de développement.

Encore à prouver après l’emballage : Les déclarations de connecteur, la configuration de la connexion et les appels d’exécution fonctionnent à partir de l’artefact installé exact.

Preuves à conserver : Point de terminaison/version, schéma d’outil, entrées/résultats, identité et enregistrements hôte/serveur corrélés.

Utilisez MCP Inspector avec Node.js 22.19.0+, le point de terminaison Streamable HTTP approuvé, ses détails d’authentification et une opération sécurisée en lecture seule.

  1. Lancez l’inspecteur, en remplaçant l’exemple d’URL :

    $serverUrl = 'https://your-server.example/mcp'
    npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http
    

    Vérifiez : L’authentification se termine et l’identité et les fonctionnalités de serveur attendues apparaissent.

  2. Répertoriez les outils, sélectionnez l’opération de recherche, entrez les champs définis par le schéma pour l’enregistrement connu et exécutez-la.

    Vérifiez : Le schéma et le titre, le status et l’URL renvoyés correspondent aux attentes.

  3. Répétez l’opération avec un enregistrement inexistant et une identité restreinte.

    Vérifiez : Le comportement d’enregistrement manquant est actionnable et le contenu non autorisé reste inaccessible.

  4. Ouvrez le lien d’installation et de test de Cowork du plug-in de développement, à l’aide de l’étape d’approvisionnement dans Tester les compétences si nécessaire ; les projets de connecteur uniquement ne nécessitent aucune compétence. Terminez la configuration de la connexion et demandez le même enregistrement. Si une compétence doit utiliser le connecteur, appelez-le avec cette requête.

    Vérifiez : Les journaux de service authentifiés affichent l’opération et les entrées attendues, et les valeurs renvoyées correspondent au résultat de la session.

  5. Testez toute opération d’écriture approuvée uniquement sur des enregistrements jetables, y compris l’annulation.

    Vérifiez : Les modifications approuvées correspondent à la demande et l’annulation laisse les données sources inchangées.

Comparez la référence de point de terminaison et d’authentification dans la configuration de votre composant avec ce qui s’est réellement exécuté. Respecter les exigences du connecteur, y compris les exigences applicables en matière de description de l’outil ; Server Success ne suffit pas à établir la préparation de la connexion hôte.

Pour un service local, démarrez-le avec la commande de son projet. Après avoir approuvé l’exposition, suivez Créer un tunnel de développement persistant. Pour ce connecteur de plug-in, définissez remoteMcpServer.mcpServerUrl sur le point de terminaison HTTPS public avec son chemin MCP réel ; mettez à jour son déploiement de développement via le flux de travail du projet et effectuez un nouveau test. Conservez l’authentification des applications et arrêtez le tunnel une fois les tests terminés.

Vérifiez : Les journaux de service affichent la demande authentifiée de l’hôte au point de terminaison prévu.

Vous préférez utiliser l’interface de ligne de commande GitHub Copilot ?

Help test this plugin's remote MCP connector at <endpoint>. Show the Inspector
command and ask before downloads or launch. Let me authenticate and call
<read-only-tool/input>; compare with <expected-record>. Then guide the same
task in the existing Cowork deployment and correlate sanitized server logs.
Ask before exposure, deployment, or writes; report diagnostics you can't see.

Tester un agent déclaratif inclus

Composant du plug-in : Agent déclaratif optionnel composé dans le projet de plugin.

Ce que cela prouve : Réponses de l’agent et diagnostics de plug-in sélectionné, de récupération et de citation disponibles.

Encore à prouver après l’emballage : Les références de l’agent empaqueté et le scénario complet de plug-in installé fonctionnent dans les expériences revendiquées.

Preuves à conserver : Agent/version, ID de requête/conversation, capacité sélectionnée, entrée et sortie réelle.

Suivez l’anatomie du projet de plug-in pris en charge. Utilisez Work IQ Dev Tools et DevUI sur l’agent déjà déployé correspondant à ce composant.

  1. Listez les agents et exécutez la recherche :

    wiqd agent list
    wiqd plugin ask --component agent --agent-id "<agent-id>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    Vérifiez : L’agent sélectionné et les valeurs retournées correspondent à l’enregistrement du composant et de la source.

  2. Activez l’indicateur d’aperçu DevUI documenté et répétez :

    wiqd config flags set devui true
    wiqd devui start --agent "<agent-name>"
    wiqd devui ask --agent "<agent-name>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    Inspectez les plugins sélectionnés, la récupération, les citations et les résultats bruts.

    Vérifiez : Les diagnostics disponibles identifient la fonctionnalité prévue et les données retournées attendues.

  3. Si l’agent a une compétence attachée, vérifiez sa case activée sa sortie :

    wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."
    

    Vérifiez : Les modifications et les fichiers promis satisfont aux exigences de la compétence.

  4. Arrêtez le serveur de diagnostic :

    wiqd devui stop
    

    Vérifiez : Les rapports de commandes se sont arrêtés ou ne s’exécutent pas.

Les diagnostics publiés par DevUI n’établissent pas d’appel par compétence ou par script. Enregistrez l’exactitude de la sortie séparément. Testez également les instructions spécifiques à l’agent, les invites suggérées et les requêtes hors portée par rapport à leur comportement défini.

Vous préférez utiliser l’interface de ligne de commande GitHub Copilot ?

Use WIQD to list agents; let me choose the component's deployed <agent-id>.
Ask it for issue 123 in <repository>, comparing with <expected-title/status/URL>.
Open DevUI and repeat; help inspect selected plugins, retrieval, citations,
raw results, and request IDs. If <skill-name> is attached, request release
notes for "Added CSV export; Fixed duplicate rows; Updated help text."
Compare outputs separately from invocation evidence. Show commands/results
and stop DevUI. Ask before configuration, deployment, sharing, or external
writes. Let me handle sign-in and inaccessible UI; don't publish anything.

Consultez le workflow agentique DevUI documenté.

Tester les dépendances

Testez les services et les connaissances sur lesquels reposent vos composants, puis répétez la tâche de plug-in intégré. Ces vérifications de dépendance ne sont pas des inscriptions supplémentaires de composants de plug-in.

Connecteur Copilot synchronisé

Dépendances : Base de connaissances indexée utilisée par l’agent inclus.

Ce que cela prouve : Ingestion, actualisation, autorisations et récupération ultérieure.

Encore à prouver après l’emballage : Le plug-in installé utilise la connexion et les enregistrements prévus.

Preuves à conserver : ID de connexion, sortie d’analyse, nombre indexé, citations et valeurs sources.

Pour le modèle Problèmes GitHub, suivez Créer votre premier connecteur synchronisé pour les vérifications des conditions préalables, de la configuration du dépôt, du consentement, de l’analyse et de l’indexation. Pour d’autres implémentations, utilisez leurs procédures d’analyse et de diagnostic documentées.

  1. Vérifiez que l’ID de connexion configuré pour l’agent inclus correspond à la connexion testée et que l’enregistrement connu est indexé.

    Vérifiez : Les diagnostics de connexion identifient la source prévue et les éléments indexés attendus.

  2. Interrogez l’agent configuré avec cette connexion, puis mettez à jour un problème jetable, réexécutez le connecteur et interrogez à nouveau. Testez la suppression par le biais de son chemin de réconciliation et de son accès restreint lorsque les autorisations d’élément s’appliquent.

    Vérifiez : Exigences en matière de correspondances des valeurs, des citations, des mises à jour, de la gestion des suppressions et des correspondances d’accès.

Connecteur Copilot fédéré

Dépendances : Une connexion fédérée disponible utilisée dans le scénario pris en charge.

Ce que cela prouve : Récupération en direct sous l’identité connectée.

Encore à prouver après l’emballage : Votre scénario complet de plug-in installé utilise le chemin d’accès aux données prévu.

Preuves à conserver : Identité, enregistrement source, réponses/citations et journaux de service disponibles.

  1. Dans Copilot Chat, sélectionnez ...>Paramètres>Sources, recherchez la source, sélectionnez Se connecter et authentifiez-vous.

    Vérifiez : La connexion réussit pour l’identité prévue.

  2. Demandez l’enregistrement connu par nom ou ID de source. Mettez à jour un enregistrement jetable et répétez. Testez également une identité restreinte.

    Vérifiez : Les modifications dynamiques apparaissent et les autorisations source restent appliquées.

Tester des scénarios utilisateur complets

Exécutez la même tâche connue dans l’expérience prévue avec tous les composants requis activés. Par exemple, demandez à une compétence de récupérer le problème connu et de produire des notes de publication uniquement si ce flux de travail combiné fait partie de votre solution.

  1. Démarrez une nouvelle conversation avec l’identité et l’entrée de test souhaitées.

    Vérifiez : La compétence ou l’agent attendu gère la demande.

  2. Recueillez les preuves spécifiques au composant. Pour les appels distants, mettez en corrélation les diagnostics de l’hôte disponible avec les journaux de service authentifiés.

    Vérifiez : Le composant prévu est sélectionné. Lorsqu’un outil est nécessaire, il reçoit l’entrée et l’identité correctes, et sa sortie réelle est utilisée.

  3. Comparez la réponse et les fichiers avec le résultat attendu.

    Vérifiez : Le contenu, les citations et les résultats promis correspondent aux exigences.

Échecs et limites des tests

Répétition avec entrée manquante ou ambiguë, authentification expirée, consentement refusé, données restreintes, dépendances indisponibles, résultats vides ou malformés, échecs de script, délais d’expiration, limitation et tentatives. Confirmez le comportement d’échec sûr et actionnable et les confirmations requises. Enregistrez chaque résultat attendu avant d’exécuter le test.

Enregistrer les résultats d’intégration

Utilisez un enregistrement par scénario et identité. Apportez-le dans les tests d’emballage ; Remplir les champs du package après l’emballage.

Champ Conserver
Components Versions, fichiers, points de terminaison, références de connexion et révision de la source
Package Identité, version, chemin ZIP et hachage SHA256 facultatif ; En attente avant l’empaquetage
Contexte Environnement, état de l’expérience/de la publication, indicateurs de fonctionnalité, rôle d’identité de test et date
Scénario Vérifications requises, preuves acceptables, données reproductibles et résultat attendu par rapport au résultat réel
Données probantes Journaux d’appel, ID de demande, sorties et emplacements de rapport nettoyés
Décision Réussite, Échec ou Non vérifié ; Lacunes en matière de données probantes, limites du diagnostic, propriétaire et prochaine action

Avant de créer un package

  • Invocation : Confirmer la sélection de la capacité prévue et les entrées/sorties attendues.
  • Accès : Effectuer les contrôles d’accès autorisé/restreint, de consentement et de confirmation.
  • Résultats et échecs : Effectuez les tests d’échec applicables.
  • Expériences prévues : Enregistrer les résultats de développement séparément pour chaque expérience de publication prise en charge ; Planifiez les vérifications finales des artefacts installés.
  • Enregistrement de transfert : Conservez les enregistrements de test et résolvez les blocages de mise en œuvre avant l’empaquetage.
  • Références des packages : Vérifiez que les versions des composants, les fichiers, les identificateurs, les références de connexion et les points de terminaison testés sont ceux auxquels le package fera référence.

Étape suivante

Continuer le package & tester : Créez le package du plugin, puis validez et testez le package en utilisant le même enregistrement de preuve et les références exactes du package.