# 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aisuru.com/paas/pannello-di-amministrazione/controllare-i-consumi-della-paas.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.