Afficher les traces de l'agent

Avant de commencer

Avant de pouvoir afficher les traces d'agent, vous devez répondre aux exigences suivantes :

  • Activer les API : assurez-vous que les API suivantes sont activées pour votre Google Cloud projet
      :
    • API Cloud Trace
    • API Cloud Logging
    • API Telemetry
  • Configurer le traçage de l'agent : votre agent doit être configuré pour envoyer des données de trace à. Google CloudPour 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, tels que les rôles Utilisateur Cloud Trace (roles/cloudtrace.user) et Lecteur des 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 les outils et les chemins d'exécution, les métriques ponctuelles classiques sont souvent insuffisantes pour le débogage. Les traces sont essentielles pour l'observabilité des agents, car elles fournissent une chronologie complète et séquentielle 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 Google Cloud console, accédez à la page Agent Platform > Agent Registry.

    Accéder à Agent Registry

  2. Sélectionnez votre agent spécifique.

  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 des sessions : regroupe les exécutions par sessions utilisateur individuelles, ce qui vous permet d'analyser les conversations à plusieurs tours et le comportement de l'agent au fil du temps.
  • Vue des traces : se concentre sur les traces de requêtes de bout en bout individuelles, représentant un seul chemin d'exécution.
  • Vue des segments : fournit une liste détaillée des opérations individuelles (segments) exécutées dans vos traces, telles qu'un appel de modèle de fondation spécifique, une requête API ou une exécution d'outil externe.

Vue de trace unique (contexte de session)

Lorsque vous sélectionnez une session spécifique dans la vue des sessions, un volet "Détails" s'ouvre avec un panneau de liste sur le côté gauche affichant toutes les traces individuelles contenues dans cette session à plusieurs tours. Le panneau principal agrège le contexte de l'ensemble de la session, en affichant l'entrée mise en forme et les messages de l'assistant, ainsi que les métriques globales de la session, telles que la durée, le nombre total de jetons GenAI et les scores d'évaluation continue.

Vue de trace unique (contexte de trace ou de segment direct)

Vous pouvez également sélectionner une trace spécifique dans la vue des traces ou un segment distinct dans la vue des segments. Le volet "Détails" s'ouvre alors directement sur cette exécution spécifique. Comme vous affichez une seule opération plutôt qu'une session groupée, le panneau de liste de gauche est masqué, ce qui permet une inspection immédiate et ciblée de la latence, des attributs et des erreurs potentielles de cette opération.

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

Pour assurer la sécurité et la conformité, Gemini Enterprise Agent Platform sépare les métadonnées opérationnelles du contenu conversationnel réel :

  • Métriques et attributs d'exécution : la télémétrie standard (telle que la latence, les codes d'état et les métadonnées structurelles) est stockée directement dans les segments de trace.
  • Invites et réponses : les données potentiellement sensibles, telles que les invites utilisateur et les réponses du modèle, ne sont pas stockées dans les segments. Elles sont plutôt acheminées vers Cloud Logging ou Cloud Storage, en fonction de 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'interface utilisateur de Gemini Enterprise Agent Platform comprend automatiquement la corrélation sous-jacente entre vos segments de trace et ces journaux d'invites et de réponses stockés de manière sécurisée. Lorsque vous ouvrez une vue détaillée de la trace, la plate-forme regroupe ces données de manière transparente, 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 des données conversationnelles, consultez la documentation sur la journalisation des réponses aux invites multimodales dans Google Cloud Observability.

Étape suivante