Limite de gastos e botão de parada para um agente de IA

Um agente sem limites é um cartão de crédito na mão de um estagiário rapidíssimo que nunca dorme. Na maioria das vezes está tudo bem. Na única vez em que uma ferramenta devolve um erro que o agente não entende, ele tenta de novo, lê o erro, tenta outra vez e segue até acabar o saldo da sua API.

Eu rodo muitos agentes e minha regra é simples: nenhum agente vai ao ar sem um teto de gasto, um limite de passos e um botão de parada. Nenhum deles é difícil de adicionar. Pular os três é que sai caro.

Por que os agentes gastam demais

Um script comum faz a mesma quantidade de trabalho toda vez. Um agente decide quanto trabalho fazer, e é para isso que se usa um. Esse também é o risco. Quatro causas explicam quase todas as contas fora de controle:

1. Loops de nova tentativa. Uma ferramenta falha, o agente tenta de novo com uma entrada um pouco diferente, falha outra vez e repete.
2. Contexto crescente. Cada passo se soma à conversa, então cada chamada custa mais que a anterior. Uma execução de 40 passos custa bem mais que 40 vezes uma de 1 passo.
3. Fan-out. O agente cria subtarefas, e cada uma cria outras.
4. Um gatilho que dispara demais. Uma tarefa agendada ou um webhook de entrada roda 500 vezes em vez de 5.

Detalhei os números do custo por chamada em AI agent cost math. Este artigo trata do teto, não da média.

Limite 1: um teto de gasto rígido

Defina dois números para cada agente: um gasto máximo por execução e um por dia.

Escolha-os pelo valor do trabalho. Se um agente tria sua caixa de entrada e economiza vinte minutos por dia, ele não pode gastar US$ 40 numa única execução. Um bom ponto de partida é cinco vezes o custo de uma execução normal. Se uma execução típica custa 20 centavos, limite cada execução a US$ 1 e cada dia a US$ 10. Você pode subir o teto na primeira vez que ele bloquear um trabalho legítimo, o que é um bom problema.

Dois lugares para aplicá-lo:

• No provedor. Defina um limite de gasto mensal no console da Anthropic ou da OpenAI. É a sua rede de segurança e leva dois minutos. Ele barra o pior cenário mesmo que o seu código esteja errado.
• No seu código. Mantenha uma contagem dos tokens usados durante a execução, converta em dólares e pare quando passar do teto por execução. Guarde o total do dia em um lugar durável para que uma reinicialização não o zere.

Limite 2: um número máximo de passos

O limite de passos é a proteção mais simples e pega loops que o teto em dólares detecta tarde demais. Decida o máximo de passos que uma execução saudável deveria dar, some uma margem e pare ali.

Se a sua execução normal mais longa usa 12 chamadas de ferramenta, fixe o limite em 25. Quando o agente chegar nele, não o deixe continuar em silêncio. Encerre a execução, registre o motivo e mande uma mensagem para você mesmo. Uma execução que bate no limite de passos é um relatório de bug, e você quer lê-lo.

A mesma ideia vale para chamadas idênticas repetidas: se o agente fizer a mesma chamada com a mesma entrada três vezes seguidas, pare-o. Isso é um loop, não progresso.

Limite 3: um botão de parada que dispensa deploy

Quando algo dá errado às 2 da manhã, você não quer editar código, recompilar e fazer deploy de novo. Você quer virar uma chave.

Um botão de parada é uma única flag que o agente consulta no início de cada passo, não só no início da execução. Se a flag diz parar, o agente para. Onde ela fica importa menos do que poder alterá-la pelo celular: uma chave em um armazenamento chave-valor, uma linha em um banco de dados ou uma variável de ambiente que a plataforma deixe editar sem novo deploy.

Cuide destes detalhes:

• Consulte com frequência. Uma flag lida só na inicialização não consegue parar uma execução em andamento.
• Torne a parada segura. O agente deve concluir ou desfazer a ação em curso, sem deixar um e-mail pela metade ou um agendamento feito pela metade.
• Falhe fechado. Se o agente não conseguir ler a flag, ele para. Um armazenamento de flags quebrado não pode significar gasto ilimitado.
• Teste uma vez. Vire a chave em uma cópia de staging e veja o agente parar. Um botão de parada nunca testado é só esperança.

Tratei de um controle relacionado, a etapa de aprovação, em human-in-the-loop agents. Aprovações barram ações ruins. Tetos barram gastos ruins. Você quer os dois.

Adicione alertas para saber primeiro

Os limites protegem o orçamento, mas você ainda precisa saber quando disparam. Envie uma mensagem em 50% e 80% do teto diário, e sempre que uma execução for cortada pelo limite de passos ou pelo botão de parada. E leia. Um alerta que você aprendeu a ignorar não vale nada, então se um deles dispara o tempo todo, corrija a causa ou ajuste o limite.

Se você também registra cada passo com um ID de rastreio, vê exatamente qual execução queimou o dinheiro. Descrevo essa configuração em how to debug an AI agent in production.

Prompt para adicionar os três limites

Você não precisa escrever isso sozinho. Abra o Claude na pasta onde está o código do seu agente e cole isto:

Read my agent's code. Add three safety limits and show me every file you change:
1. A per-run and per-day spending cap, computed from token usage. Read the limits
   from configuration, and stop the run with a clear logged reason when either is hit.
2. A maximum step count per run, plus a stop if the same tool is called with the same
   input three times in a row.
3. A kill switch: a flag checked before every step that stops the agent safely.
   If the flag can't be read, the agent must stop.
Then list what you assumed about where the flag should live, and give me a short
checklist to test each limit on a non-production copy.

Antes de confiar no resultado, confira três coisas: se a conta em dólares usa os preços atuais do seu modelo (o modelo pode inventá-los), se a flag é lida a cada passo e se você disparou cada limite uma vez e o viu funcionar. Modelos escrevem com prazer um teto que nunca dispara.

Comece com os números mais rígidos que você aguenta

Aperte os limites no primeiro dia e afrouxe-os com evidências. Um teto que bloqueia uma execução legítima custa alguns minutos. A falta de um teto pode custar um mês de orçamento numa noite. Coloque os limites antes de o agente tocar em qualquer coisa real, e o resto do projeto fica muito mais tranquilo.