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.
Le test est une partie importante du processus de développement d’agents déclaratifs pour Microsoft 365 Copilot Chat. Vous pouvez utiliser le mode développeur lors du test de votre agent pour vérifier si et comment l’orchestrateur Copilot sélectionne vos sources de connaissances à utiliser en réponse à des invites données.
En outre, vous pouvez utiliser la fonctionnalité Aperçu de votre application (F5) dans microsoft 365 Agents Toolkit pour tester vos agents dans un environnement de développement local. Cette fonctionnalité offre un moyen interactif de valider le comportement et de résoudre les problèmes directement à partir de l’interface de développement.
Utiliser le mode développeur dans Copilot Chat et agents Toolkit
Vous pouvez tester votre agent à partir du Kit de ressources Agents dans Visual Studio Code en sélectionnant Afficher un aperçu de votre application (F5) dans le volet Agents Toolkit. Cela lance votre agent dans une expérience de Copilot Chat basée sur un navigateur, ce qui vous permet de valider rapidement son comportement en réponse aux invites.
Une fois que vous avez sélectionné votre agent dans Microsoft 365 Copilot Chat, activez le mode développeur en tapant -developer on. Pour désactiver le mode développeur, tapez -developer off.
Lorsque le mode développeur est activé, un carte avec des informations de débogage est retourné chaque fois que l’orchestrateur effectue une recherche dans vos connaissances (données), fonctionnalités ou compétences (actions ou plug-ins) au sein de votre agent. Dans agent Toolkit, ces informations de débogage s’affichent dans le panneau Débogage et incluent les champs suivants :
- Métadonnées de l’agent : identificateurs de l’agent et de la conversation
- Fonctionnalités : liste des fonctionnalités configurées pour l’agent, ainsi que leurs statistiques d’exécution status et de réponse (si elles sont exécutées)
-
Actions : liste des actions configurées pour l’agent
- Fonctions mises en correspondance : status de fonctions mises en correspondance dans la recherche de l’index de l’application runtime
- Fonctions sélectionnées pour l’exécution : status de fonctions sélectionnées pour l’appel basé sur le raisonnement de l’orchestrateur
Section métadonnées de l’agent
Les métadonnées de l’agent fournissent des détails clés sur l’agent et la session de débogage actuelle, notamment :
- Résumé : vue d’ensemble des sources de connaissances configurées et de leurs statistiques d’utilisation
- ID de l’agent : identificateur unique de l’agent, qui inclut l’ID de titre et l’ID de manifeste
- Version de l’agent : numéro de version de l’agent actuellement utilisé
- ID de conversation : identificateur de la session de conversation ou de la conversation active
- ID de la demande : identificateur de l’invite spécifique dans la conversation
Fonctionnalités de l’agent
La section Fonctionnalités de l’agent affiche les fonctionnalités configurées pour l’agent, en définissant l’étendue de ses sources de connaissances accessibles. Les détails suivants sont fournis pour chaque fonctionnalité utilisée par l’invite.
- Exécution status : indique si la fonctionnalité a été utilisée pendant l’orchestration
- Fichier journal de diagnostic : fichier .txt téléchargeable contenant des résultats d’exécution détaillés, y compris des messages de réussite ou d’échec, qui peut vous aider à résoudre les problèmes et à valider
Actions de l’agent
La section Actions de l’agent fournit des informations détaillées sur la façon dont les actions de votre agent (fonctions ou plug-ins) sont traitées pendant l’orchestration. Ces informations sont réparties en trois domaines clés : les métadonnées d’action, la correspondance et la sélection des fonctions, et les détails de l’exécution.
Métadonnées d’action
Cette section affiche des informations générales sur les actions inscrites pour votre agent. Ces informations incluent l’ID d’action (identificateur unique de l’action) et le numéro de version (version de la définition d’action utilisée).
Correspondance et sélection des fonctions
Cette partie montre comment l’orchestrateur a interprété l’invite de l’utilisateur et si des fonctions ont été considérées comme pertinentes pour l’exécution :
Fonctions mises en correspondance : fonctions qui correspondent sémantiquement à l’invite de l’utilisateur pendant la recherche d’index de l’application runtime. Si aucune fonction correspondante n’a été retournée pour l’invite donnée, il est probable que l’invite n’a pas mention explicitement le nom de l’action.
Fonctions sélectionnées pour l’exécution : fonctions choisies pour l’appel en fonction du raisonnement de l’orchestrateur et de la pertinence par rapport à l’invite. Si aucune action n’a été activée, la section Actions indique qu’aucune action n’est activée.
Détails de l’exécution
Les détails de l’exécution de l’action incluent la fonction et ses status, ainsi que la latence, les informations de requête (point de terminaison de la requête, méthode HTTP, en-têtes de requête) et la réponse.
Résoudre les problèmes d’échec
Voici les défaillances courantes que vous pouvez rencontrer lorsque vous déboguez votre agent et les causes possibles des échecs.
Aucune information de débogage
Après avoir lancé votre agent, case activée que la connexion au navigateur est marquée comme réussie dans le panneau de débogage. Si ce n’est pas le cas, réessayez d’exécuter F5 dans Visual Studio Code pour démarrer une nouvelle session.
Si la connexion réussit mais que vous ne voyez pas d’informations de débogage, cela peut être dû au fait que l’orchestrateur n’a pas besoin de vos données ou compétences Microsoft 365 pour répondre. Aucune information de débogage carte n’est retournée dans ce cas.
Les informations de débogage ne sont pas non plus retournées en cas de limitation de capacité, où vous voyez généralement un message d’erreur pour réessayer ultérieurement.
Informations de débogage avec Aucune fonction sélectionnée pour l’exécution
Si aucune fonction d’action ne correspond à l’intention de recherche de l’invite, les informations de débogage carte indiquent Aucune fonction sélectionnée pour l’exécution. La cause est probablement que la description de la commande dans le manifeste n’est pas sémantiquement liée à l’intention de recherche de l’invite donnée.
Si Copilot a précédemment mis en correspondance et exécuté vos fonctions avec succès, les requêtes peuvent être limitées.
Informations de débogage avec les détails de l’exécution de fonction vides ou ayant échoué
Pour les plug-ins d’API, s’il n’y a pas de détails d’exécution de fonction ou d’échec, cela indique un échec lors de la tentative de votre agent d’attribuer des paramètres à la fonction sélectionnée de votre plug-in. Si l’échec est cohérent, cela est probablement dû à des descriptions d’actions ou de paramètres peu claires, à des URL d’hôte non valides ou à d’autres problèmes liés à votre définition d’API Open.
Pour les plug-ins d’extension de message, la meilleure pratique consiste à optimiser les réponses en moins de neuf secondes. Pour plus d’informations, consultez la configuration technique requise pour les plug-ins d’extension de message.
Actuellement, la limite de délai d’expiration pour l’exécution copilot d’une API de plug-in est définie à 10 secondes.
Signalement d’un problème
Signalez des commentaires ou des problèmes avec votre agent à l’aide du bouton pouce vers le haut ou vers le bas. Incluez la #extensibility balise dans votre rapport.
