Controllare i Consumi della PaaS

8.4.5 Report Consumi

La sezione Report Consumi del pannello di amministrazione ti offre un monitoraggio dettagliato dell'utilizzo delle risorse della tua piattaforma PaaS. Questa funzionalità ti permette di analizzare i consumi, ottimizzare le performance e gestire efficacemente i costi operativi.

Panoramica della sezione

I Report Consumi ti forniscono una visione completa dell'utilizzo della piattaforma attraverso:

  • Monitoraggio in tempo reale dei consumi per utente e Agente;

  • Analisi dettagliata dell'utilizzo delle API e dei modelli IA;

  • Gestione dei periodi di riferimento per analisi temporali;

  • Esportazione dati per analisi avanzate esterne.

Struttura dei report

La sezione è organizzata in due schede principali:

  • Consumi per Agente: analisi dell'utilizzo per singolo Agente e utente;

  • Consumi per chiave: monitoraggio dell'utilizzo delle chiavi API.

Controlli di navigazione

Periodo di riferimento

Puoi personalizzare il periodo di visualizzazione dei consumi:

  • Navigazione temporale: utilizza le frecce per spostarti tra periodi precedenti e successivi;

  • Mese corrente: clicca per visualizzare rapidamente i dati del mese in corso;

  • Periodo personalizzato: seleziona intervalli specifici (es. 01/07/2025 - 01/08/2025).

Funzionalità aggiuntive

  • Esporta CSV: scarica i dati in formato CSV per analisi esterne;

  • Aggiornamento dati: i report si aggiornano automaticamente con i consumi più recenti.

Scheda Consumi per Agente

Colonne della tabella

La tabella dei consumi per Agente mostra le seguenti metriche:

  • Utenti > Agent: utente proprietario dell'Agente;

  • Prompt Tokens: numero di token utilizzati nelle richieste;

  • Completion Tokens: numero di token generati nelle risposte;

  • Token Totali: somma totale dei token utilizzati;

  • Chat valide: numero di conversazioni completate;

  • Chat con Pensiero Profondo: sessioni che hanno utilizzato la memoria avanzata;

  • Risposte IA: numero di risposte generate dall'IA;

  • Risposte IA (Non conteggiate): risposte generate con modelli personalizzati;

  • Risposte IA con PP: risposte con Pensiero Profondo;

  • Risposte IA con PP (Non conteggiate): risposte PP con modelli personalizzati;

  • Documenti importati: numero di documenti elaborati;

  • Documenti importati (Non conteggiate): documenti elaborati con modelli personalizzati;

  • Media token per messaggio: consumo medio di token per interazione.

Esempio di dati

utente.esempio

  • Prompt Tokens: 14.516;

  • Completion Tokens: 1.780;

  • Token Totali: 16.296;

  • Chat valide: 6;

  • Chat con Pensiero Profondo: 2;

  • Risposte IA: 5;

  • Risposte IA (Non conteggiate): 2;

  • Risposte IA con PP: 2;

  • Documenti importati: 0 p;

  • Media token per messaggio: 1.810,67.

utente.sviluppo

  • Prompt Tokens: 2.199.180;

  • Completion Tokens: 30.361;

  • Token Totali: 2.229.541;

  • Chat valide: 20;

  • Chat con Pensiero Profondo: 1;

  • Risposte IA: 35;

  • Risposte IA (Non conteggiate): 0;

  • Risposte IA con PP: 1.

Scheda Consumi per chiave

Colonne della tabella

La tabella dei consumi per chiave API mostra:

  • Chiave: identificativo mascherato della chiave API utilizzata;

  • Prompt Tokens: token utilizzati nelle richieste;

  • Completion Tokens: token generati nelle risposte;

  • Token Totali: consumo totale di token per la chiave.

Esempio di dati

Provider-ModelA-Config

  • Configurazione: Provider-Q&A-Processing

  • Chiave: 7640860******o5I

  • Modello: modello-chat-versione

  • Prompt Tokens: 128.530;

  • Completion Tokens: 6.148;

  • Token Totali: 134.678.

Provider-ModelB-Config

  • Configurazione: Provider-ImportExport-Processing

  • Chiave: 7640860******o5I

  • Modello: modello-processing-versione

  • Prompt Tokens: [dati disponibili nel report].

Metriche monitorate

Principali indicatori

1. Account amministratori (solo per tenant)

  • Numero di admin attivi;

  • Limite massimo consentito.

2. Agenti conversazionali

  • Numero di Agenti attivi per utente e tenant;

  • Limite massimo consentito;

  • Pulsante "Mostra lista Agenti" per visualizzare l'elenco completo.

3. Chat valide

  • Numero di conversazioni completate per utente e tenant;

  • Limite applicabile quando configurato.

4. Risposte generate da IA

  • Numero totale di risposte generate per utente e tenant;

  • Limite massimo consentito;

  • Risposte IA non conteggiate: risposte generate con modelli personalizzati.

5. Documenti importati

  • Numero di pagine importate per utente e tenant;

  • Limite massimo consentito;

  • Pagine non conteggiate: pagine elaborate con modelli personalizzati.

Uso dei modelli personalizzati

Consumi non conteggiati

Quando utilizzi modelli linguistici personalizzati tramite chiavi API proprie:

  • Risposte generate: non vengono conteggiate nel limite standard;

  • Pagine importate: non vengono conteggiate nel limite standard;

  • Visualizzazione separata: questi consumi appaiono come "non conteggiati".

💡 Importante: i limiti di Agenti e chat valide per utente e tenant non sono influenzati dall'utilizzo delle proprie chiavi API.

Interpretazione dei dati

Analisi dei consumi

Per ogni metrica viene mostrato:

  • Valore di consumo: utilizzo effettivo rispetto ai limiti della piattaforma;

  • Limite massimo: soglia configurata per ogni voce (quando presente);

  • Consumi non conteggiati: utilizzo con modelli personalizzati.

Indicatori di performance

  • Media token per messaggio: efficienza delle conversazioni;

  • Rapporto Prompt/Completion: bilanciamento tra richieste e risposte;

  • Utilizzo Pensiero Profondo: adozione delle funzionalità avanzate.

Ottimizzazione dei consumi

Strategie di efficienza

  • Monitora regolarmente i pattern di utilizzo per identificare anomalie;

  • Analizza la media token per messaggio per ottimizzare l'efficienza;

  • Bilancia l'utilizzo tra modelli standard e personalizzati;

  • Esporta i dati periodicamente per analisi avanzate.

Gestione dei costi

  • Utilizza modelli personalizzati per ridurre i consumi conteggiati;

  • Ottimizza le conversazioni per ridurre il consumo di token;

  • Monitora l'utilizzo delle funzionalità premium;

  • Pianifica la crescita basandoti sui trend di consumo.

Best practices

  • Esporta regolarmente i dati in CSV per analisi dettagliate;

  • Confronta i consumi tra diversi periodi per identificare trend;

  • Identifica gli utenti con consumi anomali per ottimizzazioni mirate;

  • Documenta i pattern di utilizzo per future pianificazioni;

  • Configura alert personalizzati per soglie di consumo critiche.

La sezione Report Consumi ti fornisce gli strumenti necessari per una gestione efficiente e consapevole delle risorse della tua piattaforma PaaS, permettendoti di ottimizzare costi e performance basandoti su dati precisi e aggiornati.

Last updated