Observabilité des agents de données Fabric dans Microsoft Foundry

Vous pouvez ajouter un agent de données Fabric comme outil à un agent que vous développez dans Microsoft Foundry. Après la connexion, l’agent Foundry appelle l’agent de données Fabric pour répondre à des questions liées à vos données d’entreprise présentes dans Fabric OneLake.

Cet article porte sur l’observabilité pour cette configuration. Lorsque vous construisez un agent dans Foundry et que vous y connectez un agent de données Fabric, vous voulez voir ce que l’agent de données a fait à chaque requête, pas seulement la réponse finale. Foundry Observability vous offre cette visibilité. Les journaux et les traces de l’agent de données sont envoyés au même endroit que celui vers lequel votre agent Foundry envoie déjà ses rapports ; vous pouvez ainsi suivre une requête de bout en bout, depuis l’agent Foundry, en passant par l’agent de données Fabric, jusqu’aux sources de données qu’il a interrogées.

Le reste de cet article explique où cette télémétrie est stockée, comment elle y arrive, comment la lire, qui peut la voir, et comment la contrôler.

Pour un aperçu général, voir Observabilité en IA générative . Pour connecter un agent de données Fabric à Foundry, voir Consommer un agent de données dans Microsoft Foundry.

Projets de fonderie et analyses d’application

Un projet Foundry est l’endroit où vous construisez et gérez vos agents. Foundry stocke des traces d’agent dans une ressource Azure Monitor Application Insights, et chaque projet se connecte à une telle ressource.

En tant que créateur d’agents, configurez-le une seule fois. Dans votre projet Foundry, ouvrez la section Agents , sélectionnez Traces, puis sélectionnez Connecter. Vous pouvez créer une nouvelle ressource Application Insights ou en connecter une qui existe déjà. Après avoir connecté la ressource, Foundry active automatiquement le traçage côté serveur pour le projet. Vous n’avez pas besoin de modifier le code, et les traces commencent à circuler en quelques minutes.

La relation est simple : le projet pointe vers une ressource Application Insights, et chaque agent de ce projet y envoie ses traces. Le projet définit où la télémétrie est collectée ; Application Insights est là où il se trouve et où vous le interrogez.

Vous pouvez consulter les traces dans l’onglet Traces de votre agent Foundry, ou les interroger directement dans la ressource connexe Application Insights. Le portail de la fonderie montre des traces des 90 derniers jours.

Pour la configuration étape par étape, voir Configurer le traçage pour les agents IA dans Microsoft Foundry.

Comment les journaux et traces des agents de données Fabric atteignent votre projet

Pour connecter un agent de données Fabric à Foundry, travaillez dans un projet Foundry. Si vous connectez une ressource Application Insights à ce projet, l’agent de données Fabric envoie ses journaux et traces à cette même ressource. La télémétrie de votre agent Foundry et celle de l'agent de données Fabric se retrouvent en un seul endroit, vous pouvez donc les lire ensemble.

Le flux fonctionne ainsi :

1. Dans votre projet Foundry, connectez une ressource Application Insights, comme décrit dans la section précédente.
2. Ajoutez un agent de données Fabric comme outil à un agent Foundry dans ce projet.
3. Lorsque l’agent Foundry s’exécute, il appelle l’agent de données Fabric pour obtenir des informations issues des données d’entreprise dans Fabric OneLake.
4. Fabric valide la ressource Application Insights connectée au projet, puis envoie les journaux et traces de l'agent de données vers celle-ci.
5. La télémétrie de l’agent de données apparaît aux côtés des traces de votre agent Foundry, à la fois dans la ressource connexe Application Insights et dans la vue Traces de l’agent.

Le résultat est que le travail effectué par l’agent de données Fabric devient partie intégrante de la trace de la requête. Vous voyez que votre agent Foundry a appelé l’agent de données, et vous voyez ce que l’agent de données a fait pour produire sa réponse, y compris les sources de données qu’il a interrogées, combien de temps chaque étape a pris et si chaque étape a réussi.

Consultez les traces

Foundry Observability enregistre chaque requête sous forme de trace. Une trace est constituée de travées, et chaque travée représente une unité de travail avec son propre temps de début, sa durée et son statut. Les spans sont imbriqués, ainsi la lecture d’une trace de haut en bas montre le chemin suivi par une requête et où le temps a été consacré.

Un agent de données Fabric ajoute deux types de spans à la trace :

• Agent span : l’exécution globale de l’agent de données Fabric pour une seule requête.
• Périmètre de l’outil : une seule source de données ou un seul outil que l’agent de données sollicite pour répondre à la requête. Une seule demande peut produire plus d’une portée d’outil.

L’exemple suivant montre un agent Foundry qui appelle un agent de données Fabric, qui interroge deux sources de données pour répondre à la question :

Request (trace)
└─ Foundry agent run
   └─ Fabric data agent (called as a tool)
      └─ Agent span            Overall run of the Fabric data agent
         ├─ Tool span          First data source the data agent queried
         └─ Tool span          Second data source the data agent queried

Le tableau suivant décrit chaque niveau de la trace ainsi que le type de métadonnées qui y est attaché.

Avec cette structure, vous pouvez répondre aux questions qui comptent quand quelque chose semble anormal :

• Lorsqu’une réponse est lente, la durée de chaque travée indique quelle étape a pris le plus de temps.
• Lorsqu’une réponse est fausse, les spans de l’outil montrent quelles sources de données ont été interrogées et dans quel ordre.
• Lorsqu’une requête échoue, le statut de chaque portée indique où la défaillance a eu lieu.

Qui peut voir les logs et les traces

La ressource Application Insights qui stocke les journaux et traces de l’agent de données régit l’accès. Toute personne ayant accès à cette ressource en lecture peut voir la télémétrie. Connecter une ressource à un projet ne donne pas accès aux données qu’elle détient.

L’accès à un projet Foundry seul n’inclut pas l’accès à la télémétrie. L’autorisation de lecture sur la ressource Application Insights est toujours requise.

Configuration du locataire de métadonnées opérationnelles

Un paramètre du locataire dans le portail d’administration Fabric détermine si les agents de données de Fabric envoient des métadonnées opérationnelles à des fins d’observabilité dans Foundry. Le paramètre est activé par défaut.

Le paramètre n’envoie que des métadonnées opérationnelles. Ces métadonnées incluent les noms d’affichage des agents, les noms des sources de données, les identifiants d’étapes de raisonnement et les identifiants de conversation. Fabric n'envoie aucun contenu client. Les invites utilisateur et les réponses des agents de données restent dans les limites de conformité de Fabric et ne sont pas incluses dans cette télémétrie.

Le cadre se lit comme suit.

Les agents de données Fabric peuvent envoyer des métadonnées opérationnelles pour l’observabilité dans Microsoft Foundry

Les créateurs d’agents peuvent utiliser des métadonnées opérationnelles pour surveiller l’état de santé des agents, détecter des problèmes et comprendre comment leurs agents publiés sont utilisés dans les applications et services. Ces informations aident les créateurs d’agents à améliorer leur fiabilité et leurs performances.

Lorsque vous activez ce paramètre, les agents de données Fabric envoient des métadonnées opérationnelles à une ressource Application Insights configurée pour traitement et stockage. Ces données incluent les noms d’affichage des agents, les noms des sources de données, les identifiants d’étapes de raisonnement et les identifiants de conversation. La ressource Application Insights qui traite et stocke ces données peut se trouver en dehors de la région géographique, de la frontière de conformité ou de l’instance cloud nationale de votre locataire.

Pour accéder aux métadonnées opérationnelles, vous avez besoin d’un rôle avec des permissions de lecture (comme Monitoring Reader ou Log Analytics Reader) sur la ressource configurée Application Insights. Les utilisateurs disposant de cet accès peuvent consulter les données dans Application Insights. Les utilisateurs peuvent également consulter les données via un projet Foundry qui se connecte à la ressource configurée Application Insights. L’accès via Foundry nécessite un accès basé sur les rôles au projet Foundry (utilisateur Foundry ou supérieur) en plus des autorisations de lecture sur la ressource Application Insights. L’accès à un projet Foundry seul n’inclut pas l’accès aux données de télémétrie.

Contenu connexe

• Consommer un agent de données dans Microsoft Foundry
• Configurer le traçage des agents IA dans Microsoft Foundry
• Observabilité dans l’IA générative
• Configurer les paramètres du tenant de l’agent de données Fabric