Examiner l’activité de l’agent

La création d’un agent est un processus itératif. Il implique de comprendre le fonctionnement de vos agents, d’apporter des modifications et de voir les résultats. Ce processus vous aide à créer de meilleurs agents. Le suivi des activités de Copilot Studio fournit un mappage visuel de la séquence d’entrées, de décisions et de sorties de vos agents dans une activité afin de trouver des problèmes et des opportunités d’amélioration.

Un mappage d’activité est généré pour chaque activité. Une activité commence lorsqu’un agent démarre une conversation ou qu’un événement externe déclenche un agent. Une carte représente chaque activité avec un nœud.

Il existe deux formes de suivi des activités :

• Carte d’activités en temps réel des performances de votre assistant pendant les tests
• Cartes d'activités historiques et transcriptions d'activités passées

Carte d’activité en temps réel pendant les tests

Lorsque vous posez une question à votre agent dans le volet de test, la carte d’activités affiche une représentation visuelle du plan généré par l’agent. La carte met en surbrillance les erreurs, telles que les paramètres d’entrée ou de sortie manquants ou non valides pour les actions, et indique la durée d’exécution de chaque étape. Vous pouvez également vérifier que les informations que votre agent envoie ou reçoit sont correctes.

Pour que la carte d’activité apparaisse automatiquement lorsque vous envoyez une requête à votre agent dans le panneau de test, sélectionnez les trois points (...) puis activez Afficher la carte d’activité lors du test.

Ici, l'utilisateur a demandé : « Quel temps fera-t-il à Toronto, Canada, demain ? » Vous pouvez voir l'action que l'agent a sélectionnée pour répondre, ainsi que les entrées et sorties.

Déclencheurs d’événements de test

Lorsque vous testez des déclencheurs d’événement, la conversation de test affiche la charge utile du déclencheur en tant que message. Seul ce message s’affiche dans Copilot Studio à des fins de test. Les utilisateurs de votre agent ne le peuvent pas voir. Utilisez les messages de charge utile pour comprendre quand et quelles informations et instructions un déclencheur envoie à votre agent.

Parcourir entre les rubriques

Lorsque vous testez votre assistant, vous pouvez effectuer le suivi des rubriques. Lorsque vous activez le suivi, la carte d'activités affiche les nœuds de la rubrique lorsqu'ils sont exécutés en tant que partie d'un plan où une rubrique s'active. Vous pouvez surveiller le flux de conversation.

Afficher les variables

Dans la page Activité , vous pouvez afficher les variables utilisées par votre agent pendant les tests ou dans les activités historiques. Ces variables peuvent être globales, environnementales ou système auxquelles l’agent a accès.

Pour afficher les variables utilisées pendant une activité :

1. Accédez à la page Activité . Une liste d’activités s’affiche.
2. Pour afficher les variables pendant le test, sélectionnez Tester et sélectionner Variables. Le volet Variables s’ouvre pour afficher les variables utilisées lors du test.
3. Pour afficher les variables d’une activité historique, sélectionnez une activité dans la liste. Ensuite, sélectionnez Variables. Le volet Variables s’ouvre et affiche les variables utilisées pendant cette activité.

Afficher la chaîne de réflexion de l’agent dans la conversation de test

La fonctionnalité Chaîne de pensée (CoT) fournit des insights sur le processus de raisonnement de votre agent pendant les tests. Il affiche les étapes intermédiaires, les considérations et les décisions prises par l’agent au fur et à mesure qu’il traite les entrées et génère des sorties. Cette fonctionnalité est utile pour comprendre les interactions complexes et le comportement de l’agent de débogage.

Pour afficher la chaîne de pensée ou de raisonnement de l’agent pendant les tests, procédez comme suit :

1. Ouvrez votre agent dans Copilot Studio. La page Vue d’ensemble s’affiche.
2. Sélectionnez Test pour ouvrir le volet de test.
3. Dans le volet de test, démarrez une conversation avec votre agent en entrant une requête ou une invite.
4. Avant que l’agent ne réponde, le raisonnement apparaît dans le volet de test, affichant la chaîne de pensée pour la réponse de l’agent.

Activité historique

Chaque fois qu’un agent démarre une activité, y compris les tests que vous lancez dans Copilot Studio, la page Activité enregistre l’activité en temps réel. Accédez à la page Activité pour :

• Passez en revue les interactions et les décisions prises par votre agent pendant une activité.
• Recherchez où le comportement de l’agent ne correspond pas à vos objectifs.
• Découvrez combien de temps votre agent prend pour terminer chaque activité.
• Trouvez les détails de l’erreur.

L’activité de l’assistant historique est disponible pour :

• Interactions dans Copilot Studio test chat
• Agents publiés sur les canaux Microsoft Teams et Microsoft 365 Copilot
• Agents publiés sur le canal SharePoint
• Activités qui ont commencé avec un déclencheur autonome

Passez en revue les informations suivantes sur la page Activité :

• Liste des activités et de leurs détails.
• La conversation étape par étape qui a lieu dans une activité.

Liste d’activités

Une activité est une unité d’interaction de l’agent qui implique une conversation avec un utilisateur, l’inscription et la réponse à des événements, ou une combinaison de ces activités.

Dans la liste des activités, vous pouvez voir :

• Nom : nom de l’utilisateur qui interagit avec l’assistant. Si l’activité n’implique pas d’utilisateur, par exemple lorsqu’un agent effectue des actions sans invite humaine, l’utilisateur apparaît comme automatisé.
• Canaux : canal où l’interaction a eu lieu. Les activités qui se produisent dans le volet de test de l’agent ont l’icône Copilot Studio.
• Date : date à laquelle commence la première interaction de l’activité.
• Étapes terminées : nombre d’étapes terminées par l’agent pendant l’activité.
• Dernière étape : la dernière étape terminée dans l’activité.
• État : état de l’activité (réussite, échec, en cours).

Personnaliser la vue de la table d’activité

Vous pouvez personnaliser la vue de la table d’activité pour vous concentrer sur les informations les plus pertinentes.

Personnaliser la vue de la table d’activité :

1. Accédez à la page Activité de votre assistant. Une liste d’activités s’affiche.
2. Sélectionnez Modifier les colonnes. Le volet Modifier les colonnes s’affiche avec une liste de colonnes disponibles.
3. Dans le volet Modifier les colonnes :
   • Cochez la case en regard du nom des colonnes à afficher.
   • Désactivez la case en regard du nom des colonnes à masquer.
   • Faites glisser et déposez les colonnes dans votre séquence préférée ou utilisez les flèches haut et bas.
4. Sélectionnez Enregistrer pour confirmer et mettre à jour la vue de la table d’activité.

Afficher la conversation dans une activité

Dans la page Activité , vous pouvez afficher la conversation au sein d’une activité dans une carte d’activité visuelle ou à la fois une transcription de conversation et une carte d’activité visuelle. Par défaut, la vue Transcription + Carte s’affiche.

1. Pour afficher une conversation dans une activité, sélectionnez une activité.

   • Pour afficher la transcription et la carte d´activité simultanément, sélectionnez Afficher, puis sélectionnez la vue Transcription + Carte.
   • Pour afficher uniquement la carte d´activité, sélectionnez Vue, puis sélectionnez la vue Carte.

   

2. Pour revenir à la liste d’activités, sélectionnez l’icône Précédent .

La vue Transcription + Carte affiche la conversation qui a eu lieu avec l’agent pendant une activité, ainsi que la carte d’activité visuelle. La transcription enregistre l’entrée utilisateur, les charges utiles de déclencheur et les réponses de l’agent. Utilisez les transcriptions pour voir comment votre agent répond aux conversations avec les utilisateurs. Vous pouvez également voir les messages de la charge utile du déclencheur que votre assistant reçoit des déclencheurs d’événements.

Voir la chaîne de pensée de l’agent

La fonctionnalité Chaîne de pensée (CoT) fournit des insights sur le processus de raisonnement de votre agent pendant une activité. Il affiche les étapes intermédiaires, les considérations et les décisions prises par l’agent au fur et à mesure qu’il traite les entrées et génère des sorties. Cette fonctionnalité est utile pour comprendre les interactions complexes et le comportement de l’agent de débogage. Vous pouvez afficher la chaîne de pensée de l’agent pour une activité spécifique uniquement dans la vue Carte.

Pour voir la chaîne de pensée ou de raisonnement de l’agent pour une activité spécifique :

1. Sous l’onglet Activité , sélectionnez l’activité que vous souhaitez examiner. Par défaut, la vue Transcription + Carte s’affiche.
2. Sous la carte d’activité, sélectionnez le Raisonnement chevron. La chaîne de pensée de l’agent apparaît.

Épingler ou désépiner l’activité

Dans la page Activité , vous pouvez épingler des activités importantes en haut de la liste d’activités pour faciliter l’accès ou les détacher lorsqu’elles ne sont plus nécessaires.

• Pour épingler une activité, passez le curseur sur l'activité et sélectionnez l'icône Épingler située à côté du nom.
• Pour désépingler une activité, survolez l’activité épinglée et sélectionnez l’icône Désépingler à côté du nom.

Afficher toute l’activité de l’agent dans la carte d’activité

La Vue carte est une représentation visuelle du flux d’entrées, de décisions et de réactions qui se produisent pendant une activité. Chaque activité effectuée par votre agent, un utilisateur ou un déclencheur avec un nœud. Lors de l’affichage de la carte d’activité, sélectionnez un nœud pour afficher des détails sur les entrées, les décisions et les sorties de cette activité.

L’image suivante est un exemple de ce que vous voyez lorsque vous sélectionnez un nœud de connaissances. Elle montre :

• La requête utilisée par l'agent pour rechercher les sources de connaissances. Il peut être différent de la requête écrite par un utilisateur ou de l’entrée fournie par un déclencheur.
• Réponse de l’assistant créée en fonction des sources de connaissance.
• Sources référencées par l’assistant.
• D’autres sources que l’agent a recherchées, mais n’a pas utilisées pour créer la réponse. L’assistant a recherché ces sources, mais n’a pas trouvé d’informations pertinentes pour la requête.

Dans cet exemple, vous pouvez voir les détails d’un nœud d’action pour Obtenir la prévision demain montrant les entrées et sorties :

Sélectionnez Modifier pour afficher et modifier la configuration associée à l’activité sélectionnée.

Justification

Justification fournit une explication de la façon dont un agent a décidé d’utiliser un outil particulier. L’IA génère la logique à la demande et est basée sur les métadonnées et l’activité de l’agent. Le raisonnement s’affiche pour les sources de connaissances ou les connecteurs terminés. Sélectionnez Afficher la justification pour afficher la justification.

Lorsque vous passez en revue l’activité de l’agent, utilisez la logique pour mieux comprendre pourquoi un agent a choisi d’appeler un outil particulier ou de remplir des paramètres. Cela est utile pour résoudre les problèmes de comportement de l’agent. Toutefois, étant donné que la justification est générée avec l’IA, elle peut ne pas être exacte, donc utilisez votre meilleur jugement lors de l’examen de la justification fournie.

Statut de l’agent

Le tableau suivant fournit des informations sur les différents états qu’un agent peut rencontrer pendant son opération :

Envoyer des commentaires

Si vous avez des suggestions sur la façon d’améliorer la qualité de votre agent, envoyez vos commentaires à l’aide de l’icône Commentaires sous l’onglet Activité .