Monitoraggio
La sezione Monitoraggio offre un cruscotto responsive con auto-refresh e metriche per tenant. E' lo strumento principale per tenere sotto controllo utilizzo, costi, qualita' delle conversazioni e stato delle quote.
Tab Panoramica
Metriche aggregate sul periodo selezionato (7 / 30 / 90 giorni):
- Conversazioni totali
- Token totali (input + output)
- Latenza media
- Tasso di errori
- Tasso di handoff
- Handoff totali
- Grafici per giorno: conversazioni, token, latenza, errori, handoff
Tab Attivita'
Log dettagliato delle operazioni della piattaforma (chat, analisi PDF, CV, OCR, classificazione, ecc.).
- Filtra per tipo operazione e stato
- Per ogni riga: data, tipo, risorsa, source_app (l'app che ha originato la chiamata), durata
La piattaforma traccia l'app esterna che ha originato la chiamata tramite l'header X-Source-App (vedi API key). E' particolarmente utile in setup multi-prodotto dove Askme AI alimenta l'AI di Chat, Desk, Sign o di applicazioni cliente personalizzate.
Tab Conversazioni
Tabella di tutte le conversazioni del tenant con filtri per stato, agente, periodo (da/a). Click su una riga per aprire il dettaglio messaggi: testo utente, risposta agente, citazioni RAG, intent classificato, sentiment, latenza, modello usato.
Pulsante Apri conversazione per riaprirla nella chat.
Leggere conversazioni reali e' lo strumento piu' efficace per capire dove l'agente sbaglia e quali FAQ aggiungere. Programmati una revisione settimanale: filtra per "feedback negativo" o "handoff" per concentrarti sui casi critici.
Tab Costi
Analisi dettagliata dei costi:
- Costo totale periodo + trend giornaliero
- Breakdown per modello — costo per ciascun LLM utilizzato
- Costo per categoria operazione — chat, embedding, reranking, classificazione, ecc. (raggruppato sul tag
operation_type; le chiamate senza tag finiscono inunknown) - Source app attribution — da quale app esterna proviene il costo
- Grafico a torta con etichette complete per ogni fetta
I tipi di operazione tracciati includono: chat, chat-stream, generate, query-rewrite, multi-rewrite, rerank-llm, classification, auto-reflection, rag-evaluation, embedding, handoff, pdf-analysis, cv-analysis, scraping-enrichment.
I costi visualizzati sono sempre limitati al tuo tenant.
Tab Quote
Stato delle quote del tenant. Per ciascuna quota una card con: nome quota, valore corrente, limite, percentuale.
Bordo card colorato
| Colore | Soglia |
|---|---|
| Dorato | Entro l'80% |
| Arancione | 80% - 90% |
| Rosso | Oltre il 90% |
Quote tipiche monitorate
Chat mensili, chiamate API, agenti, knowledge base, documenti per KB, spazio archiviazione, utenti, chiavi API, sessioni simultanee, analisi mensili, pagine per analisi, scraping mensili, pagine scraping, crediti AI mensili, webhook.
Banner di avviso
Quando una quota supera l'80% del limite, un banner giallo compare in cima alla schermata:
"Attenzione: alcune quote si stanno esaurendo."
Click su Visualizza dettagli per saltare alla sezione Quote completa.
Email di avviso quota
In aggiunta al banner UI, la piattaforma puo' inviare email automatiche quando si superano soglie configurabili (tipicamente 80% e 100%). Le email vengono inviate all'amministratore tenant registrato; verifica la cartella spam se non ricevi notifiche attese.
Filtri tenant
Tutte le metriche sono filtrate automaticamente per il tuo tenant: vedi solo i dati della tua organizzazione.
Esportazione
Diverse tab supportano l'esportazione CSV dei dati visualizzati (conversazioni, attivita', costi). Cerca il pulsante Esporta in alto a destra delle tabelle.
Best practice
- Imposta una review settimanale — Panoramica + Conversazioni con feedback negativo
- Tieni d'occhio le quote oltre l'80% — non aspettare il messaggio "Quota esaurita" in chat
- Analizza i costi per categoria — se l'embedding domina, rivedi la frequenza di re-indicizzazione delle KB
- Filtra per source_app — separa il traffico organico da quello generato da integrazioni