Visualizzare le tracce dell'agente

Prima di iniziare

Prima di poter visualizzare le tracce degli agenti, devi soddisfare i seguenti requisiti:

  • Abilita le API: assicurati che le seguenti API siano abilitate per il tuo Google Cloud progetto:
    • Cloud Trace API
    • API Cloud Logging
    • API Telemetry
  • Configura la tracciabilità degli agenti: l'agente deve essere configurato per inviare i dati di traccia a Google Cloud. Per istruzioni su come abilitare la tracciabilità per diversi tipi di agenti, vedi Configurare la tracciabilità.
  • Configura le autorizzazioni: per visualizzare tracce e log, devi disporre di ruoli IAM che forniscano le autorizzazioni richieste, come i ruoli Utente Cloud Trace (roles/cloudtrace.user) e Visualizzatore log (roles/logging.viewer). Per saperne di più, consulta Controllo degli accessi di Cloud Trace e Controllo degli accessi di Cloud Logging.

La tracciabilità distribuita è una tecnica di diagnostica che monitora l'avanzamento di una singola richiesta mentre attraversa vari servizi e componenti distribuiti nella tua architettura. Poiché gli agenti di AI generativa utilizzano loop di ragionamento non deterministici per scegliere dinamicamente strumenti e percorsi di esecuzione, le metriche convenzionali puntuali sono spesso insufficienti per il debug. Le tracce sono essenziali per l'osservabilità degli agenti perché forniscono una sequenza temporale completa e sequenziale di queste interazioni imprevedibili, consentendoti di vedere esattamente perché un agente ha preso una decisione specifica.

Esplorare le tracce

Per accedere ai dati di esecuzione dettagliati di un agente:

  1. Nella Google Cloud console, vai alla pagina Piattaforma agenti > Registro agenti.

    Vai al Registro agenti

  2. Seleziona l'agente specifico.

  3. Fai clic sulla scheda Tracce.

Questa interfaccia ti consente di ispezionare i dettagli di esecuzione passo passo del tuo agente. Una traccia è un record fattuale e immutabile del comportamento dell'agente, inclusi input, risposte e chiamate allo strumento del modello. La visualizzazione della traccia include un grafo diretto aciclico (DAG) dei relativi intervalli, input e output e attributi dei metadati.

La scheda Tracce fornisce tre visualizzazioni distinte per esplorare i dati di telemetria:

  • Visualizzazione sessione:raggruppa le esecuzioni per singole sessioni utente, consentendoti di analizzare le conversazioni a più turni e il comportamento dell'agente nel tempo.
  • Visualizzazione traccia:si concentra sulle singole tracce di richiesta end-to-end, che rappresentano un singolo percorso di esecuzione.
  • Visualizzazione intervallo:fornisce un elenco granulare delle singole operazioni (intervalli) eseguite all'interno delle tracce, come una chiamata specifica al modello di base, una richiesta API o un'esecuzione di uno strumento esterno.

Visualizzazione di una singola traccia (contesto della sessione)

Quando selezioni una sessione specifica dalla Visualizzazione sessione, si apre un riquadro Dettagli con un riquadro elenco sul lato sinistro che mostra tutte le singole tracce contenute nella sessione a più turni. Il riquadro principale aggrega l'intero contesto della sessione, visualizzando i messaggi di input e dell'assistente formattati, insieme alle metriche complessive della sessione, come durata, token GenAI totali e punteggi di valutazione continua.

Visualizzazione di una singola traccia (traccia diretta o contesto dell'intervallo)

In alternativa, se selezioni una traccia specifica dalla Visualizzazione traccia o uno span distinto dalla Visualizzazione span, il riquadro dei dettagli si apre direttamente all'esecuzione specifica. Poiché stai visualizzando una singola operazione anziché una sessione raggruppata, il riquadro elenco a sinistra è nascosto, consentendo un'ispezione immediata e mirata della latenza, degli attributi e dei potenziali errori specifici dell'operazione.

Archiviazione dei dati e controllo dell'accesso

Per mantenere la sicurezza e la conformità, Gemini Enterprise Agent Platform separa i metadati operativi dai contenuti conversazionali effettivi:

  • Metriche e attributi di esecuzione:la telemetria standard (come latenza, codici di stato e metadati strutturali) viene archiviata direttamente negli intervalli di traccia.
  • Prompt e risposte:i dati potenzialmente sensibili, come i prompt utente e le risposte del modello, non vengono archiviati negli intervalli. Vengono invece indirizzati a Cloud Logging o Cloud Storage, a seconda della configurazione della tua organizzazione. In questo modo, gli amministratori possono implementare controlli granulari di Identity and Access Management (IAM) sui dati conversazionali sensibili.

L'interfaccia utente di Gemini Enterprise Agent Platform comprende automaticamente la correlazione sottostante tra gli intervalli di traccia e questi log di prompt e risposte archiviati in modo sicuro. Quando apri una visualizzazione dei dettagli della traccia, la piattaforma ricompone questi dati senza problemi, presentando una visualizzazione unificata del comportamento dell'agente senza compromettere le regole di governance dei dati.

Per saperne di più sulla configurazione delle destinazioni di archiviazione per i dati conversazionali, consulta Raccogliere e visualizzare prompt e risposte multimodali.

Passaggi successivi