Télémétrie au niveau de l’agent avec Application Insights

Cet article explique comment capturer les données de télémétrie à l’échelle de l’agent à partir de votre agent Copilot Studio utilisant le harnais standard, en vue de leur utilisation dans Azure Application Insights.

Connecter votre agent Copilot Studio à Application Insights

Pour connecter votre agent à Application Insights, ajoutez d’abord votre clé d’instrumentation à la configuration de votre agent.

1. Accédez à la page Paramètres pour votre agent et sélectionnez Avancé.

2. Dans la section Application Insights , entrez la chaîne de connexion. Pour savoir comment localiser votre chaîne de connexion, consultez la documentation Azure Monitor.

3. Sinon, vous pouvez aussi choisir d’activer l’un des paramètres suivants.

   • Activer la journalisation : s’il est activé, le système enregistre les détails des messages et événements entrants et sortants.

   • Journaliser les détails de la conversation: comprend l’ID utilisateur, le nom d’utilisateur et le texte du message (pour les activités Message). Lorsque le traçage OpenTelemetry est activé, ce paramètre contrôle également les arguments d’entrée de l’outil et les résultats de sortie de l’outil capturés dans les spans.

   • Consigner les propriétés d’activité sensibles : Si cette option est activée, les journaux incluent les valeurs de certaines propriétés qui peuvent être considérées comme sensibles dans les messages et événements entrants et sortants.

   • Événements d’exécution de nœud : journaliser un événement chaque fois qu’un nœud dans une rubrique est exécuté.

Analyser les données de télémétrie du bot à l’aide d’Application Insights

Après avoir connecté votre agent à Application Insights, il enregistre les données de télémétrie lorsque les utilisateurs interagissent avec l’agent, y compris lors des tests dans Copilot Studio. Pour consulter les données de télémétrie enregistrées, rendez-vous dans la section Journaux de votre ressource Application Insights sur Azure. Ici, vous pouvez utiliser les requêtes Kusto pour interroger et analyser vos données. En savoir plus dans les exemples de requêtes.

Exemples de requêtes

Une requête peut être aussi simple que la spécification d’une table unique, telle que customEvents, qui affiche tous les événements de télémétrie personnalisés enregistrés à partir de Copilot Studio. Toutefois, vous pouvez également utiliser des requêtes Kusto pour affiner vos résultats, notamment :

• Ajout d’un intervalle de temps
• Étendre vos résultats à l’aide de dimensions personnalisées. Les dimensions personnalisées sont des propriétés personnalisées que vous journalisez avec les champs prédéfinis, tels que l’horodatage ou le nom de l’événement
• Ajout d’une clause where pour limiter les données retournées en fonction d’une condition
• Utiliser davantage de fonctions Kusto intégrées pour déterminer la nature et l’affichage des informations

L’exemple de requête suivant génère un graphique en courbes qui indique le nombre d’utilisateurs distincts communiqués avec votre bot par jour au cours des 14 derniers jours.

let queryStartDate = ago(14d);
let queryEndDate = now();
let groupByInterval = 1d;
customEvents
| where timestamp > queryStartDate
| where timestamp < queryEndDate
| summarize uc=dcount(user_Id) by bin(timestamp, groupByInterval)
| render timechart

Exclure la télémétrie des conversations de test dans vos requêtes

Votre bot journalise les données de télémétrie pour toutes les conversations, y compris celles qui se produisent dans Copilot Studio pendant les tests. Si vous souhaitez exclure les données de télémétrie collectées pendant le test, étendez votre requête à l’aide de la designMode dimension personnalisée que tous les événements capturent et utilisez une clause where dans votre requête.

L’exemple suivant montre tous les événements personnalisés, à l’exception de ceux capturés via le canevas de test.

customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"

Dimensions personnalisées

La plupart des données d’activité spécifiques reçues de Copilot Studio sont stockées dans le champ customDimensions. Vous pouvez voir un champ de dimension personnalisé utilisé dans une requête pour exclure la télémétrie des conversations de test.

Voir les résultats de suivi (aperçu)

La vue de tableau de bord Copilot Studio utilise des signaux provenant de Azure Monitor Application Insights. Il interroge Application Insights via des classeurs Azure et crée des visualisations.

Ces vues apportent des métriques clés, telles que le nombre total de conversations, la latence, les exceptions, l’utilisation des outils et l’analytique des rubriques, dans une vue unique. La vue unique fournit aux équipes une transparence afin qu’elles puissent suivre la santé opérationnelle et la qualité, comprendre les tendances et évaluer en continu pour améliorer leur application.

Pour accéder à la vue de supervision intégrée dans Application Insights et l’utiliser, procédez comme suit :

1. Accédez à votre ressource Application Insights.
2. Sélectionnez l’onglet Surveillance dans le volet de navigation gauche.
3. Sous l’onglet Surveillance, sélectionnez Classeurs. Ouvrez Tableau de bord Copilot Studio à partir de la galerie de classeurs.

Personnaliser et partager votre tableau de bord

Application Insights est un outil puissant pour l’analyse des performances des applications (APM) qui fournit des insights sur l’intégrité et les performances de vos applications.

Le tableau de bord s’ouvre en tant que classeur modifiable dans lequel vous pouvez personnaliser le classeur et l’enregistrer en fonction de vos besoins.

1. Sélectionnez Modifier dans la barre de commandes.

   

2. Modifiez les éléments en fonction des besoins de votre cas d’usage. Sélectionnez les trois points (...) pour qu’un élément puisse l’éditer, l’ajouter, déplacer ou le redimensionner, le cloner ou le retirer. Par exemple, vous pouvez ajouter une vignette qui utilise KQL pour suivre un attribut personnalisé que vous collectez et que la vue intégrée ne présente pas.

   

3. Sélectionnez Enregistrer pour enregistrer vos dernières modifications et créer des vues différentes en fonction des besoins.

   

4. Sélectionnez l’icône Partager dans la barre de commandes à partager avec votre équipe.

   Note

   Lorsque vous partagez ce classeur avec les membres de votre équipe, ils doivent avoir au moins le rôle Lecteur pour la ressource Application Insights connectée pour afficher les informations affichées.

   

Désactiver la télémétrie Application Insights au niveau de l’agent

Pour empêcher les créateurs d’activer la télémétrie Application Insights au niveau de l’assistant, bloquez le connecteur Application Insights dans Copilot Studio au moyen d’une stratégie de données dans le centre d’administration Power Platform.

Avant de commencer, assurez-vous d’avoir :

• Administrateur Power Platform ou administrateur Dynamics 365 au niveau locataire dans Microsoft Entra ID.
• Accès à l’environnement ciblé où les agents de Copilot Studio sont déployés.

Pour désactiver la télémétrie Application Insights au niveau de l’agent, suivez ces étapes :

1. Dans le centre d’administration Power Platform, sélectionnez Sécurité dans le panneau de gauche, sélectionnez Données et confidentialité, puis politique de données.
2. Créer une nouvelle politique de données ou modifier une politique existante.
3. Sélectionnez les environnements auxquels la politique doit s’appliquer et sélectionnez Ajouter à la politique.
4. Dans l’étape Connecteurs (nouvelle politique) ou Connecteurs préconstruits (politique existante), recherchez Application Insights dans Copilot Studio et sélectionnez-le.
5. Sélectionnez Bloc pour déplacer Application Insights dans Copilot Studio vers le groupe Connecteurs Bloqués.
6. Complétez les étapes restantes de configuration de la politique et publiez la politique.

Lorsque la politique de données est appliquée, le connecteur Application Insights dans Copilot Studio est bloqué pour les environnements ciblés. Les utilisateurs et les créateurs ne peuvent pas utiliser ce connecteur dans les environnements régis par la politique.

Informations connexes

• Aperçu de la télémétrie avec Application Insights
• Télémétrie au niveau de l’environnement avec Application Insights (aperçu)
• Exporter les données vers Application Insights