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.
Utilisez la surveillance, les commentaires et les preuves de support pour décider de corriger, de mettre à jour, de remettre ou de retirer votre plug-in ou agent. Testez les modifications avant leur publication et vérifiez le résultat auprès des utilisateurs prévus.
Les constructeurs entretiennent et testent la solution. Les administrateurs Microsoft 365 exécutent des actions de déploiement organisationnel et d’accès si nécessaire. Les propriétaires de services gèrent les connecteurs, les serveurs MCP distants, les identités et les services externes qu’ils utilisent. Ces responsabilités ne sont pas automatiquement transférées ensemble.
Choisissez une tâche
Utilisez la section pour le travail que vous devez effectuer. La surveillance, le support, le transfert et la mise hors service ne vous obligent pas à suivre le workflow de mise à jour.
| Actions requises | Commencer par |
|---|---|
| Examiner l’adoption, les commentaires ou les résultats des tâches | Surveiller l’utilisation et les résultats des tâches |
| Examiner un problème utilisateur | Prendre en charge les utilisateurs et examiner les problèmes |
| Modifier et publier la solution | Mettre à jour votre plug-in ou agent |
| Transférer les responsabilités de maintenance | Céder la propriété et le soutien |
| Mettre fin à la distribution ou à l’accès | Mettre hors service le plug-in ou l’agent |
Avant de commencer
Identifier :
- L’identité et la version actuelles du plug-in ou de l’agent.
- Les utilisateurs affectés et les expériences Microsoft 365.
- Le propriétaire responsable de la tâche et de toutes les connexions ou services impliqués.
Pour un agent autonome, utilisez les procédures de surveillance et de mise en production prises en charge par son produit de création. Ne présumez pas qu’une procédure de package de plugin s’y applique.
Surveiller l’utilisation et les résultats des tâches
Choisissez une période de rapport, une version, une audience et des tâches représentatives. Utilisez l’expérience de surveillance du produit propriétaire de l’activité.
| Ce que vous surveillez | Par où commencer | Portée à garder à l’esprit |
|---|---|---|
| Un agent intégré à Agent Builder | Surveiller les agents dans Agent Builder | L’onglet Moniteur de l’agent couvre son utilisation et ses retours. La visibilité des commentaires a des conditions préalables distinctes. |
| Un agent Copilot Studio utilisant le harnais standard | Surveiller les performances de l’agent dans Copilot Studio | Utilisez les analyses prises en charge pour cet agent ; Ne présumez pas que les mêmes rapports existent dans le Générateur d’agent ou dans d’autres chemins d’accès de build. |
| Accès au plug-in, tâches utilisateur et échecs | Surveillez votre plug-in | Vérifiez la disponibilité des packages, les résultats des tâches représentatives, les commentaires des utilisateurs et les cas de support. |
| Activité d’audit et d’utilisation de Microsoft 365 | Choisir les éléments à case activée | Utiliser chaque rapport pour l’activité qu’il couvre. Un événement d’audit n’établit pas qu’une tâche a réussi ou qu’une réponse était correcte. |
| Un connecteur ou un service MCP distant | Examiner les échecs et les conseils de surveillance du service | Vérifiez l’état de la connexion, les autorisations sources, l’intégrité du point de terminaison, les journaux et les erreurs avec le propriétaire du service. La disponibilité du package ne prouve pas l’intégrité de l’exécution. |
Ne présumez pas que la télémétrie ou la couverture de rapport est partagée entre les chemins de build du plug-in et de l’agent. Le rapport d’un agent inclus couvre cet agent, pas nécessairement toutes les fonctionnalités du plug-in.
Enregistrez les changements d’adoption, la réussite des tâches, la qualité de la réponse, les échecs de connexion ou d’outils, et le volume de support lorsque les preuves disponibles appuient ces conclusions. Comparez les tâches représentatives et les commentaires des utilisateurs, ainsi que le nombre d’utilisations.
Prendre en charge les utilisateurs et examiner les problèmes
Pour chaque problème, capturez la version affectée, le produit, l’audience, le résultat attendu, le résultat observé et les détails pertinents de l’erreur. Attribuer un propriétaire et action suivante.
- Demandez à l’administrateur d’examiner la disponibilité, l’installation, la stratégie ou les demandes d’accès en attente.
- Demandez au constructeur ou au propriétaire de l’agent d’examiner les instructions, les connaissances, la sélection d’outils ou les régressions.
- Demandez à l’identité, à la connexion ou au propriétaire du service d’examiner les échecs d’authentification, de consentement, d’accès à la source et d’exécution.
Pour les échecs de connexion à l’API ou à l’action MCP, utilisez Résoudre les problèmes liés à l’authentification du plug-in. Pour les vérifications de tâches et de dépendances, utilisez Examiner les échecs.
Confirmez le correctif avec un utilisateur concerné et enregistrez le résultat. Une configuration corrigée ou un appel d’outil réussi n’établit pas en soi que la tâche complète de l’utilisateur fonctionne désormais.
Mettre à jour votre plug-in ou agent
Suivez ce workflow lorsque vous devez modifier la solution. Utilisez les étapes du package pour un plug-in composé. Utilisez la procédure de publication du produit créateur pour un agent autonome.
Avant de mettre à jour
Avoir :
- Preuves de suivi, commentaires des utilisateurs, cas de support ou amélioration prévue.
- Tâches représentatives et critères d’acceptation.
- Accès à la source et fonctionnalités affectées.
- L’enregistrement de publication, y compris la version actuelle, l’audience et le routage de distribution.
- propriétaires de tout changement de connexion, d’identité ou de service.
Établir un planning de référence
- Indiquez le problème ou l’amélioration que vous souhaitez résoudre.
- Identifiez la version du package ou de l’agent, les utilisateurs, les expériences, les fonctionnalités et les dépendances affectés.
- Définir des tâches représentatives et des critères d’acceptation mesurables.
- Exécutez les tâches par rapport à la version actuelle et enregistrez les résultats.
- Si votre organisation administre le plug-in, enregistrez son état actuel, sa disponibilité utilisateur et son état d’installation dansles plug-insoutils>> agents. Pour les contrôles applicables d’un agent, utilisez leregistreTous>les agents>.
- Préservez les preuves dont vous avez besoin pour comparer le comportement actuel et le comportement mis à jour.
Pour un plug-in qui inclut un agent, utilisez la vue d’ensemble de l’évaluation de l’agent pour concevoir une évaluation lorsque la qualité de la réponse, les instructions, les connaissances ou l’utilisation de l’outil fait partie de la modification. L’évaluation peut fournir des preuves avant la publication et aider à examiner les problèmes de qualité après le déploiement, y compris ceux soulevés par les signaux d’utilisation, les commentaires des utilisateurs ou les modifications d’agent et de dépendance.
L’évaluation de l’agent n’est pas requise pour chaque plug-in. Il ne remplace pas les tests de capacité, la validation de package ou le test de l’expérience utilisateur complète.
Pour les agents déclaratifs déployés, utilisez le workflow guidéwiqd agent eval. Pour un contrôle direct de ligne de commande ou de pipeline, consultez Vue d’ensemble de l’interface de ligne de commande des évaluations de Microsoft 365 Copilot.
Appliquer et tester la modification
Revenez à Générer ou réutilisez lorsque vous devez modifier une capacité, une intégration ou une source. Revenez au test Package & lorsque vous devez préparer et valider la version candidate. Conservez les dépendances affectées et les expériences prises en charge dans l’étendue.
- Mettez à jour la capacité source ou affectée.
- Mettre à jour les services ou la configuration gérés séparément lorsque le changement l’exige.
- Testez chaque capacité modifiée et dépendance affectée.
- Réexécutez les tâches de référence et les évaluations.
- Comparez les résultats avec les critères d’acceptation.
- Recherchez les régressions avant de créer le package de publication.
Lorsque la modification affecte un connecteur, un serveur MCP distant, une identité, une autorisation ou un service externe, impliquez le propriétaire de cette dépendance. Ne présumez pas que le changement de package met à jour un service géré séparément.
Créer et valider le package
Pour un agent autonome, suivez les instructions de contrôle de version, de test et de publication du produit de création. Les étapes de package suivantes s’appliquent aux plug-ins composés.
- Affectez une nouvelle version de package et case activée les exigences d’identité pour votre méthode de publication.
- Créez le package de plug-in.
- Validez et testez le package exact que vous avez l’intention de publier.
- Testez la connexion, le consentement, les connexions et les services externes requis.
- Testez le package pour chaque expérience Microsoft 365 que vous souhaitez prendre en charge.
- Enregistrez les limitations connues, la configuration requise et toute option de récupération documentée.
Ne publiez pas un package qui diffère du package que vous avez validé.
Publier et déployer la mise à jour
Choisissez la procédure de mise à jour correspondant à votre produit et à l’itinéraire de distribution. Les itinéraires de publication distinguent le partage, l’envoi de l’organisation et la publication sur le marché.
| Voie de distribution | Instructions ou limitations documentées | Qui agit |
|---|---|---|
| Un plugin partagé via Cowork | Suivez la procédure documentée de téléchargement et de repartage pour une version plus récente d’un plug-in déjà partagé. Cette procédure s’applique au partage de Cowork, et non au remplacement général du registre. | Propriétaire du plug-in |
| Soumission de catalogue d’applications d’organisation via les outils de développement Work IQ | Suivez Envoyer une mise à jour approuvée au catalogue d’applications de l’organisation. Préservez l’identité et l’état de l’environnement existants de la cible de la version, testez la version mise à jour, envoyez-la avec wiqd plugin publishet obtenez l’approbation de l’administrateur. |
Propriétaire et administrateur du plug-in |
| Téléchargement manuel du Registre ou autre méthode de partage direct | Confirmez la procédure de mise à jour de l’élément existant spécifique au produit avant la publication. Cet article ne fournit pas d’outils manuels - Étapes de remplacement de package de Registre. Ne présumez pas qu’un nouveau chargement remplace une entrée existante ou conserve ses paramètres de disponibilité. | Propriétaire et administrateur du plug-in |
| Place de marché Microsoft | Suivez les instructions de mise à jour correspondant au type d’offre utilisé par votre offre publiée. Commencez par les conseils de l’Espace partenaires liés à Publier votre plug-in sur la Place de marché Microsoft. Effectuez toute révision et publication requise avant de diriger les clients vers la mise à jour. | Éditeur et administrateur client, le cas échéant |
Pour une mise à jour WIQD, conservez les ID de ressource et de publication établis. La réapprovisionnement utilise l’identité d’environnement existante et peut modifier les ressources utilisées par les utilisateurs actuels avant l’approbation du catalogue. Testez les modifications en gardant cet effet à l’esprit. Vérifier le cycle de vie de publication du projet par rapport aux directives WIQD pour les projets existants ; la mise à jour de CLI ne met pas à jour les fichiers Project.
wiqd plugin publish soumet un projet et un environnement, pas un ZIP capturé via --package-file. Conservez l’état de la source et de l’environnement approuvé fixé lors de l’envoi et vérifiez la version envoyée. La validation de package seule ne prouve pas que la publication soumet ces octets exacts.
Pour une route avec une procédure de mise à jour documentée :
- Utilisez la procédure de publication ou de partage confirmée pour la version testée et enregistrez si elle a été envoyée, publiée, partagée, rejetée ou bloquée.
- Indiquez à l’administrateur ou au propriétaire du déploiement la version exacte, les utilisateurs prévus, la configuration requise, les limitations connues et le contact de support technique.
- Effectuez uniquement les étapes applicables pour rendre disponible le plug-in ou l’agent mis à jour. Les exigences d’approbation, d’affectation et d’installation dépendent de la méthode et des paramètres de l’organisation.
- Mettez à jour les agents, les connexions, les identités, les serveurs MCP distants ou les services externes contrôlés séparément, si nécessaire.
- Confirmez quelle version a atteint chaque audience.
Planifier la récupération sans supposer la restauration
Les administrateurs peuvent bloquer et débloquer un plug-in dans le Centre d’administration Microsoft 365. Utilisez l’action Débloquer du plug-in pour supprimer un bloc, puis vérifiez l’accès pour les utilisateurs prévus. D’autres exigences en matière de disponibilité, d’installation, d’autorisation et de connexion s’appliquent toujours. Le déblocage ne restaure pas une version antérieure du package ni n’annule les modifications apportées au service.
Les instructions actuelles ne documentent pas de procédure générale de restauration de la version d’un package de plugins. N’utilisez une opération de restauration spécifique au produit que lorsque ce produit le documente.
Avant la publication, enregistrez l’option de récupération documentée et ses conditions préalables, ou enregistrez l’écart de procédure et le propriétaire responsable de l’échec du déploiement.
Le remplacement d’un package ne restaure pas automatiquement un changement de service, de connexion, d’identité, de données ou d’autorisation externe. Planifiez ces dépendances séparément.
Vérification de la mise à jour
- Testez les tâches représentatives avec un utilisateur prévu dans chaque expérience prise en charge.
- Vérifiez que l’utilisateur a reçu la version attendue.
- Vérifiez que la connexion, le consentement, les connexions, les appels d’outils et les services externes fonctionnent.
- L’emplacement où le plug-in est administré dans votre organization, case activée que son status, sa disponibilité utilisateur et son état d’installation correspondent à l’audience prévue dansles plug-insoutils>> agents. Vérifiez si une version remplacée est encore utilisée.
- Répéter les évaluations utilisées pour approuver la modification.
- Examinez les signaux d’utilisation, les commentaires, les erreurs et les cas de support après le déploiement.
- Si la mise à jour ne répond pas aux critères d’acceptation, suspendez le déploiement, enregistrez l’échec et impliquez le propriétaire responsable. N’utilisez une opération de récupération que si le produit le documente.
La mise à jour est terminée lorsque le public prévu dispose de la version correcte, que ses paramètres d’accès correspondent au déploiement prévu, que les tâches représentatives répondent à leurs critères d’acceptation et que chaque problème non résolu a un propriétaire et une action suivante.
Enregistrer la mise à jour
Enregistrement :
- Versions précédentes et mises à jour du package ou de l’agent.
- Changement, raison, fonctionnalités affectées et dépendances.
- Résultats de référence, d’évaluation, de validation et de test utilisateur.
- Méthode de publication, audience, status de déploiement et état du Registre applicable.
- Modifications de configuration ou de service.
- Limitations connues, option de récupération documentée ou lacune dans la procédure, et propriétaire du support.
Céder la propriété et le soutien
Avant que le propriétaire actuel ne quitte le rôle, attribuez au propriétaire suivant :
- La source, l’identité du package ou de l’agent, la version actuelle, les enregistrements de publication et la route de publication.
- Emplacements de surveillance, tests représentatifs, problèmes connus et cas de support ouverts.
- Public prévu, les contacts de l’administration, les connexions requises et les propriétaires de services externes.
- Les procédures documentées de mise à jour, de récupération et de mise hors service, y compris les lacunes.
Pour un agent partagé intégré dans Agent Builder ou Copilot Studio, utilisez Attribuer un nouveau propriétaire à un agent lorsque cette procédure s’applique. Agent Builder prend également en charge l’ajout d’un propriétaire. Examinez les effets sur l’accès de l’ancien propriétaire avant d’apporter une modification.
Il s’agit de procédures de propriété de l’agent, pas d’une procédure de transfert générale pour le package de plugins externe. Confirmez séparément l’accès source, l’accès à la publication, les connexions, les informations d’identification et les responsabilités de service. Demandez au propriétaire suivant de vérifier qu’il peut surveiller, maintenir et prendre en charge la solution.
Mettre hors service le plug-in ou l’agent
Mettez la solution hors service lorsqu’elle ne devrait plus être utilisée. Décidez si vous mettez fin à la distribution pour tous les clients ou si vous supprimez l’accès uniquement dans votre organisation ; ces étendues sont différentes.
- Identifiez les versions actives, les utilisateurs, les emplacements de publication et de partage et les dépendances partagées.
- Informez les utilisateurs et les équipes de support, en indiquant leur remplacement et la date de mise hors service.
- Arrêtez la distribution et l’accès via la route prise en charge, et supprimez les installations de l’administrateur si nécessaire.
- Demandez aux propriétaires de services de supprimer l’accès et les ressources spécifiques au plug-in tout en préservant les ressources utilisées par d’autres solutions.
- Vérifiez le résultat auprès d’un utilisateur précédemment autorisé et enregistrez les ressources conservées, les exceptions et les propriétaires.
Pour retirer un package, consultez Retirer votre plug-in. Pour un agent autonome, utilisez la procédure produit applicable, telle que Supprimer les agents. Ne présumez pas que la suppression d’un agent ou d’un package révoque toutes les connexions, autorisations ou services externes.
Contenu associé
- Surveillez votre plug-in
- Surveiller les agents dans Agent Builder
- Fonctionnalités de création ou de réutilisation pour votre plug-in
- Créer un package de votre plug-in
- Valider et tester votre plug-in
- Choisir comment publier et distribuer votre plug-in
- Rendre les plug-ins et les agents disponibles
- Régir l’accès, les outils et les connexions
- Gérer les plug-ins, les compétences et les serveurs MCP
- Mettre hors service votre plug-in