Vai al contenuto
KendorDocs

Imposta i budget di token per gli agenti IA

Per proprietari ed editor ·

Limita ciò che Claude Code e Codex possono spendere con un budget di token per candidato su ogni prova e un limite mensile di token per l'intera organizzazione.

Ci sono due limiti, entrambi facoltativi. Un Budget di token per candidato su una prova limita ciò che l'agente di un singolo candidato può spendere su quella prova. Un Limite mensile di token in Integrazioni limita ciò che tutti i candidati insieme possono spendere in un mese di calendario. Quando uno dei due si esaurisce, la chiamata successiva dell'agente viene rifiutata con un messaggio chiaro nel terminale. Se nessuno dei due è impostato, la spesa è vincolata solo dal tuo account presso il fornitore.

Che cosa conta come token

Entrambi i limiti contano ciò che l'agente legge e scrive: il nuovo input inviato al modello più l'output del modello. Il contesto in cache non viene contato. Gli agenti di programmazione rinviano l'intera conversazione a ogni turno, e quella parte ripetuta viene servita dalla cache del fornitore, quindi altrimenti consumerebbe un budget senza riflettere alcun lavoro nuovo.

Claude Code e Codex attingono dallo stesso budget. Un candidato che usa entrambi spende da un unico totale. I budget valgono solo con le chiavi della tua organizzazione: con l'account del candidato, Kendor non conta i token.

Budget per candidato su una prova

Editor e proprietari lo impostano nel costruttore della prova, accanto all'interruttore che attiva gli agenti.

  1. Attiva gli Assistenti IA nel terminale sotto Opzioni nella colonna delle impostazioni.
  2. Inserisci un numero in Budget di token per candidato. L'unità sono i milioni di token, quindi 1 significa un milione e 0.5 mezzo milione.
  3. Lascia il campo vuoto per nessun limite. La colonna ti ricorda allora: "Nessun limite impostato. La spesa di un candidato è vincolata solo dal tuo account presso il fornitore."

Il budget è per tentativo del candidato e viene sommato su tutte le sfide della prova, quindi una prova con tre sfide e un budget di 2 dà al candidato 2 milioni di token in totale, non 2 milioni per sfida. L'utilizzo viene conservato quando la sandbox si riavvia o il candidato torna più tardi, quindi un riavvio non lo azzera.

Puoi cambiare il budget mentre i candidati sono a metà prova. Le sandbox in esecuzione applicano subito il nuovo limite.

Che cosa vede il candidato

Un piccolo anello nell'intestazione dell'editor si riempie mentre l'agente lavora. Passandoci sopra si legge, ad esempio, "Token IA: 400k di 1M usati". Diventa ambra all'80% con "Sei vicino al budget di token IA di questa prova", così l'esaurimento non è mai il primo segnale. Una volta esaurito, il tooltip dice "Il budget di token IA di questa prova è esaurito".

Limite mensile per l'organizzazione

I proprietari lo impostano nella pagina Claude Code o Codex sotto Integrazioni → Assistenti IA. Entrambe le pagine mostrano lo stesso campo, perché i due agenti condividono un unico limite.

  1. Inserisci un numero in Limite mensile di token, in milioni di token.
  2. Scegli Salva.
  3. Lascialo vuoto per Nessun limite.

Sotto il campo vedi la spesa del mese, come "6.4M di 20M token usati questo mese". Il mese segue i mesi di calendario UTC e riparte da zero il 1°.

Il limite copre ogni chiamata dell'agente fatturata alle tue chiavi: i candidati nelle prove, i colloqui di coding dal vivo e le sandbox del tuo team nel costruttore.

Suggerimento. Se usi la federazione delle identità per Claude Code, puoi anche impostare un limite di spesa sul workspace Anthropic nella tua Claude Console. Quel limite viene applicato da Anthropic, in aggiunta ai limiti di Kendor.

Colloqui di coding dal vivo

I colloqui di coding dal vivo non hanno un budget per candidato. L'uso degli agenti in una sessione dal vivo conta solo per il Limite mensile di token della tua organizzazione, quindi impostane uno se vuoi un tetto anche lì.

Quando un budget si esaurisce

Il gateway di Kendor controlla il budget prima di inoltrare ogni chiamata, comprese quelle già in corso in parallelo. Una volta raggiunto un limite, la chiamata successiva non viene inviata ad Anthropic né a OpenAI, e l'agente mostra uno di questi messaggi nel terminale:

Limite raggiunto Messaggio
Budget di token per candidato "The AI token budget for this assessment has been used up"
Limite mensile di token "The hiring organization's monthly AI token limit has been reached"

Il turno già in corso termina, quindi l'ultimo conteggio può risultare leggermente sopra il limite. Il candidato può continuare a lavorare senza l'agente: l'editor, il terminale, i test e l'anteprima non sono interessati.

Per permettere a un candidato di continuare con l'agente, alza il budget della prova o il limite mensile. Le sandbox in esecuzione applicano la modifica senza riavvio.

Nota. Indipendentemente dai token, ogni sessione della sandbox ha un limite fisso al numero di chiamate che gli agenti possono effettuare. Quando viene raggiunto, l'agente mostra "This session has reached its AI usage limit".

Dove compare l'utilizzo nella revisione

Nella pagina di revisione di una consegna, l'intestazione mostra ciò che l'agente del candidato ha usato, come "IA 1.4M / 2M token" con un budget o "IA 1.4M token" senza. Passandoci sopra si spiega che la cifra è ciò che l'assistente ha letto e scritto durante il tentativo, con il contesto in cache non contato.

Il totale corrente del mese della tua organizzazione si trova nelle pagine Claude Code e Codex sotto Integrazioni. Per un dettaglio dei costi per modello, usa la console di Anthropic o di OpenAI, dove l'utilizzo viene fatturato.

Questo articolo ti è stato utile?