Saltar para o conteúdo
KendorDocs

Define orçamentos de tokens para os agentes de IA

Para proprietários e editores ·

Limita o que o Claude Code e o Codex podem gastar com um orçamento de tokens por candidato em cada triagem e um limite mensal de tokens para toda a organização.

Há dois limites, e ambos são opcionais. Um Orçamento de tokens por candidato numa triagem limita o que o agente de um candidato pode gastar nessa triagem. Um Limite mensal de tokens em Integrações limita o que todos os candidatos em conjunto podem gastar num mês de calendário. Quando um dos dois se esgota, a chamada seguinte do agente é recusada com uma mensagem clara no terminal. Sem nenhum definido, o gasto só é limitado pela tua conta de fornecedor.

O que conta como token

Ambos os limites contam o que o agente lê e escreve: a nova entrada enviada ao modelo mais a saída do modelo. O contexto em cache não é contado. Os agentes de programação reenviam a conversa inteira a cada turno, e essa parte repetida é servida a partir da cache do fornecedor, por isso, de outra forma, consumiria um orçamento sem refletir trabalho novo.

O Claude Code e o Codex gastam do mesmo orçamento. Um candidato que use os dois gasta de um único total. Os orçamentos só se aplicam com as chaves da tua organização: com a conta do próprio candidato, o Kendor não conta tokens.

Orçamento por candidato numa triagem

Os editores e os proprietários definem isto no construtor de triagens, junto ao interruptor que liga os agentes.

  1. Liga os Assistentes de IA no terminal em Opções, na barra lateral das definições.
  2. Indica um número em Orçamento de tokens por candidato. A unidade são milhões de tokens, por isso 1 significa um milhão e 0.5 meio milhão.
  3. Deixa o campo vazio para não ter limite. A barra lateral lembra-te então: "Sem limite definido. O gasto de um candidato é limitado apenas pela sua conta no fornecedor."

O orçamento é por tentativa de candidato e é somado entre todos os desafios da triagem, por isso uma triagem de três desafios com um orçamento de 2 dá ao candidato 2 milhões de tokens no total, não 2 milhões por desafio. A utilização mantém-se quando a sandbox reinicia ou o candidato volta mais tarde, por isso reiniciar não a repõe a zero.

Podes alterar o orçamento enquanto os candidatos estão a meio da triagem. As sandboxes em execução adotam o novo limite de imediato.

O que o candidato vê

Um pequeno anel no cabeçalho do editor vai enchendo à medida que o agente trabalha. Ao passar o rato por cima mostra, por exemplo, "Tokens de IA: 400k de 1M usados". Fica âmbar aos 80% com "Estás perto do orçamento de tokens de IA desta triagem", para que ficar sem tokens nunca seja o primeiro sinal. Quando se esgota, a dica diz "O orçamento de tokens de IA desta triagem esgotou-se".

Limite mensal da organização

Os proprietários definem isto na página do Claude Code ou do Codex em Integrações → Assistentes de IA. Ambas as páginas mostram o mesmo campo, porque os dois agentes partilham um único limite.

  1. Indica um número em Limite mensal de tokens, em milhões de tokens.
  2. Escolhe Guardar.
  3. Deixa vazio para Sem limite.

Por baixo do campo vês o gasto deste mês, como "6,4M de 20M tokens usados este mês". O mês segue os meses de calendário UTC e volta a zero no dia 1.

O limite abrange todas as chamadas de agentes faturadas às tuas chaves: candidatos em triagens, entrevistas de programação ao vivo e as sandboxes da tua própria equipa no construtor.

Dica. Se usares a federação de identidade para o Claude Code, podes também pôr um limite de gastos no workspace da Anthropic no teu Claude Console. Esse limite é aplicado pela Anthropic, além dos limites do Kendor.

Entrevistas de programação ao vivo

As entrevistas de programação ao vivo não têm orçamento por candidato. A utilização de agentes numa sessão ao vivo conta apenas para o Limite mensal de tokens da tua organização, por isso define um se quiseres um teto aí.

Quando um orçamento se esgota

O gateway do Kendor verifica o orçamento antes de reencaminhar cada chamada, incluindo as chamadas que já estão a correr em paralelo. Assim que um limite é atingido, a chamada seguinte não é enviada à Anthropic nem à OpenAI, e o agente mostra uma destas mensagens no terminal:

Limite atingido Mensagem
Orçamento de tokens por candidato "The AI token budget for this assessment has been used up"
Limite mensal de tokens "The hiring organization's monthly AI token limit has been reached"

O turno que já estava em curso termina, por isso a última contagem pode ficar ligeiramente acima do limite. O candidato pode continuar a trabalhar sem o agente: o editor, o terminal, os testes e a pré-visualização não são afetados.

Para deixar um candidato continuar com o agente, aumenta o orçamento da triagem ou o limite mensal. As sandboxes em execução adotam a alteração sem reiniciar.

Nota. Independentemente dos tokens, cada sessão de sandbox tem um limite fixo para o número de chamadas que os agentes podem fazer. Quando é atingido, o agente mostra "This session has reached its AI usage limit".

Onde a utilização aparece na revisão

Na página de revisão de uma submissão, o cabeçalho mostra o que o agente do candidato usou, como "IA 1,4M / 2M tokens" com orçamento ou "IA 1,4M tokens" sem ele. Ao passar o rato por cima explica que o valor é o que o assistente leu e escreveu durante a tentativa, sem contar o contexto em cache.

O total acumulado do mês da tua organização está nas páginas do Claude Code e do Codex em Integrações. Para uma discriminação de custos por modelo, usa a consola da Anthropic ou da OpenAI, onde a utilização é faturada.

Este artigo foi útil?