Utiliser le mode développeur dans Microsoft 365 Copilot pour tester et déboguer des agents

Le test est une partie importante du processus de développement d’agents déclaratifs pour Microsoft 365 Copilot. Vous pouvez utiliser le mode développeur dans Copilot Studio pour tester votre agent et vérifier si et comment l’orchestrateur Copilot sélectionne vos sources de connaissances à utiliser en réponse à des invites données.

Utiliser le mode développeur dans Copilot

Pour activer le mode développeur dans Copilot, tapez -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 retourne chaque fois que l’orchestrateur effectue une recherche spécifique dans vos connaissances d’entreprise (données), fonctionnalités ou compétences (actions ou plug-ins) au sein de votre agent pour répondre à une invite. Les informations de débogage carte 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.
• 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
• Exécution : liste des fonctionnalités et actions exécutées pour l’invite
  • Fonctionnalités exécutées : statistiques de status et de réponse pour les fonctionnalités exécutées.
  • Actions exécutées : exécution des requêtes et des réponses status pour les actions.

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 :

• 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 en cours d’utilisation.
• ID de conversation : identifie la session ou la conversation de conversation active.
• ID de demande : identifie 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, définissant l’étendue de ses sources de connaissances accessibles.

Actions de l’agent

Les actions de l’agent affichent l’ID et le numéro de version de l’action, les fonctions configurées pour l’action, ainsi que leur correspondance et leur sélection status.

Carte avec aucune action activée

Si aucune action n’a été activée, la section Actions indique qu’aucune action n’est activée.

Carte avec fonctions sans correspondance

Si aucune fonction correspondante n’a été retournée pour l’invite donnée, cela indique probablement que l’invite n’a pas explicitement mention le nom de l’action.

Détails de l’exécution

Les sections des détails exécutés indiquent si et lesquelles des fonctionnalités ou actions configurées ont été exécutées pour l’invite, ainsi que les détails et les status d’exécution.

Détails de l’exécution des capacités

Les détails de l’exécution de la fonctionnalité affichent la fonctionnalité exécutée et son status. Chaque fonctionnalité peut avoir des détails d’exécution différents, tels que le texte de recherche utilisé, la réponse de la fonctionnalité et/ou le nombre de résultats retournés.

Détails de l’exécution de l’action

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.

Carte 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. Cela est probablement dû au fait 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, cela peut être une indication de limitation.

Carte avec des détails d’exécution de fonction vides ou ayant échoué

Pour les plug-ins d’extension non-message, 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.

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.

Aucun carte de débogage

Si l’orchestrateur n’a pas besoin de vos données ou compétences Microsoft 365 pour répondre à une invite, aucune information de débogage carte n’est retournée.

Les cartes de débogage ne sont pas non plus retournées en cas de limitation de capacité, où vous verrez généralement un message d’erreur pour réessayer ultérieurement.

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 balise #extensibility dans votre rapport.

Entrez un message, y compris la balise #extensibility, dans la zone de texte.

Contenu connexe

• Générer des agents avec Copilot Studio
• Générer des agents avec Visual Studio Code
• Tester et déboguer des agents dans microsoft 365 Agents Toolkit