Log Agenti in Futuria CRM: Panoramica, Vantaggi e Configurazione

Sommario

1. Panoramica dei Log Agenti
2. Cosa sono i Log Agenti?
3. Vantaggi principali dei Log Agenti
4. Panoramica dell'attività globale
5. Contesto della conversazione e timeline
6. Esecuzione granulare dei passaggi
7. Come usare i Log Agenti
8. Scheda Metriche (vista dashboard)
9. Domande Frequenti

Panoramica dei Log Agenti

I Log Agenti ti offrono un modo centralizzato per analizzare il comportamento dei tuoi agenti AI nelle varie funzionalità supportate da Futuria CRM. Riunendo in un unico posto le attività di esecuzione, il contesto della conversazione e i dettagli di ogni passaggio, i Log Agenti rendono più semplice capire cosa è successo, identificare i problemi più velocemente e migliorare le performance degli agenti nel tempo. Questo articolo spiega cosa sono i Log Agenti, perché sono importanti e come utilizzare la loro esperienza diagnostica a tre livelli per analizzare l'attività degli agenti in Futuria CRM.

Cosa sono i Log Agenti?

I Log Agenti sono la funzionalità centralizzata di Futuria CRM per la registrazione e il tracciamento delle attività degli agenti AI. Sono progettati per offrirti un unico punto di riferimento per analizzare i log e le tracce delle applicazioni supportate nell'ecosistema di Futuria CRM, aiutandoti a capire cosa accade dietro le quinte durante ogni interazione.

Questa maggiore visibilità ti permette di superare le supposizioni, risolvere i problemi con sicurezza e migliorare il comportamento degli agenti con una visione più chiara di come vengono prese le decisioni. Attualmente, i Log Agenti sono disponibili per Agent Studio e Voice AI, con il supporto per altri prodotti AI in arrivo.

I Log Agenti sono strutturati per supportare un'esperienza diagnostica a tre livelli:

• Una visione d'insieme dell'attività degli agenti.
• Una timeline dettagliata della conversazione e dell'esecuzione per un'interazione specifica.
• Una vista granulare dei singoli passaggi con dettagli tecnici approfonditi per il debug.

Vantaggi principali dei Log Agenti

• Visibilità centralizzata: Analizza l'attività degli agenti AI supportati in un unico posto, invece di affidarti solo a visualizzazioni di test isolate.
• Risoluzione dei problemi più rapida: Passa da una visione generale dell'attività a una conversazione specifica e poi ai singoli passaggi di esecuzione per identificare dove si è verificato un errore.
• Miglior contesto per il debug: Confronta la risposta dell'agente con la timeline di esecuzione per capire come è stata prodotta la risposta finale.
• Consapevolezza delle performance: Utilizza i tempi di esecuzione a livello di singolo passaggio per individuare le aree lente che potrebbero richiedere attenzione.
• Maggiore sicurezza: Ispeziona i dettagli tecnici più da vicino quando risolvi problemi relativi a prompt, logica, variabili o comportamento degli strumenti.

Panoramica dell'attività globale

La panoramica dell'attività globale ti offre una visione d'insieme delle attività recenti 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, circoscrivere un problema o individuare un'interazione specifica da esaminare più da vicino.

La panoramica dell'attività globale rappresenta il primo livello di esperienza nei Log Agenti. Da qui, gli utenti possono esaminare le esecuzioni recenti e iniziare la loro indagine.

Questa vista è utile per:

• Monitorare l'attività recente tra le esperienze degli agenti supportate.
• Restringere il campo su quale esecuzione analizzare.
• Individuare più rapidamente un'interazione specifica.
• Analizzare le conversazioni in modo più efficiente in ambienti con volumi elevati.

Gli elementi e le azioni comuni in questa vista possono includere:

Contesto della conversazione e timeline

Visualizzare la conversazione e la cronologia di esecuzione insieme ti aiuta a comprendere sia l'esperienza dell'utente sia la logica che la guida. 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 della conversazione e la timeline rappresentano il secondo livello di esperienza nei Log Agenti. Dopo aver selezionato un'interazione specifica, puoi analizzare la conversazione accanto 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 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 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 include una checklist che traccia il lavoro multi-passaggio.

- Le attività usano etichette descrittive invece di indici numerici.
- L'interfaccia indica quale attività è attiva e quali sono completate.
- Questo migliora la chiarezza sull'avanzamento quando l'agente aggiunge attività o cambia il piano durante l'esecuzione.

Esecuzione granulare dei passaggi

Il dettaglio a livello di singolo passaggio è dove la risoluzione dei problemi diventa molto più precisa. Quando una conversazione sembra errata o incompleta, ispezionare un singolo passaggio di esecuzione può aiutare a rivelare 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 analizzare l'output in diversi formati, inclusa una vista grezza in stile JSON o una vista analizzata più leggibile. Per un debug più approfondito e per la condivisione, l'output del passaggio può anche essere copiato come JSON.

L'esecuzione granulare dei passaggi è il terzo livello di esperienza nei Log Agenti. 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.
• Latenza e tempi di esecuzione.
• Dettagli sulla data e l'ora.
• Input e output per il passaggio selezionato.
• Dettagli del prompt, dove applicabile.
• Metadati tecnici aggiuntivi che supportano il debug.

Potresti anche vedere dettagli strutturati delle attività per esecuzioni multi-passaggio (ad esempio, attività etichettate e transizioni esplicite). Usa questi dettagli per confermare l'ordine delle attività, lo stato di completamento e dove l'avanzamento è cambiato.

Come usare i Log Agenti

I Log Agenti non richiedono un'installazione separata. La parte più importante della configurazione è assicurarsi di avere attività degli agenti supportate da analizzare e di sapere come passare dalla vista generale a quelle di esecuzione dettagliate. Un processo di configurazione chiaro ti aiuta a ottenere valore dai Log Agenti più velocemente e rende la risoluzione dei problemi più coerente.

Segui i passaggi seguenti per iniziare a lavorare con i Log Agenti:

1. Apri Agenti AI > Log Agenti nel tuo account Futuria CRM.
   

   

2. Analizza l'elenco delle attività e scegli l'interazione che vuoi ispezionare. Usa filtri come Nome Agente, Prodotto AI, Canale o Stato per restringere i risultati.
   

   

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

   

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

   

5. Esegui nuovamente il test e analizza l'attività aggiornata nei Log Agenti.

Scheda Metriche (vista dashboard)

La scheda Metriche riassume i dati dei Log Agenti in una dashboard personalizzabile. Usala per monitorare volumi, performance e trend operativi tra gli agenti, invece di analizzare una singola sessione.

Personalizza il layout della dashboard

Seleziona Modifica Layout per cambiare l'aspetto della dashboard:

• Aggiungi o rimuovi widget.
• Trascina e rilascia i widget per riorganizzare il layout.
• Ridimensiona i widget per concentrarti su grafici o tabelle specifiche.
• Salva più layout e passa da uno all'altro usando il menu a tendina del layout.

Cosa ti aiuta a tracciare la scheda Metriche

I widget delle metriche ti aiutano a monitorare:

• KPI principali (ad esempio, conversazioni gestite, messaggi AI e media di messaggi per conversazione).
• Performance (ad esempio, tempo medio di risposta e agenti migliori).
• Stato operativo (ad esempio, azioni principali e latenza media di esecuzione).
• Trend (ad esempio, ore di punta e attività dei canali nel tempo).

Per le definizioni complete dei widget e esempi di configurazione della dashboard, consulta la guida sulle Metriche dei Log Agenti.

Domande Frequenti