Agent Logs ti offre un modo centralizzato per esaminare il comportamento dei tuoi agenti AI nelle esperienze supportate da GoHighLevel / Squadd. Portando in un unico posto l'attività di esecuzione, il contesto delle conversazioni e i dettagli a livello di singolo passaggio, Agent Logs rende più semplice capire cosa è successo, identificare i problemi più rapidamente e migliorare le prestazioni degli agenti nel tempo. Questo articolo spiega cos'è Agent Logs, perché è importante e come utilizzare la sua esperienza diagnostica a tre livelli per analizzare l'attività degli agenti in GoHighLevel / Squadd.
- Cos'è Agent Logs?
- Vantaggi principali di Agent Logs
- Panoramica globale dell'attività
- Contesto conversazionale e timeline
- Esecuzione granulare dei passaggi
- Come utilizzare Agent Logs
- Scheda Metriche (vista dashboard)
- Domande frequenti
- Articoli correlati
Cos'è Agent Logs?
Agent Logs è l'esperienza centralizzata di logging e tracciamento per gli agenti AI di GoHighLevel / Squadd. È progettata per offrirti un unico posto unificato in cui esaminare log e tracce per le applicazioni agentiche supportate nell'ecosistema GoHighLevel / Squadd, aiutandoti a capire cosa accade dietro le quinte durante ogni interazione. Questa visibilità aggiuntiva rende più facile andare oltre le congetture, risolvere i problemi con sicurezza e migliorare il comportamento degli agenti con una comprensione più chiara di come vengono prese le decisioni. Al momento, Agent Logs è attivo per Agent Studio e Voice AI, con supporto per altri prodotti AI in arrivo a breve.
Agent Logs è costruito per supportare un'esperienza diagnostica a tre livelli:
- Una visione ad alto livello dell'attività degli agenti
- Una conversazione dettagliata e una timeline di esecuzione per un'interazione selezionata
- Una vista granulare dei passaggi con dettagli tecnici approfonditi per il debug
Vantaggi principali di Agent Logs
- Visibilità centralizzata: Esamina l'attività degli agenti AI supportati in un unico posto, invece di affidarti solo a viste di test isolate.
- Risoluzione dei problemi più rapida: Passa da una vista generale dell'attività a una conversazione specifica e poi ai singoli passaggi di esecuzione per identificare dove qualcosa è andato storto.
- Contesto migliore per il debug: Confronta la risposta dell'agente con la timeline di esecuzione per capire come è stata prodotta la risposta finale.
- Consapevolezza delle prestazioni: Usa i tempi di esecuzione a livello di singolo passaggio per individuare le aree lente che potrebbero richiedere attenzione.
- Maggiore sicurezza: Analizza i dettagli tecnici più da vicino durante la risoluzione dei problemi relativi a prompt, logica, variabili o comportamento degli strumenti.
Panoramica globale dell'attività
La Panoramica globale dell'attività ti offre una visione ampia della recente attività degli agenti, così puoi identificare rapidamente su cosa concentrare la tua attenzione. Questa prospettiva di alto livello è utile quando vuoi monitorare l'attività su larga scala, restringere un problema o individuare un'interazione specifica da analizzare più da vicino.
La Panoramica globale dell'attività rappresenta l'esperienza di Livello 1 in Agent Logs. Da qui, gli utenti possono esaminare le esecuzioni recenti e iniziare a restringere la loro analisi.
Questa vista è utile per:
- Monitorare la recente attività nelle esperienze agentiche supportate
- Restringere quale esecuzione analizzare
- Individuare un'interazione specifica più rapidamente
- Esaminare le conversazioni in modo più efficiente in ambienti ad alto volume
Gli elementi e le azioni comuni in questa vista possono includere:
| Elemento o Azione | Descrizione |
|---|---|
| Timestamp | Mostra quando è avvenuta l'interazione, così puoi esaminare l'attività nel contesto. |
| Nome agente | Identifica quale agente ha gestito l'interazione. |
| ID agente | Visualizza l'ID univoco dell'agente associato all'interazione. |
| Prodotto AI | Mostra a quale prodotto AI supportato appartiene l'attività. |
| Canale | Visualizza il canale in cui è avvenuta l'interazione. |
| Stato | Mostra il risultato o lo stato attuale dell'interazione. |
| Filtra per prodotto | Restringe i risultati a un prodotto AI specifico. |
| Filtra per nome agente | Concentra l'attività su un agente specifico. |
| Cerca per contatto | Aiuta a trovare le interazioni collegate a un Contatto specifico. |
| Ordina risultati | Riordina i risultati per trovare più rapidamente le interazioni più rilevanti. |

Contesto conversazionale e timeline
Vedere la conversazione e la cronologia di esecuzione insieme ti aiuta a comprendere sia l'esperienza dell'utente che la logica che la governa. Questa vista è utile quando hai bisogno di rispondere a domande come: perché l'agente ha risposto in un certo modo, dove è cambiata una decisione o quando è stato coinvolto uno strumento.
Il Contesto conversazionale e la timeline rappresentano l'esperienza di Livello 2 in Agent Logs. Dopo aver selezionato un'interazione specifica, puoi esaminare la conversazione insieme a una timeline di esecuzione.
Questa vista ti aiuta a:
- Leggere l'interazione in un formato conversazionale familiare
- Confrontare la risposta dell'agente con i passaggi che l'hanno generata
- Tracciare il flusso dal messaggio originale dell'utente fino alla risposta finale
La timeline di esecuzione è progettata per mostrare il percorso ordinato seguito dall'agente durante l'interazione, offrendoti un quadro più chiaro di come è progredita la conversazione dietro le quinte.
Checklist dei task nelle timeline di esecuzione
In alcune esecuzioni di Agent Studio, la timeline di esecuzione include una checklist dei task che tiene traccia del lavoro a più passaggi.
- I task usano etichette descrittive invece di indici numerici dei passaggi.
- L'interfaccia indica quale task è attivo e quali task sono completati.
- Questo migliora la chiarezza sull'avanzamento quando l'agente aggiunge task o modifica il piano durante l'esecuzione.

Esecuzione granulare dei passaggi
Il dettaglio a livello di singolo passaggio è il punto in cui la risoluzione dei problemi diventa molto più precisa. Quando una conversazione appare errata o incompleta, ispezionare un singolo passaggio di esecuzione può aiutare a capire se il problema deriva dalla logica, dai tempi, dalla gestione dei dati o da un'azione legata a uno strumento.
A seconda del passaggio, gli utenti possono anche esaminare l'output in diversi formati, inclusa una vista in stile JSON grezzo o una vista analizzata più leggibile. Per un debug approfondito e per la condivisione, l'output del passaggio può anche essere copiato come JSON.
L'Esecuzione granulare dei passaggi è l'esperienza di Livello 3 in Agent Logs. Selezionando un passaggio dalla timeline di esecuzione, puoi esaminare informazioni più dettagliate su quella parte dell'interazione.
Questa vista approfondita è utile per esaminare:
- Il modello utilizzato per il passaggio
- La latenza e i tempi di esecuzione
- I dettagli del timestamp
- Input e output del passaggio selezionato
- I dettagli del prompt, ove applicabile
- Ulteriori metadati tecnici a supporto del debug
Potresti anche vedere dettagli strutturati dei task per esecuzioni a più passaggi (ad esempio, task etichettati e transizioni esplicite). Usa questi dettagli per confermare l'ordine dei task, lo stato di completamento e dove l'avanzamento è cambiato.
Come utilizzare Agent Logs
Agent Logs non richiede un'installazione separata. La parte più importante della configurazione è assicurarsi di avere attività agentiche supportate da esaminare e di sapere come passare dalla vista ad alto livello alle viste di esecuzione dettagliate. Un processo di configurazione chiaro ti aiuta a ottenere valore da Agent Logs più rapidamente e rende la risoluzione dei problemi più coerente.
Segui i passaggi seguenti per iniziare a usare Agent Logs:
- Apri AI Agents >Agent Logs nel tuo account GoHighLevel / Squadd.

- Esamina l'elenco delle attività e scegli l'interazione che vuoi analizzare. Usa i filtri come Nome agente, Prodotto AI, Canale o Stato per restringere i risultati.

- Apri l'interazione per visualizzare la conversazione e la timeline di esecuzione.

- Seleziona un messaggio o un passaggio per vedere informazioni di esecuzione più dettagliate. Usa questi dettagli per migliorare il tuo agente.

- Esegui di nuovo il test e verifica l'attività aggiornata in Agent Logs.
Scheda Metriche (vista dashboard)
La scheda Metriche riassume i dati di Agent Logs in una dashboard personalizzabile. Usala per monitorare volume, prestazioni e tendenze operative tra gli agenti, invece di esaminare una singola sessione.

Personalizzare il layout della dashboard
Seleziona Modifica layout per cambiare l'aspetto della dashboard:
- Aggiungere o rimuovere widget
- Trascinare e rilasciare i widget per ridisporre il layout
- Ridimensionare i widget per concentrarsi su grafici o tabelle specifici
- Salvare più layout e passare da uno all'altro usando il menu a tendina dei layout

Cosa monitora la scheda Metriche
I widget della scheda Metriche ti aiutano a monitorare:
- KPI principali (ad esempio, conversazioni gestite, messaggi AI e media di messaggi per conversazione)
- Prestazioni (ad esempio, tempo medio di risposta e agenti migliori)
- Salute operativa (ad esempio, azioni principali e latenza media di esecuzione)
- Tendenze (ad esempio, ore di punta e attività per canale nel tempo)

Per le definizioni complete dei widget e gli esempi di configurazione della dashboard, consulta Metriche di Agent Logs
Domande frequenti
D: Qual è lo scopo principale di Agent Logs?
Agent Logs ti aiuta a capire come un agente AI ha gestito un'interazione, combinando il contesto della conversazione con i dettagli di esecuzione in una vista centralizzata.
D: Agent Logs è uguale alla Timeline di esecuzione messaggi in Agent Studio?
No. Agent Logs è un'esperienza centralizzata di logging e tracciamento, mentre la Timeline di esecuzione messaggi fa parte dell'esperienza di test e debug di Agent Studio.
D: Quando dovrei usare Agent Logs?
Usa Agent Logs quando vuoi analizzare come ha risposto un agente, esaminare il percorso di un'interazione o risolvere un problema in un passaggio specifico del flusso di esecuzione.
D: Agent Logs può aiutare con il debug di interazioni lente o complesse?
Sì. La vista a livello di singolo passaggio è progettata per fornire informazioni di esecuzione più dettagliate, inclusi tempi e contesto tecnico, che possono aiutare nella risoluzione dei problemi.
D: Agent Logs supporterà altri prodotti AI in futuro?
Sì. Agent Logs è attivo per Agent Studio al lancio, con supporto per ulteriori prodotti AI in arrivo a breve.