Afficher les traces de l'agent

Avant de commencer

Avant de pouvoir afficher les traces d'agent, vous devez remplir les conditions suivantes :

  • Activer les API : assurez-vous que les API suivantes sont activées pour votre projetGoogle Cloud  :
    • API Cloud Trace
    • API Cloud Logging
    • API Telemetry
  • Configurez le traçage de l'agent : votre agent doit être configuré pour envoyer des données de trace à Google Cloud. Pour savoir comment activer le traçage pour différents types d'agents, consultez Configurer le traçage.
  • Configurer les autorisations : pour afficher les traces et les journaux, vous avez besoin de rôles IAM qui fournissent les autorisations requises, comme les rôles Utilisateur Cloud Trace (roles/cloudtrace.user) et Lecteur de journaux (roles/logging.viewer). Pour en savoir plus, consultez Contrôle des accès à Cloud Trace et Contrôle des accès à Cloud Logging.

Le traçage distribué est une technique de diagnostic qui suit la progression d'une seule requête lorsqu'elle transite par différents services et composants distribués de votre architecture. Étant donné que les agents d'IA générative utilisent des boucles de raisonnement non déterministes pour choisir dynamiquement des outils et des chemins d'exécution, les métriques ponctuelles conventionnelles sont souvent insuffisantes pour le débogage. Les traces sont essentielles pour l'observabilité des agents, car elles fournissent un calendrier complet et séquentiel de ces interactions imprévisibles, ce qui vous permet de comprendre exactement pourquoi un agent a pris une décision spécifique.

Explorer les traces

Pour accéder aux données d'exécution détaillées d'un agent :

  1. Dans la console Google Cloud , accédez à la page Plate-forme d'agents > Registre d'agents.

    Accéder au registre d'agents

  2. Sélectionnez l'agent concerné.

  3. Cliquez sur l'onglet Traces.

Cette interface vous permet d'inspecter les détails d'exécution étape par étape de votre agent. Une trace est un enregistrement factuel et immuable du comportement de l'agent, y compris les entrées du modèle, les réponses et les appels d'outils. La vue de trace inclut un graphe orienté acyclique (DAG) de ses segments, ses entrées et sorties, et ses attributs de métadonnées.

L'onglet "Traces" propose trois vues distinctes pour explorer vos données de télémétrie :

  • Vue "Session" : regroupe les exécutions par sessions utilisateur individuelles, ce qui vous permet d'analyser les conversations multitours et le comportement de l'agent au fil du temps.
  • Vue des traces : elle se concentre sur les traces de requêtes individuelles de bout en bout, qui représentent un chemin d'exécution unique.
  • Vue étendue : fournit une liste détaillée des opérations individuelles (segments) exécutées dans vos traces, comme un appel de modèle de fondation spécifique, une requête API ou l'exécution d'un outil externe.

Vue d'une trace unique (contexte de session)

Lorsque vous sélectionnez une session spécifique dans la vue Session, un volet "Détails" s'ouvre avec un panneau de liste sur la gauche affichant toutes les traces individuelles contenues dans cette session multitours. Le panneau principal regroupe l'ensemble du contexte de la session, en affichant les messages d'entrée et de l'assistant mis en forme, ainsi que les métriques globales de la session telles que la durée, le nombre total de jetons d'IA générative et les scores d'évaluation continue.

Vue d'une seule trace (trace directe ou contexte de segment)

Vous pouvez également sélectionner une trace spécifique dans la vue Trace ou un intervalle distinct dans la vue Intervalle. Le volet "Détails" s'ouvre alors directement sur cette exécution spécifique. Étant donné que vous consultez une seule opération plutôt qu'une session groupée, le panneau de liste de gauche est masqué, ce qui vous permet d'inspecter immédiatement et de manière ciblée la latence, les attributs et les erreurs potentielles de cette opération.

Stockage des données et contrôle des accès

Pour assurer la sécurité et la conformité, la plate-forme d'agents Gemini Enterprise sépare les métadonnées opérationnelles du contenu conversationnel proprement dit :

  • Métriques et attributs d'exécution : la télémétrie standard (comme la latence, les codes d'état et les métadonnées structurelles) est stockée directement dans les spans de trace.
  • Requêtes et réponses : les données potentiellement sensibles, telles que les requêtes utilisateur et les réponses du modèle, ne sont pas stockées dans les spans. Elles sont plutôt routées vers Cloud Logging ou Cloud Storage, selon la configuration de votre organisation. Les administrateurs peuvent ainsi implémenter des contrôles Identity and Access Management (IAM) précis sur les données conversationnelles sensibles.

L'UI de la plate-forme Gemini Enterprise Agent comprend automatiquement la corrélation sous-jacente entre vos étendues de trace et ces journaux de requêtes et de réponses stockés de manière sécurisée. Lorsque vous ouvrez une vue détaillée de trace, la plate-forme reconstitue ces données de manière fluide, en présentant une vue unifiée du comportement de l'agent sans compromettre vos règles de gouvernance des données.

Pour en savoir plus sur la configuration des destinations de stockage pour les données conversationnelles, consultez Collecter et afficher les requêtes et réponses multimodales.

Étapes suivantes