Utilisez la trace d’activité pour déboguer votre agent

La traçabilité d’activité dans les agents alimentée par le faisceau GitHub Copilot dans Microsoft Copilot Studio vous montre exactement comment votre agent traite chaque message. Utilisez-la pour comprendre le raisonnement en chaîne de votre assistant, vérifier l’attribution de la source de connaissances, confirmer l’exécution des outils et résoudre les erreurs.

Note

Les fonctionnalités de cet article sont alimentées par le faisceau GitHub Copilot, qui utilise les crédits Copilot pour la facturation basée sur l’utilisation. En savoir plus sur les crédits Copilot dans Aperçu de la facturation pour les agents, propulsés par le harnais GitHub Copilot.

La facturation basée sur l’utilisation s’applique à l’utilisation, à la construction, aux tests et à l’évaluation des agents. Ces actions peuvent consommer des crédits Copilot.

Prerequisites

  • Un agent créé avec le harnais GitHub Copilot
  • Au moins une conversation de test dans l’onglet Version préliminaire

Ouvrez la trace d’activité

  1. Ouvrez votre assistant dans Copilot Studio et sélectionnez l’onglet Aperçu.

  2. Assurez-vous que la bascule Version préliminaire de l’utilisateur final est désactivé (la vue par défaut du créateur). La trace d’activité apparaît à côté du volet de conversation instantanée, affichant les détails de traitement pour chaque message.

  3. Envoyez un message à votre assistant. La trace se met à jour en temps réel au fur et à mesure que l’assistant traite le message.

Comprendre la trace

La trace d’activité affiche une vue en chaîne de pensée (CoT) du traitement de votre assistant. Chaque étape de la trace apparaît comme un nœud qui montre ce que l’assistant a fait et pourquoi.

Types de nœuds

La trace peut inclure les types de nœuds suivants :

Type de nœud Ce qu’il montre
Message utilisateur Le message que vous avez envoyé à l’assistant
Réponse de l’assistant Réponse générée par l’assistant
Base de connaissances Une source de connaissances que l’assistant a consultée pour étayer sa réponse. Affiché sous forme de carte pliable « Connaissance recherchée » montrant les sources pour chaque source de connaissances consultée, ainsi que les liens de citation lorsque disponibles.
Action exécutée Un appel de connecteur ou d’outil d’appel affiché sous forme de carte pliable montrant le connecteur, les paramètres d’entrée remplis et la durée de livraison
Tool Un outil que l’assistant a appelé pour effectuer une action ou récupérer des données
Connecteur Un connecteur que l’assistant a utilisé pour accéder à des données externes
Flux Un flux d’assistant déclenché
Compétence Une compétence qui a été exécutée
Error Une erreur s’est produite lors traitement
Terminé Un indicateur de coche vert s’affiche en bas de la trace lorsque tous les appels d’outils sont terminés

Afficher les détails du nœud

  1. Sélectionnez tout nœud dans la trace pour afficher ses détails.

  2. Vérifiez les informations affichées, qui peuvent comprendre :

    • L’entrée envoyée par l’assistant à l’étape
    • La sortie ou le résultat retourné
    • Temps de traitement et métriques
    • Détails de l’erreur si l’étape a échoué

Déboguer les problèmes de source de connaissances

Lorsque votre assistant utilise des connaissances pour répondre à une question, la trace indique quelles sources ont été consultées :

  1. Trouvez le nœud Connaissance dans la trace.

  2. Vérifiez la source pour voir quelles sources de connaissances ont été consultées.

  3. Sélectionnez une source pour voir le contenu spécifique récupéré.

  4. Vérifiez que l’assistant a utilisé la bonne source et que le contenu récupéré est pertinent.

Si l’assistant a utilisé la mauvaise source ou fourni des informations erronées, vérifiez la configuration de vos connaissances dans l’onglet Générer.

Exécution de l’outil de débogage

Lorsque votre assistant appelle un outil, la trace affiche les détails d’exécution :

  1. Trouvez le nœud Outil, Connecteur, Flux, ou Compétence dans la trace.

  2. Vérifiez les détails d’exécution, y compris les paramètres d’entrée et les résultats de sortie.

  3. Vérifiez que l’outil correct a été invoqué et que les résultats sont conformes aux attentes.

  4. Si une exécution d’outil a échoué, vérifiez les détails de l’erreur dans le nœud.

Pour reconfigurer un outil, ouvrez l’onglet Générer et localisez l’outil dans la configuration de votre assistant.

Résoudre les erreurs

Lorsque des erreurs surviennent pendant le traitement, la trace les met en évidence :

  1. Cherchez des nœuds marqués par un indicateur d’erreur dans la trace.

  2. Sélectionnez le nœud d’erreur pour consulter les détails de l’erreur, y compris le message d’erreur et le contexte.

  3. Les problèmes courants sont les suivants :

    • Défaillances d’authentification pour les outils ou connecteurs
    • Erreurs d’accès à la source de connaissances
    • Erreurs de dépassement de délai pour les appels d’outils de longue durée
    • Indicateurs de modération du contenu

  4. Traitez la cause racine dans l’onglet Générer ou Paramètres, puis testez à nouveau.

La trace d’activité s’intègre à l’onglet Générer pour une édition rapide.

  1. Sélectionnez n’importe quelle source, outil ou composant dans la trace.

  2. Copilot Studio navigue vers le composant correspondant dans l’onglet Générer.

  3. Effectuez vos modifications et retournez dans l’onglet Aperçu pour retester.

  • Last updated on