# 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.