Monitoraggio
Richiede un permesso di monitoraggio dedicato e il feature flag Monitoraggio attivo sul tenant.
La sezione Monitoraggio offre un cruscotto con auto-aggiornamento sull'utilizzo della piattaforma: conversazioni, attività, qualità delle risposte e stato delle quote.
Prerequisiti
- Permesso di monitoraggio dedicato.
- Feature flag Monitoraggio attivo sul tenant (vedi Feature flag).
La dashboard
La dashboard principale mostra un insieme di indicatori sintetici: numero di conversazioni, escalation/handoff verso operatore, agenti attivi, numero di knowledge base e, per il solo ruolo Super Admin, il costo maturato dall'inizio del mese. È affiancata da un grafico dell'andamento delle conversazioni nel tempo e da una card di utilizzo delle quote del tenant.
Il Super Admin (amministratore di piattaforma) dispone inoltre di un selettore per cambiare il tenant di cui visualizzare i dati (vedi Super Admin e piano Enterprise).
Le quote mostrate nella card di utilizzo dipendono dalle funzionalità attive e dal piano sottoscritto dal tenant: non tutte le quote compaiono per tutti i clienti. Il dettaglio è descritto in Quote e crediti AI — Quali quote sono visibili.
Panoramica e attività
La tab Panoramica mostra le metriche aggregate sul periodo selezionato (7/30/90 giorni): conversazioni totali, token totali, latenza media, tasso di errori, tasso e numero di handoff, con i relativi grafici giornalieri.
La tab Attività riporta il log dettagliato delle operazioni della piattaforma (chat, analisi documentale, analisi CV, OCR, classificazione), filtrabile per tipo di operazione e per stato. Ogni riga indica anche l'app di origine (source_app) che ha generato la chiamata, utile nei setup in cui Askme AI alimenta anche Askme Chat, Askme Desk, Askme Sign o applicazioni cliente personalizzate tramite API Key.
Le conversazioni nel monitoraggio
La tab Conversazioni elenca tutte le conversazioni del tenant, filtrabili per stato, agente e periodo.
Selezionando una riga si apre il dettaglio della conversazione: messaggio dell'utente, risposta dell'agente, fonti citate, intento classificato, sentiment, latenza e modello utilizzato. Il pulsante Apri conversazione consente di riaprirla direttamente nella chat.
Il dettaglio di una chiamata
Dal dettaglio di una singola chiamata è possibile aprire il dialogo trace RAG, che mostra in linguaggio comprensibile il percorso seguito dalla piattaforma per generare la risposta: comprensione della query (eventuale riscrittura), fonti recuperate dalla knowledge base e relativi risultati di rilevanza.
La timeline di una conversazione
La timeline di una conversazione presenta, in ordine cronologico e con etichette comprensibili anche a chi non conosce i dettagli tecnici del RAG, le fasi attraversate dalla richiesta: dalla ricezione del messaggio fino alla risposta restituita, incluso un eventuale handoff verso un operatore.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| La sezione Monitoraggio non compare in sidebar | Il feature flag Monitoraggio non è attivo sul tenant | Verificare lo stato del flag in Feature flag |
| Una conversazione non mostra le fonti nel trace RAG | L'agente non utilizza una knowledge base, oppure nessun documento ha superato la soglia di rilevanza | Verificare la configurazione RAG dell'agente e i contenuti della knowledge base collegata |
| I dati mostrati sembrano non aggiornati | La dashboard si aggiorna automaticamente a intervalli regolari | Attendere il ciclo di aggiornamento o ricaricare la pagina |