Blog

Como coloco um limite em um agente de IA que roda durante a noite?

Dois limites impedem que um agente sem supervisão queime toda a sua fila: um orçamento por tarefa que o Done aplica em start_run e um teto para a noite inteira que o agente consulta entre as tarefas. O que cada um aplica e o que não aplica.

Por Alejandro Rioja6 min de leitura

Use dois limites, porque eles impedem coisas diferentes. Um orçamento por tarefa (chamadas de ferramentas, minutos ou ambos) limita quanto uma única tarefa pode consumir, e o Done o aplica: start_run é recusado quando a tarefa já gastou todo o orçamento. Um teto noturno (tarefas, minutos, chamadas de ferramentas) limita a sessão inteira, e o agente precisa consultá-lo: ele chama check_night_budget entre as tarefas e para quando a resposta diz stop. Nenhum dos dois interrompe um processo no meio de uma chamada de ferramenta. O Done não executa o seu modelo; então um limite é algo que se diz ao agente e que o registro cobra dele, não um botão de desligar.

Por que um único limite não basta?

Um orçamento em uma tarefa não enxerga as outras onze. Um agente que cuida de cada tarefa dentro do orçamento ainda pode trabalhar em todas em uma noite. O inverso também falha: um teto noturno sem orçamento por tarefa deixa uma tarefa teimosa consumir toda a cota. O limite por tarefa delimita a pior tarefa individual; o noturno delimita a soma.

Como funciona o orçamento por tarefa?

Uma pessoa define budget_tool_calls e/ou budget_minutes em uma tarefa. Um agente não pode definir nem aumentar o próprio: create_task e update_task recusam esses campos, e o caminho dele para pedir mais é ask_decision, que pergunta a você.

  • start_run abre uma execução na tarefa e devolve o orçamento e o uso acumulado até agora, para o agente se dosar. Se a tarefa já gastou todo o orçamento em execuções anteriores, start_run é recusado com budget_exceeded, e uma pessoa precisa aumentar o orçamento ou assumir a tarefa.
  • check_budget lê o orçamento restante sem abrir uma execução. No meio da tarefa, over_budget: true significa parar e devolver o controle.
  • end_run registra o que a execução gastou. Uma execução que passa do orçamento ainda pode ser encerrada; ela fica registrada como over_budget. Ou seja, a parada firme está no início de uma execução, não no meio.

Como funciona o teto da noite inteira?

Em Conta e configurações → Onde os agentes rodam → Rotina noturna você escolhe quando uma execução deve parar: após um número de tarefas, minutos ou chamadas de ferramentas. O agente chama check_night_budget entre as tarefas. Ele devolve o teto, o usado e o restante de cada dimensão, além de stop e um motivo. A janela padrão são as últimas 12 horas, então o gasto da noite passada não conta contra esta.

Os totais são contados a partir das execuções registradas na sua conta, não de um contador na memória do agente. Se a rotina travar e reiniciar no meio da noite, ela retoma os mesmos totais em vez de começar do zero e dobrar a noite sem ninguém perceber. Só as suas próprias execuções contam contra os seus tetos; as de um colega em um espaço compartilhado não.

Quando stop é true, a instrução ao agente é: end_run com um resumo, release_task para que a reivindicação não deixe a tarefa presa e deixar o resto na fila. O resumo importa. Uma noite que parou em quatro de oito tarefas parece «tudo resolvido» se o agente não disser o que deixou de fazer.

O Done realmente para o agente no teto noturno?

Não. check_night_budget é consultivo: é uma leitura que diz ao agente para parar. Um agente que nunca o chama nunca é parado por ele. O botão Copiar o prompt do executor em Onde os agentes rodam (a instrução que sua execução agendada segue) manda o agente chamar start_run no início, check_night_budget antes de cada tarefa e end_run no fim; então uma execução baseada nele faz isso. Se você escreve seu próprio runner, inclua essas três chamadas.

O que vale independentemente do agente: o portão de aprovação. Gaste o que gastar, uma tarefa que não esteja marcada como agent_ok só chega a concluída com a sua aprovação; uma noite descontrolada gera uma fila de revisão maior, não uma pilha de tarefas fechadas. E pause_board, ou a pausa no app, deixa de entregar trabalho a todos os agentes do quadro até você retomar. O agente também pode chamá-lo, caso veja a execução inteira dando errado.

Como vejo quanto uma noite realmente custou?

Cada execução deixa um rastro na atividade da tarefa, com chamadas de ferramentas, minutos e, se o agente os informar, tokens, além de um trace_url opcional para a transcrição da sessão. get_agent_economics informa execuções, chamadas de ferramentas e minutos por agente e a taxa de aprovação desse trabalho, apenas em unidades. O Done não guarda nenhum valor em moeda, então não vai dizer dólares.

Uma configuração inicial sensata

  • Rode sem supervisão apenas tarefas com critérios de aceitação, para o agente saber o que significa concluído.
  • Defina um orçamento de chamadas de ferramentas por tarefa em tudo que for aberto; deixe as tarefas curtas sem teto.
  • Defina um teto noturno que pare bem antes de incomodar: algumas tarefas e um limite de tempo, e aumente depois de algumas noites boas.
  • Use o prompt do executor, ou garanta que o seu próprio runner chame start_run, check_night_budget e end_run.
  • Leia o Needs you de manhã: o que foi entregue, o que aguarda aprovação, o que aguarda uma resposta.

Perguntas frequentes

Um agente de IA pode aumentar o próprio orçamento?

Não. create_task e update_task recusam budget_tool_calls e budget_minutes. Para pedir mais, o agente chama ask_decision e uma pessoa decide.

O que acontece quando uma tarefa fica sem orçamento?

start_run é recusado com budget_exceeded, então nenhuma execução nova pode começar nessa tarefa até que uma pessoa aumente o orçamento ou assuma. Uma execução em andamento não é interrompida; se passar do orçamento, end_run a registra como over_budget.

O Done aplica o teto noturno?

Não, ele é consultivo. check_night_budget informa os tetos, o uso e um sinalizador stop, e espera-se que o agente pare quando ele indicar. O prompt do executor que o Done fornece inclui essa checagem; um runner próprio precisa chamá-la.

O teto noturno zera se a minha rotina travar e reiniciar?

Não. O uso é somado a partir das execuções registradas na sua conta na janela (12 horas por padrão), então um reinício vê os mesmos totais em vez de começar do zero.

Como paro todos os agentes de uma vez?

Pause o quadro. Nenhum agente recebe trabalho até você retomar. Veja o artigo sobre pausar um agente preso em um loop para a diferença entre pausar uma tarefa e pausar o quadro.

Continue lendo

Deixe a IA concluir sua lista de tarefas.

Grátis para começar. Sem cartão.