Intégrer et tester les composants de votre plugin

Le package et le test transforment les composants fonctionnels en un artefact de mise en production testé. Effectuez le travail dans cet ordre :

Étape Ce que vous confirmez Commencer par
Capacités d’intégration Les composants terminés fonctionnent ensemble dans l’environnement de développement ou de test prévu. Cet article
Création du package Un itinéraire d’empaquetage pris en charge produit l’artefact versionné exact que vous avez l’intention de publier. Créer le package de plug-in
Valider et tester le package L’artefact exact réussit la validation du package, s’installe correctement et fonctionne dans toutes les versions Microsoft revendiquées. Valider et tester le package
Évaluer la qualité de l’agent, si nécessaire L’agent déployé répond aux critères de qualité de réponse pour la publication. Vue d’ensemble de l’évaluation d’agent

Cet article décrit la première étape. Il ne teste pas le package final. La validation du package et le test du plug-in installé commencent après la création de l’artefact.

Préparer l’environnement de test

Avant le test :

  • Utilisez les versions prévues de chaque composant.
  • Configurez le développement ou testez les identités, les autorisations, le consentement et les connexions.
  • Démarrez ou rendez disponibles les services distants requis dans l’environnement de développement ou de test.
  • Vérifiez que les utilisateurs cibles et les comptes de test peuvent accéder aux expériences Microsoft prévues.
  • Utilisez des données de test représentatives qui n’exposent pas de secrets de production ou d’informations personnelles inutiles.
  • Enregistrez le résultat attendu, l’environnement, le propriétaire et les preuves requises pour chaque scénario.

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

Composant Vérifications d’intégration
Agent déclaratif Identité, instructions, démarrages de conversation, connaissances, sélection de fonctionnalités, réponses, limites et invites non prises en charge
Compétence Découverte ou pièce jointe, instructions, ressources, scripts, entrées, sorties, demandes non prises en charge et échecs
Connector Authentification, schéma, indexation ou récupération, actualisation, filtrage de sécurité, autorisations, mises à jour, suppressions et échecs de source
Serveur MCP Découverte d’outils ou de ressources, authentification, entrées, résultats structurés, confirmations, erreurs, délais d’expiration, disponibilité et journaux

Utilisez les directives d’analyse applicables propres au produit :

Work IQ DevUI est une surface de débogage basée sur un navigateur en préversion qui peut afficher les plug-ins, la récupération, les citations, les identificateurs de demande et les résultats bruts sélectionnés. Les commandes WIQD Work IQ sont expérimentales et peuvent répertorier les agents déclaratifs déployés ou envoyer une invite de test par ID ou nom d’agent. Ces routes testent un agent déclaratif déployé ; Ils ne remplacent pas la validation du package ou le test du plug-in installé final.

Tester des scénarios utilisateur complets

Testez les scénarios de bout en bout à partir du brief de solution plutôt que de tester uniquement des fonctionnalités individuelles.

  1. Commencez par une invite ou une tâche d’utilisateur représentatif.
  2. Vérifiez que l’agent prévu ou l’expérience Microsoft traite la demande.
  3. Confirmez que la compétence, le lien, l’action ou l’outil MCP approprié est sélectionné.
  4. Vérifiez le comportement de l’authentification, du consentement, de la confirmation et de l’autorisation.
  5. Vérifiez que le composant reçoit les entrées prévues et retourne le résultat attendu.
  6. Confirmez que la réponse finale est exacte, utile et compréhensible.
  7. Vérifiez que les journaux et les diagnostics identifient les composants impliqués.

Lors des tests dans Microsoft 365 Copilot, vous pouvez entrer -developer on dans Copilot Chat pour inspecter les métadonnées de l’agent et la sélection des actions. Entrez -developer off lorsque vous avez terminé.

Échecs et limites des tests

Incluez ce qui suit :

  • Authentification manquante ou expirée.
  • Autorisations insuffisantes ou consentement refusé.
  • Données, connexions, API ou services distants indisponibles.
  • Entrée utilisateur non valide, ambiguë ou non prise en charge.
  • Résultats vides, partiels, retardés ou mal formés.
  • Délais d’expiration, limitation et comportement des nouvelles tentatives.
  • Tentatives d’accès aux données en dehors des autorisations de l’utilisateur.
  • Instructions qui doivent empêcher ou rediriger une opération non prise en charge.

Ne considérez pas un repli silencieux comme un succès. L’utilisateur et l’équipe de support doivent être en mesure de comprendre ce qui a échoué et quelle action est nécessaire.

Enregistrer les résultats d’intégration

Pour chaque scénario de test, enregistrez :

  • Environnement et l’expérience Microsoft.
  • Versions du composant et du service.
  • Configuration de l’identité, des autorisations et de la connexion.
  • Résultat attendu et réel.
  • Journaux ou preuves.
  • Limitation connue, propriétaire et décision de résolution ou d’acceptation.

Enregistrez les fichiers exacts, les configurations, les points de terminaison, les versions des composants, les propriétaires et les preuves que l’auteur du package doit utiliser.

Confirmer la préparation du package

Le test d’intégration est terminé lorsque :

  • Chaque composant requis est généré, configuré, étendu ou réutilisé.
  • Chaque composant fonctionne indépendamment dans l’environnement de développement ou de test.
  • Les composants fonctionnent ensemble pour les scénarios de bout en bout.
  • Les identités, autorisations, connexions, données et services requis sont disponibles.
  • Le comportement d’authentification, de confirmation, d’erreur et d’échec attendu est implémenté.
  • La propriété des composants, les dépendances, les versions, les limitations et les responsabilités en matière de support sont documentées.
  • Les fichiers d’implémentation et la configuration sont identifiés et prêts à être assemblés.
  • Aucun blocage d’implémentation non résolu n’empêche la création de packages.

Continuez à empaqueter votre plug-in.