Budget AI sotto controllo. Anche quando i job non dormono.
Un tetto mensile, un ledger per ogni chiamata e un kill switch che ferma la spesa prima che diventi una sorpresa. La Cost Governance copre tutti i percorsi AI del plugin, non solo quelli nuovi.
Un tetto, un interruttore, un registro
La maggior parte dei progetti scopre il costo delle API AI quando arriva la fattura. Cost Governance porta la decisione prima: imposti il budget mensile, il plugin stima e prenota ogni chiamata, e a fine corsa chiude i conti.
- Budget mensile in euro, con azzeramento all'inizio del periodo
- Kill switch automatico al 100% e blocco manuale sempre disponile
- Le nuove chiamate a pagamento vengono rifiutate, non messe in loop
- Riassunti, ricerca e diagnostica mantengono un fallback locale
- Avvisi in admin e notifica email quando la spesa avanza
- Riattivazione immediata dopo l'aumento del budget o il ripristino dei costi
gop_ai_usage: ogni chiamata lascia una traccia
Niente stime a posteriori. Il ledger registra il consumo al momento della chiamata, con abbastanza contesto per capire da dove arriva la spesa.
| Campo | Cosa registra | A cosa serve |
|---|---|---|
provider | Il provider AI chiamato: OpenAI, Anthropic, Gemini. | Separare i costi per fornitore. |
model | Il modello esatto utilizzato. | Confrontare consumo e qualità tra modelli. |
operation | Riassunto, embedding, vision, diagnostica, RAG. | Capire quale funzione pesa di più. |
tokens_in / tokens_out | Token di input e output della singola richiesta. | Ricostruire il consumo reale. |
cost_estimated / cost_actual | Costo stimato prima e costo registrato dopo. | Misurare lo scostamento della stima. |
object_ref | Post, allegato o job che ha generato la chiamata. | Risalire al contenuto o all'immagine. |
created_at | Data e ora della chiamata. | Aggregare per giorno, mese e periodo. |
Tariffario prudente, per scelta
Le stime non devono essere ottimistiche. GEO Optimizer Pro usa un tariffario per provider e modello, distingue input e output e applica la regola più conservativa quando il modello non è mappato.
- Prezzo per milione di token di input e di output
- Modello sconosciuto associato alla tariffa più alta conosciuta
- Arrotondamento per eccesso nelle stime
- Valuta coerente con il budget configurato
- Costo effettivo registrato quando il provider lo restituisce
estimated_tokens = prompt + max_completion
estimated_cost = ceil(input * price_in + output * price_out)
budget.reserve(estimated_cost)
// dopo la risposta
budget.release(estimated_cost - actual_cost)
ledger.write(actual_cost)
Meglio un margine di sicurezza che una sorpresa in fattura. Se il costo reale è inferiore, la differenza torna disponibile.
La prenotazione avviene prima, il conguaglio dopo
Con più job in parallelo, due chiamate non possono prenotare lo stesso euro. La reserve è atomica: o entra nel budget, o la chiamata non parte.
Stima del costo
Il plugin calcola i token di input, la lunghezza massima attesa dell'output e applica il tariffario conservativo del provider e del modello.
Reserve atomica
L'importo viene prenotato sul budget mensile con un'operazione atomica. Se il budget residuo non basta, la chiamata viene rifiutata prima di consumare credito.
Chiamata al provider
Solo dopo la prenotazione parte la richiesta. I job concorrenti vedono il budget aggiornato e non possono superare il tetto complessivo.
Release del residuo
Quando arriva la risposta, la differenza tra stima e costo reale viene rilasciata. Il budget torna disponibile per le chiamate successive.
Scrittura nel ledger
La riga in gop_ai_usage chiude il ciclo con token, costo stimato, costo effettivo e riferimento all'oggetto. Ogni euro è ricostruibile.
Ogni percorso AI passa dallo stesso controllo
Un budget che protegge solo le funzioni nuove non è un budget. La governance copre riassunti, embeddings, vision, diagnostica, RAG e i percorsi legacy.
| Percorso AI | Cosa passa dal budget | Se il budget è esaurito |
|---|---|---|
| Riassunti AI | Chiamate ai provider per generare e confrontare i riassunti. | Fallback all'algoritmo locale. |
| Embeddings RAG | Batch di embedding per i chunk semantici. | Ricerca keyword, nessun embedding nuovo. |
| Vision 2.0 | Audit delle singole immagini. | Il job resta in coda, nessun addebito. |
| Diagnostica | Drift, content gap e scansioni che usano l'AI. | Esecuzione locale o posticipata. |
| Risposte RAG | Risposta grounded con citazioni validate. | Ricerca keyword e contenuti esistenti. |
| Percorsi legacy summary | Le vecchie pipeline di riassunto. | Stesse regole di reserve e release. |
Tre soglie, nessun effetto sorpresa
La spesa avanza per gradi e il plugin lo dice prima che sia troppo tardi. Ogni soglia ha un comportamento chiaro e verificabile.
50% — Avviso
Un avviso in admin segnala che metà del budget è stata utilizzata. È il momento utile per controllare quali operazioni stanno consumando di più.
80% — Allerta
L'avviso diventa più evidente e viene inviata una notifica email. Puoi ridurre i batch, pianificare i job o alzare il budget prima del blocco.
100% — Stop
Il kill switch blocca le nuove chiamate a pagamento. Le funzioni locali restano attive, il ledger conserva tutto e la riattivazione è immediata dopo l'aumento del budget.
Tab Usage & API
Il pannello dedicato mostra spesa del mese, budget residuo, ripartizione per provider, modello e operazione, oltre ai job che hanno generato le chiamate più costose.
- Filtri per periodo, provider, modello e operazione
- Confronto tra costo stimato e costo effettivo
- Top consumer per contenuto, immagine o job
- Accesso rapido al ledger completo
Export e report
Il ledger è esportabile in CSV con i filtri applicati. Il riepilogo dei costi entra nei report white-label, così il cliente vede valore e spesa nello stesso documento.
- Export CSV del periodo selezionato
- Riepilogo costi nel report programmato
- KPI costi accanto a citazioni e traffico AI
- Dati pronti per il controllo di gestione
Budget e costi AI, senza zone grigie
Il budget è mensile o per singola operazione?
Il tetto è mensile e si applica a tutte le chiamate a pagamento. Ogni singola operazione viene comunque stimata, prenotata e registrata nel ledger gop_ai_usage.
Cosa succede quando raggiungo il 100% del budget?
Scatta il kill switch: le nuove chiamate a pagamento vengono bloccate, mentre le funzioni locali continuano a funzionare. Puoi alzare il budget o riattivare le chiamate manualmente.
Dove finiscono i dati di consumo?
In gop_ai_usage, una riga per chiamata con provider, modello, operazione, token di input e output, costo stimato ed effettivo. Il ledger registra i metadati di consumo, non i prompt.
Le chiamate fallite consumano budget?
La prenotazione viene rilasciata per la parte non consumata. Se il provider addebita comunque la richiesta, il costo effettivo resta registrato nel ledger.
Quali funzioni sono coperte dal budget?
Riassunti AI, embeddings, Vision 2.0, diagnostica, risposte RAG e percorsi legacy: ogni chiamata a pagamento passa dalla stessa reserve e release.
Posso esportare i costi?
Sì. Dal tab Usage & API puoi filtrare per provider, modello, operazione e periodo, esportare il ledger in CSV e includere il riepilogo nei report.
Un budget chiaro vale più di una fattura da decifrare.
30 giorni di prova gratis, 14 giorni money back e tutte le funzioni Pro incluse. Cost Governance è nella licenza e protegge ogni chiamata AI del plugin.