Agent-Traces ansehen

Hinweis

Bevor Sie Agent-Traces ansehen können, müssen die folgenden Voraussetzungen erfüllt sein:

  • APIs aktivieren: Achten Sie darauf, dass die folgenden APIs für IhrGoogle Cloud -Projekt aktiviert sind:
    • Cloud Trace API
    • Cloud Logging API
    • Telemetry API
  • Agent-Tracing konfigurieren: Ihr Agent muss so konfiguriert sein, dass er Tracedaten an Google Cloudsendet. Eine Anleitung zum Aktivieren des Tracings für verschiedene Agent-Typen finden Sie unter Tracing einrichten.
  • Berechtigungen konfigurieren: Zum Aufrufen von Traces und Logs benötigen Sie IAM-Rollen, die die erforderlichen Berechtigungen enthalten, z. B. die Rollen Cloud Trace-Nutzer (roles/cloudtrace.user) und Loganzeige (roles/logging.viewer). Weitere Informationen finden Sie unter Zugriffssteuerung für Cloud Trace und Zugriffssteuerung für Cloud Logging.

Distributed Tracing ist eine Diagnosetechnik, mit der der Fortschritt einer einzelnen Anfrage verfolgt wird, während sie verschiedene verteilte Dienste und Komponenten in Ihrer Architektur durchläuft. Da generative KI-Agents nicht deterministische Begründungsschleifen verwenden, um Tools und Ausführungspfade dynamisch auszuwählen, reichen herkömmliche Point-in-Time-Messwerte oft nicht für das Debugging aus. Traces sind für die Beobachtbarkeit von Agents unerlässlich, da sie eine vollständige, sequenzielle Zeitachse dieser unvorhersehbaren Interaktionen bieten. So können Sie genau nachvollziehen, warum ein Agent eine bestimmte Entscheidung getroffen hat.

Traces ansehen

So greifen Sie auf detaillierte Ausführungsdaten für einen Agent zu:

  1. Rufen Sie in der Google Cloud -Console die Seite Agent Platform > Agent Registry auf.

    Zur Agent Registry

  2. Wählen Sie den gewünschten Agent aus.

  3. Klicken Sie auf den Tab Traces.

Über diese Benutzeroberfläche können Sie die schrittweisen Ausführungsdetails Ihres Agents prüfen. Ein Trace ist ein sachlicher, unveränderlicher Datensatz des Verhaltens des KI-Agenten, einschließlich Modelleingaben, Antworten und Toolaufrufen. Die Trace-Ansicht enthält einen gerichteten azyklischen Graphen (DAG) der zugehörigen Spans, Ein- und Ausgaben sowie Metadatenattribute.

Auf dem Tab „Traces“ stehen drei verschiedene Ansichten zur Verfügung, um Ihre Telemetriedaten zu analysieren:

  • Sitzungsansicht:Hier werden Ausführungen nach einzelnen Nutzersitzungen gruppiert. So können Sie Unterhaltungen mit mehreren Zügen und das Verhalten des Agents im Zeitverlauf analysieren.
  • Trace-Ansicht:Hier werden einzelne End-to-End-Anfrage-Traces angezeigt, die einen einzelnen Ausführungspfad darstellen.
  • Span-Ansicht:Bietet eine detaillierte Liste der einzelnen Vorgänge (Spans), die in Ihren Traces ausgeführt werden, z. B. ein bestimmter Foundation Model-Aufruf, eine API-Anfrage oder die Ausführung eines externen Tools.

Ansicht für einzelne Traces (Sitzungskontext)

Wenn Sie in der Sitzungsansicht eine bestimmte Sitzung auswählen, wird ein Detailbereich geöffnet. Links sehen Sie eine Liste mit allen einzelnen Traces, die in dieser Sitzung mit mehreren Anfragen enthalten sind. Im Hauptbereich wird der gesamte Kontext der Sitzung zusammengefasst. Dort werden die formatierte Eingabe und die Assistentennachrichten sowie allgemeine Sitzungsmesswerte wie Dauer, Gesamtzahl der GenAI-Tokens und kontinuierliche Evaluierungs-Scores angezeigt.

Ansicht für einen einzelnen Trace (direkter Trace oder Spankontext)

Wenn Sie alternativ einen bestimmten Trace aus der Trace-Ansicht oder einen bestimmten Span aus der Span-Ansicht auswählen, wird der Detailbereich direkt für diese Ausführung geöffnet. Da Sie sich einen einzelnen Vorgang ansehen und nicht eine gruppierte Sitzung, ist der Bereich mit der Liste auf der linken Seite ausgeblendet. So können Sie sich sofort und gezielt die spezifische Latenz, die Attribute und die potenziellen Fehler dieses Vorgangs ansehen.

Datenspeicherung und Zugriffssteuerung

Um Sicherheit und Compliance zu gewährleisten, werden in der Gemini Enterprise Agent Platform Betriebsmetadaten vom eigentlichen Konversationsinhalt getrennt:

  • Ausführungsstatistiken und ‑attribute:Standardtelemetrie (z. B. Latenz, Statuscodes und strukturelle Metadaten) wird direkt in den Trace-Spans gespeichert.
  • Prompts und Antworten:Potenziell vertrauliche Daten wie Nutzer-Prompts und Modellantworten werden nicht in den Spans gespeichert. Stattdessen werden sie je nach Konfiguration Ihrer Organisation an Cloud Logging oder Cloud Storage weitergeleitet. So können Administratoren detaillierte IAM-Steuerelemente (Identity and Access Management, Identitäts- und Zugriffsverwaltung) für sensible Konversationsdaten implementieren.

Die Benutzeroberfläche der Gemini Enterprise Agent Platform erkennt automatisch die zugrunde liegende Korrelation zwischen Ihren Trace-Spans und diesen sicher gespeicherten Prompt- und Antwortprotokollen. Wenn Sie eine Detailansicht für einen Trace öffnen, werden diese Daten nahtlos zusammengefügt und es wird eine ganzheitliche Übersicht des Agentenverhaltens präsentiert, ohne dass Ihre Data Governance-Regeln beeinträchtigt werden.

Weitere Informationen zum Konfigurieren von Speicherzielen für Konversationsdaten finden Sie unter Multimodale Prompts und Antworten erfassen und ansehen.

Nächste Schritte