Panoramica di Agent Logs
Agent Logs offre un modo centralizzato per esaminare il comportamento dei tuoi agenti AI nelle esperienze HITLEAD supportate. Riunendo in un unico posto l'attività di esecuzione, il contesto delle conversazioni e i dettagli a livello di step, 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 usare la sua esperienza diagnostica a tre livelli per analizzare l'attività degli agenti in HITLEAD.
INDICE
- Cos'è Agent Logs?
- Vantaggi chiave di Agent Logs
- Panoramica dell'attività globale
- Contesto conversazionale e Timeline
- Esecuzione granulare degli step
- Come usare Agent Logs
- Scheda Metrics (vista Dashboard)
- Domande frequenti
- Articoli correlati
Cos'è Agent Logs?
Agent Logs è l'esperienza centralizzata di logging e tracciamento di HITLEAD per gli agenti AI. È progettata per offrirti un unico punto unificato in cui esaminare log e tracce per le applicazioni agentiche supportate nell'ecosistema HITLEAD, aiutandoti a capire cosa succede dietro le quinte durante ogni interazione. Questa maggiore visibilità rende più facile andare oltre le supposizioni, 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.
Agent Logs è costruito per supportare un'esperienza diagnostica a tre livelli:
- Una visione d'insieme dell'attività degli agenti
- Una timeline di conversazione ed esecuzione dettagliata per una specifica interazione
- Una vista granulare degli step con dettagli tecnici approfonditi per il debug
Vantaggi chiave 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 visione ampia dell'attività a una conversazione specifica e poi ai singoli step 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 step per individuare aree lente che potrebbero richiedere attenzione.
- Maggiore fiducia: Esamina i dettagli tecnici più da vicino durante la risoluzione di problemi relativi a prompt, logica, variabili o comportamento degli strumenti.
Panoramica dell'attività globale
La Panoramica dell'attività globale ti offre una visione ampia dell'attività recente degli agenti, così puoi identificare rapidamente dove concentrare la tua attenzione. Questa prospettiva di alto livello è utile quando vuoi monitorare l'attività su larga scala, restringere un problema o individuare una specifica interazione da esaminare più da vicino.
La Panoramica dell'attività globale è l'esperienza di Livello 1 in Agent Logs. Da qui, puoi esaminare le esecuzioni recenti e iniziare a restringere la tua indagine.
Questa vista è utile per:
- Monitorare l'attività recente nelle esperienze agentiche supportate
- Restringere quale esecuzione esaminare
- Individuare un'interazione specifica più rapidamente
- Esaminare le conversazioni in modo più efficiente in ambienti ad alto volume
Elementi e 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 | Mostra l'ID univoco dell'agente legato all'interazione. |
| Prodotto AI | Mostra a quale prodotto AI supportato appartiene l'attività. |
| Canale | Mostra il canale in cui è avvenuta l'interazione. |
| Status | Mostra il risultato o lo stato attuale dell'interazione. |
| Filter by product | Restringe i risultati a un prodotto AI specifico. |
| Filter by agent name | Si concentra sull'attività di un agente specifico. |
| Search by contact | Aiuta a trovare le interazioni collegate a un Contatto specifico. |
| Sort results | Riordina i risultati per trovare le interazioni più rilevanti più rapidamente. |
Contesto conversazionale e Timeline
Vedere la conversazione e la cronologia di esecuzione insieme aiuta a capire sia l'esperienza dell'utente sia la logica che la sottende. Questa vista è utile quando devi 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 Timeline è l'esperienza di Livello 2 in Agent Logs. Dopo aver selezionato una specifica interazione, puoi esaminare la conversazione insieme a una timeline di esecuzione.
Questa vista ti aiuta a:
- Leggere l'interazione in un formato di conversazione familiare
- Confrontare la risposta dell'agente con gli step 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 che l'agente ha seguito durante l'interazione, offrendoti un quadro più chiaro di come la conversazione è progredita dietro le quinte.
Checklist delle attività nelle timeline di esecuzione
In alcune esecuzioni di Agent Studio, la timeline di esecuzione include una checklist di attività che traccia il lavoro multi-step.
- Le attività usano etichette descrittive invece di indici numerici degli step.
- L'interfaccia indica quale attività è attiva e quali sono completate.
- Questo migliora la chiarezza del progresso quando l'agente aggiunge attività o cambia il piano durante l'esecuzione.
Esecuzione granulare degli step
Il dettaglio a livello di step è dove la risoluzione dei problemi diventa molto più precisa. Quando una conversazione sembra errata o incompleta, esaminare un singolo step di esecuzione può aiutare a rivelare se il problema proviene dalla logica, dai tempi, dalla gestione dei dati o da un'azione correlata a uno strumento.
A seconda dello step, potresti anche essere in grado di esaminare l'output in diversi formati, inclusa una vista in stile JSON grezzo o una vista analizzata più leggibile. Per un debug più approfondito e la condivisione, l'output dello step può essere copiato come JSON.
L'Esecuzione granulare degli step è l'esperienza di Livello 3 in Agent Logs. Selezionando uno step dalla timeline di esecuzione, puoi esaminare informazioni più dettagliate su quella parte dell'interazione.
Questa vista approfondita è utile per esaminare:
- Il modello usato per lo step
- Latenza e tempi di esecuzione
- Dettagli del timestamp
- Input e output per lo step selezionato
- Dettagli del prompt, dove applicabile
- Metadati tecnici aggiuntivi che supportano il debug
Potresti anche vedere dettagli strutturati delle attività per l'esecuzione multi-step (ad esempio, attività etichettate e transizioni esplicite). Usa questi dettagli per confermare l'ordine delle attività, lo stato di completamento e dove il progresso è cambiato.
Come usare Agent Logs
Agent Logs non richiede un'installazione separata. La parte più importante della configurazione è assicurarsi di avere attività di agenti supportata da esaminare e di sapere come passare dalla vista di 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.
Usa i passaggi seguenti per iniziare a lavorare con Agent Logs:
- Apri AI Agents > Agent Logs nel tuo account HITLEAD.
- Esamina l'elenco delle attività e scegli l'interazione che vuoi esaminare. Usa filtri come Agent Name, AI Product, Channel o Status per restringere i risultati.
- Apri l'interazione per visualizzare la conversazione e la timeline di esecuzione.
- Seleziona un messaggio o uno step per vedere informazioni di esecuzione più dettagliate. Usa questi dettagli per migliorare il tuo agente.
- Esegui di nuovo il test e rivedi l'attività aggiornata in Agent Logs.
Scheda Metrics (vista Dashboard)
La scheda Metrics riepiloga i dati di Agent Logs in un Dashboard personalizzabile. Usala per monitorare volume, prestazioni e trend operativi tra gli agenti, invece di esaminare una singola sessione.
Personalizzare il layout del Dashboard
Seleziona Edit Layout per cambiare l'aspetto del Dashboard:
- Aggiungi o rimuovi Widget
- Trascina e rilascia i Widget per riorganizzare il layout
- Ridimensiona i Widget per concentrarti su grafici o tabelle specifici
- Salva più layout e passa da uno all'altro usando il menu a tendina del layout
Cosa traccia Metrics
I Widget di Metrics ti aiutano a monitorare:
- KPI principali (ad esempio, conversazioni gestite, messaggi AI e media messaggi per conversazione)
- Prestazioni (ad esempio, tempo di risposta medio e agenti principali)
- Salute operativa (ad esempio, azioni principali e latenza di esecuzione media)
- Trend (ad esempio, ore di punta e attività dei canali nel tempo)
Per le definizioni complete dei Widget e gli esempi di configurazione del Dashboard, consulta Agent Logs Metrics
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 Message Execution Timeline in Agent Studio?
No. Agent Logs è un'esperienza centralizzata di logging e tracciamento, mentre la Message Execution Timeline fa parte dell'esperienza di test e debug di Agent Studio.
D: Quando dovrei usare Agent Logs?
Usa Agent Logs quando vuoi esaminare come un agente ha risposto, rivedere il percorso di un'interazione o risolvere un problema in uno step specifico del flusso di esecuzione.
D: Agent Logs può aiutare con il debug di interazioni lente o complesse?
Sì. La vista a livello di step è 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 prodotti AI aggiuntivi in arrivo.
Articoli correlati
Questo articolo è stato utile?