Sai quanto costa ogni agente, ogni cliente, ogni chiamata
GuardrailX registra il costo di ogni chiamata con i listini dei provider: modello, token, agente, cliente e sessione. Lo vedi giorno per giorno nella Panoramica, chiamata per chiamata nel Registro, e lo esporti in CSV.
Piano Free per sempre: 5000 richieste al mese, senza carta di credito.
Il provider ti manda un totale. A te servono i dettagli.
Una fattura mensile non dice quale agente spende, per quale cliente, su quale modello. E senza questi numeri non sai cosa ottimizzare né quanto rifatturare.
Un numero solo
La console del provider mostra la spesa per chiave o per modello. Gli agenti e le loro esecuzioni non ci sono.
Quanto costa ogni cliente?
Se gli agenti lavorano per più clienti, la spesa di ognuno si perde nel totale.
Rifatturare a mano
Fogli di calcolo e stime per girare i costi dell’AI ai clienti, ogni mese.
Come funziona
Ogni chiamata passa da GuardrailX, che ne registra costo, token e tempi. Con qualche intestazione in più dici a chi appartiene.
-
1
Registra ogni chiamata
Costo calcolato sui listini dei provider, token (anche quelli di ragionamento), modello chiesto e usato, tempi, tentativi ed esito.
-
2
Dici di chi è la spesa
Con le intestazioni X-GuardrailX-Agent, -Customer, -Session, -Step, -Feature e -User ogni chiamata ha il suo agente, cliente, esecuzione e funzione.
-
3
Panoramica giorno per giorno
La spesa di ogni giorno contro il tuo limite, per modello, agente, cliente e mese, e tutto quello che GuardrailX ha fatto: soglie, instradamenti, loop fermati.
-
4
Registro con filtri ed export
Ogni chiamata con i suoi dettagli, filtri per agente, cliente, sessione, modello ed esito, vista per sessione ed esportazione CSV.
-
5
Avvisi e webhook
Email, webhook (Slack, Discord) o Telegram quando un limite si avvicina, viene superato o un loop viene bloccato.
Le intestazioni per l’attribuzione
Tutte facoltative: senza, vedi comunque la spesa per chiave e per modello. Ognuna aggiunge un modo di guardare i costi.
- I valori con accenti o simboli si mandano codificati (encodeURIComponent): GuardrailX li decodifica.
- GuardrailX le toglie prima di inoltrare la chiamata al provider.
- La Panoramica ti avvisa se poche chiamate hanno agente o sessione, le due che sbloccano di più.
// Node: di chi è ogni chiamata
const client = new OpenAI({
baseURL: 'https://agent.guardrailx.ai/openai/v1',
apiKey: process.env.GUARDRAILX_KEY,
defaultHeaders: {
'X-GuardrailX-Agent': 'agente-fatture',
'X-GuardrailX-Customer': cliente.id,
'X-GuardrailX-Session': lavoro.id,
'X-GuardrailX-Feature': 'estrazione',
'X-GuardrailX-User': utente.id
}
});
Cosa sblocca ogni intestazione
Il nome dell’intestazione e cosa vedi in più quando le chiamate la mandano.
| Intestazione | Cosa sblocca |
|---|---|
| X‑GuardrailX‑Agent | Spesa e limiti per agente, Autopilot e suggerimenti per agente |
| X‑GuardrailX‑Customer | Spesa per cliente e CSV per rifatturare; con Agency margine, limiti e report per cliente |
| X‑GuardrailX‑Session | Limite per esecuzione, anti-loop che ferma solo quell’esecuzione, confronti per sessione |
| X‑GuardrailX‑Step | Pagine rifatte fermate, pagine mancanti per file |
| X‑GuardrailX‑Feature | Autopilot diviso per funzione, regole di unicità per funzione |
| X‑GuardrailX‑User | Chi usa il chatbot, nel Registro e nel CSV |
Per chi gestisce agenti per i clienti
La spesa per cliente c’è in ogni piano. Con il piano Agency diventa una parte del tuo conto economico.
- Indichi quanto fatturi a ogni cliente e vedi il margine del mese in euro, al cambio BCE del giorno, con un avviso se scende sotto la soglia.
- Limiti di spesa e pausa per cliente: se un cliente esagera lo fermi da solo, gli altri continuano.
- Un report mensile per cliente con costi, chiamate, agenti e modelli, col nome e il logo della tua agenzia.
| Funzione | In quali piani |
|---|---|
| Spesa per cliente · Panoramica, filtro del Registro e CSV | Tutti i piani |
| Limiti e pausa per cliente · scheda Clienti | Agency |
| Margine e report · in euro, con il tuo logo | Agency |
Domande sul tracciamento dei costi
Salvate il testo dei miei prompt?
No. Il Registro mostra quali chiamate, di quale agente e modello, quando, quanto sono costate e con che esito; il testo di prompt e risposte resta nei log del tuo agente.
Come calcolate il costo di una chiamata?
Dai token che il provider dichiara nella risposta, con il listino di quel modello: input, output (ragionamento compreso) e token letti o scritti in cache hanno il loro prezzo. I costi sono in dollari, come i prezzi dei provider.
Devo mandare tutte le intestazioni?
No, sono tutte facoltative. Senza, vedi la spesa per chiave e per modello. Agente e sessione sono le due che sbloccano di più: la Panoramica ti avvisa se mancano.
Per quanto tempo restano le chiamate?
Lo storico delle richieste è di 90 giorni con Free e Base e di 365 giorni con Agency.
Posso esportare i dati?
Sì, in CSV dal Registro, anche con i filtri e nella vista per sessione: è il file da cui partire per rifatturare i clienti.
Posso vedere i costi in euro?
Nella scheda Clienti del piano Agency costi e margine sono in euro, al cambio BCE del giorno di ogni chiamata. Limiti e registro restano in dollari, come i listini dei provider.
Funzioni collegate
Limiti di spesa a ogni livello
Per progetto, chiave, agente e sessione, al giorno e al mese. Superato il limite, la chiamata si ferma prima di costare.
Autopilot
Prova da solo modelli più economici sulle tue chiamate, misura la qualità e sposta il traffico poco alla volta, tornando indietro se serve.
Impatto ambientale
Energia, CO₂e e acqua evitate da loop fermati e modelli più leggeri, stimate dai token, con export CSV per i report ESG.
Metti un tetto alla spesa prima del prossimo loop.
Inizia con il piano Free: 5000 richieste al mese, senza carta e senza scadenza.