AI Budget
AI Budget
La vista AI Budget ti permette di impostare limiti di spesa in token e in denaro per prevenire costi API fuori controllo. I limiti possono essere applicati globalmente, per provider, per gruppo Joomla / ruolo WordPress, o per singolo utente.
Concetti
| Termine | Significato |
|---|---|
| Token cap | Numero massimo di token (input + output) permessi per periodo |
| USD cap | Spesa massima in dollari per periodo |
| Periodo | daily, weekly, o monthly (rolling) |
| Scope | Globale · Provider · Gruppo/Ruolo · Utente |
| Soglia alert | % del cap a cui viene inviata una notifica email |
I cap sono valutati in ordine: Utente → Gruppo → Provider → Globale. Vince il cap più restrittivo che si applica.
Lista budget
Vai su JoomlaAI → AI Budget.
La lista mostra tutte le regole budget attive:
| Colonna | Descrizione |
|---|---|
| Nome | Etichetta umana (es. "Cap mensile globale", "Editor — limite giornaliero") |
| Scope | Globale / Provider / Gruppo / Utente |
| Periodo | Giornaliero / Settimanale / Mensile |
| Token cap | Max token (vuoto = illimitato) |
| USD cap | Max USD (vuoto = illimitato) |
| Usato | Token / USD consumati nel periodo corrente |
| % | Bar chart del consumo |
| Alert | Stato alert 70% / 90% / 100% |
| Stato | Attivo / In pausa |
Creare una regola budget
Clicca Nuovo nella toolbar.
| Campo | Obbligatorio | Descrizione |
|---|---|---|
| Nome | Sì | Etichetta per questa regola |
| Scope | Sì | Globale / Provider / Gruppo / Utente |
| Target | Se scope ≠ Globale | Scegli il provider, gruppo, o utente |
| Periodo | Sì | Giornaliero / Settimanale / Mensile |
| Token cap | No | Lascia vuoto per illimitato |
| USD cap | No | Lascia vuoto per illimitato |
| Alert al 70% | ON | Invia email a 70% consumato |
| Alert al 90% | ON | Invia email a 90% consumato |
| Alert al 100% | ON | Invia email quando il cap è raggiunto |
| Azione al 100% | block o warn | Blocca le richieste o solo notifica |
| Stato | Sì | Attivo / In pausa |
Notifiche alert
Le email di alert vengono inviate all'indirizzo email dell'amministratore del sito quando una soglia viene superata.
Esempio oggetto email: [JoomlaAI] Budget alert — il gruppo Editor ha usato il 90% del cap mensile di token
Per cambiare il destinatario degli alert, aggiorna From email in Configurazione → Mail (Joomla) o Impostazioni → Email (WP).
Widget budget real-time
La Dashboard mostra una card KPI Budget usato. Quando una regola raggiunge il 90% diventa gialla; al 100% diventa rossa.
La vista Health Check mostra anche lo stato budget nella sezione Budget.
Modalità FREE_ONLY
Se non è configurata nessuna chiave API provider, il sistema entra in modalità FREE_ONLY: solo i provider locali (Ollama) sono disponibili e il tracking budget viene saltato. Mostrato come banner informativo sulla Dashboard e nelle pagine Budget.
Riferimento prezzi token
I costi token sono calcolati con i tassi in PricingHelper. Tassi approssimativi:
| Provider | Modello | Input (per 1M token) | Output (per 1M token) |
|---|---|---|---|
| Claude | Haiku 4.5 | $0.80 | $4.00 |
| Claude | Sonnet 4 | $3.00 | $15.00 |
| Claude | Opus 4.1 | $15.00 | $75.00 |
| OpenAI | GPT-4o mini | $0.15 | $0.60 |
| OpenAI | GPT-4o | $2.50 | $10.00 |
| Gemini | Flash 2.0 | $0.075 | $0.30 |
| Groq | Llama 3.3 70B | $0.59 | $0.79 |
Tassi approssimativi e soggetti a variazioni. Verifica sempre sulla pagina prezzi del provider.
Permessi
| Capability | Accesso |
|---|---|
joomlaai.budget / wpai_manage_budget | Creare e modificare regole budget |
core.admin / manage_options | Eliminare regole budget |
core.manage / wpai_dashboard | Vedere il budget (sola lettura) |
_Ultimo aggiornamento: 2026-05-19 · v2.5.3_
