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

Les tests constituent 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.

Capture d’écran de la session Microsoft 365 Copilot dans laquelle l’utilisateur a tapé « -développeur activé » pour activer correctement le mode développeur

Lorsque le mode développeur est activé, une carte contenant des informations de débogage est renvoyée chaque fois que l’orchestrateur effectue une recherche spécifique dans les connaissances de votre entreprise (données), les capacités ou les compétences (actions ou plug-ins) au sein de votre agent pour répondre à une invite. La carte d’informations de débogage comprend les champs suivants :

  • Métadonnées de l’agent : identificateurs pour l’agent et la conversation.
  • Fonctionnalités : liste des fonctionnalités configurées pour l’agent.
  • Actions : liste des actions configurées pour l’agent
    • Fonctions correspondantes : status des fonctions mises en correspondance dans la recherche d’index d’application runtime
    • Fonctions sélectionnées pour l’exécution : status des fonctions sélectionnées pour l’appel en fonction du raisonnement de l’orchestrateur
  • Exécution : liste des fonctionnalités et actions exécutées pour l’invite
    • Capacités exécutées : statistiques de status et de réponse pour les fonctionnalités exécutées.
    • Actions exécutées : status d’exécution de la requête et de la réponse pour les actions.

Section des métadonnées de l’agent

Capture d’écran de la session Microsoft 365 Copilot dans laquelle Copilot a renvoyé une carte avec des informations de débogage montrant les 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 en cours, notamment :

  • ID d’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 : identifie la session de conversation ou la conversation active.
  • ID de demande : identifie l’invite spécifique dans la conversation.

Remarque

Le préfixe dans l’ID d’agent indique comment l’agent est distribué :

  • U_ Indique un agent à l’échelle de l’utilisateur (chargement indépendant).
  • T_ Indique un agent à l’étendue du client (publié dans le magasin client ou le catalogue de l’organisation).
  • P_ indique un agent accessible au public.

Pour obtenir des conseils de publication connexes, consultez :

Fonctionnalités de l’agent

Capture d’écran de la session Microsoft 365 Copilot dans laquelle Copilot a renvoyé une carte avec des informations de débogage montrant les fonctionnalités de l’agent configurées

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.

Important

Si la section Fonctionnalités de l’agent indique que WebSearch est activé, cela signifie uniquement que l’agent a activé la fonctionnalité. Il ne reflète pas le paramètre de stratégie cloud que les administrateurs peuvent utiliser pour désactiver la Allow web search in Copilot recherche web pour leur organisation. Pour plus d’informations, consultez Gérer les scénarios Microsoft 365 Copilot dans le Centre d’administration Microsoft 365.

Actions de l’agent

Capture d’écran de la session Microsoft 365 Copilot dans laquelle Copilot a renvoyé une carte avec des informations de débogage montrant les actions de l’agent configurées

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

Carte pour laquelle aucune action n’est activée

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

Carte sans fonction correspondante

Si aucune fonction correspondante n’a été renvoyée pour l’invite donnée, cela signifie 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 le status d’exécution.

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

Capture d’écran de la session Microsoft 365 Copilot dans laquelle Copilot a renvoyé une carte avec des informations de débogage montrant les fonctionnalités exécutées

Les détails de l’exécution de la capacité affichent la capacité 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 capacité et/ou le nombre de résultats retournés.

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

Capture d’écran de la session Microsoft 365 Copilot dans laquelle Copilot a renvoyé une carte avec des informations de débogage montrant les actions exécutées

Les détails de l’exécution de l’action comprennent la fonction et son état, ainsi que la latence, les informations de la 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, la carte d’informations de débogage signale qu’aucune fonction n’est 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 déjà mis en correspondance et exécuté vos fonctions avec succès, cela peut être une indication de limitation.

Carte vide ou ayant échoué Aucun détail de l’exécution de la fonction

Pour les plugins d’extension non liés aux messages, s’il y a un échec ou s’il n’y a pas de détails d’exécution de fonction, cela indique un échec lors de la tentative de votre agent d’assigner des paramètres à la fonction sélectionnée de votre plugin. Si l’échec est constant, il est probablement dû à des descriptions d’action ou de paramètres peu claires, à des URL d’hôte non valides ou à d’autres problèmes liés à la définition de votre API ouverte.

Pour les plug-ins d’extension de message, la meilleure pratique consiste à optimiser les réponses en dessous de neuf secondes. Pour plus d’informations, consultez les exigences techniques relatives aux plug-ins d’extension de message.

Actuellement, le délai d’expiration pour l’exécution par Copilot d’une API de plug-in est fixé à 10 secondes.

Résoudre les échecs

Voici les échecs courants que vous pouvez rencontrer lorsque vous déboguez votre agent et les causes possibles de ces échecs.

Aucune 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 carte d’information de débogage n’est renvoyée.

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

Signalement d’un problème

Signalez tout commentaire ou problème avec votre agent en utilisant le bouton pouce vers le haut ou pouce vers le bas. Inclure la balise #extensibility dans votre rapport.

Capture d’écran des options de commentaires pouce vers Microsoft 365 Copilot le haut ou pouce vers le bas

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

Capture d’écran des commentaires de Microsoft 365 Copilot dans la zone de texte