VolundOS

Cotas e limites

A organização define quanto pode ser consumido — no total, por pessoa e por agente. Atingido o limite, a ação é barrada com uma mensagem clara, não com falha genérica.

Atualizado em 24 de agosto de 2026

Cotas e limites

Camada funcional

A organização define quanto pode ser consumido — no total, por pessoa e por agente. Quando o limite é atingido, a ação é barrada com uma mensagem clara em vez de uma falha genérica.

Tela de cotas da organização: o aviso de que os limites são em cascata e a grade com o teto da organização, o padrão por pessoa e o padrão por agente, para tokens, execuções e ambientes

Três níveis, e o que cada um significa

NívelO que ele limita
Organizaçãoo total que a organização inteira pode consumir — é o teto do plano
Padrão por pessoaquanto cada pessoa pode consumir, salvo ajuste próprio
Padrão por agentequanto cada agente pode consumir, salvo ajuste próprio

Qualquer um dos três pode ficar sem limite — e a tela diz isso com essas palavras, em vez de mostrar um número enorme que parece um teto de verdade.

Os três são combinados para chegar ao limite que de fato vale numa execução, e há duas coisas limitadas separadamente: quanto o agente pensa e quanto tempo de máquina ele usa.

Decidir e consumir são o mesmo passo

Verificar a cota e registrar o consumo acontecem juntos, e não em dois momentos. Parece detalhe e não é: com duas execuções disparadas ao mesmo tempo, verificar antes e registrar depois deixaria as duas passarem pelo mesmo último crédito — e a organização estouraria o teto que ela mesma definiu.

Na dúvida, deixa rodar

Se a checagem de cota não consegue ser feita — por indisponibilidade momentânea, por exemplo —, a ação é permitida e o problema é registrado. É uma decisão de produto, escrita e deliberada:

A imposição de cota nunca pode derrubar o produto. Só uma decisão genuína de bloqueio barra uma execução.

A consequência importa e vale dizer com todas as letras: cota é um limite de orçamento, não um mecanismo de segurança. Quem precisa de barreira que nunca cede — impedir uma ação perigosa, por exemplo — precisa de outro recurso: aprovação, ou guarda de ferramenta, que falham fechando.

Limite atingido é mensagem, não erro

Quando o limite barra de fato, o produto mostra um aviso explicando o que aconteceu. Não é texto de erro improvisado: é parte da tela, com a mesma atenção do resto.

O que dá para fazer, e onde

O que dá para fazerOnde
Definir o teto da organização e os padrões por pessoa e por agenteA tela de cotas da organização
Ver quanto já foi consumido, e por quemA tela de consumo, com as visões por agente e por pessoa
Ajustar a cota de um agente específicoA configuração daquele agente

On this page