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.
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.
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
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
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
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
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
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.
Entrez un message, y compris la balise #extensibility, dans la zone de texte.