¿Cómo pongo un límite a un agente de IA que trabaja de noche?
Dos límites impiden que un agente desatendido consuma toda tu cola: un presupuesto por tarea que Done aplica en start_run y un tope de toda la noche que el agente consulta entre tareas. Qué aplica y qué no cada uno.

Por Alejandro Rioja6 min de lectura
Usa dos límites, porque detienen cosas distintas. Un presupuesto por tarea (llamadas a herramientas, minutos o ambos) limita lo que puede consumir una sola tarea, y Done lo aplica: start_run se rechaza cuando la tarea ya gastó todo su presupuesto. Un tope nocturno (tareas, minutos, llamadas a herramientas) limita toda la sesión, y el agente tiene que consultarlo: llama a check_night_budget entre tareas y se detiene cuando la respuesta dice stop. Ninguno corta un proceso a mitad de una llamada. Done no ejecuta tu modelo, así que un límite es algo que se le indica al agente y que el registro le exige, no un interruptor de apagado.
¿Por qué no basta con un solo límite?
Un presupuesto por tarea no ve las otras once. Un agente que atiende cada tarea dentro de su presupuesto aun así puede trabajarlas todas en una noche. Al revés también falla: un tope nocturno sin presupuesto por tarea deja que una tarea terca se coma toda la asignación. El límite por tarea acota la peor tarea individual; el nocturno acota la suma.
¿Cómo funciona el presupuesto por tarea?
Una persona define budget_tool_calls y/o budget_minutes en una tarea. Un agente no puede fijar ni subir el suyo: create_task y update_task rechazan esos campos, y su vía para pedir más es ask_decision, que te pregunta a ti.
- start_run abre una ejecución en la tarea y devuelve el presupuesto y el uso acumulado hasta ahora, para que el agente dosifique. Si la tarea ya gastó todo su presupuesto en ejecuciones anteriores, start_run se rechaza con budget_exceeded, y una persona debe subir el presupuesto o hacerse cargo de la tarea.
- check_budget lee el presupuesto restante sin abrir una ejecución. A mitad de tarea, over_budget: true significa parar y devolver el control.
- end_run registra lo que gastó la ejecución. Una ejecución que se pasa del presupuesto aún puede cerrarse; queda registrada como over_budget. Así que el freno duro está al inicio de una ejecución, no en medio.
¿Cómo funciona el tope de toda la noche?
En Cuenta y configuración → Dónde trabajan los agentes → Rutina nocturna eliges cuándo debe detenerse una ejecución: tras cierto número de tareas, minutos o llamadas a herramientas. El agente llama a check_night_budget entre tareas. Devuelve el tope, lo usado y lo restante de cada dimensión, además de stop y un motivo. La ventana por defecto son las últimas 12 horas, así que el gasto de anoche no cuenta contra esta noche.
Los totales se cuentan a partir de las ejecuciones registradas en tu cuenta, no de un contador en la memoria del agente. Si la rutina falla y se reinicia a mitad de la noche, retoma los mismos totales en lugar de empezar de cero y duplicar la noche sin que nadie lo note. Solo cuentan para tus topes tus propias ejecuciones; las de un compañero en un espacio compartido no.
Cuando stop es true, la instrucción al agente es: end_run con un resumen, release_task para que la reclamación no deje la tarea varada, y dejar el resto en cola. El resumen importa. Una noche que se detuvo en cuatro de ocho tareas parece «todo resuelto» si el agente no dice qué dejó pendiente.
¿Done detiene realmente al agente en el tope nocturno?
No. check_night_budget es consultivo: es una lectura que le dice al agente que pare. Un agente que nunca lo llama nunca es detenido por él. El botón Copiar prompt del runner en Dónde trabajan los agentes (la instrucción que sigue tu ejecución programada) le indica al agente llamar a start_run al principio, a check_night_budget antes de cada tarea y a end_run al final, así que una ejecución basada en él lo hace. Si escribes tu propio runner, incluye esas tres llamadas.
Lo que se mantiene pase lo que pase con el agente: la puerta de aprobación. Gaste lo que gaste, una tarea que no esté marcada agent_ok solo llega a hecha con tu aprobación, así que una noche descontrolada produce una cola de revisión más larga, no un montón de tareas cerradas. Y pause_board, o la pausa en la app, deja de asignar trabajo a todos los agentes del tablero hasta que lo reanudes. El agente también puede llamarla, para el caso en que vea que toda la ejecución va mal.
¿Cómo veo cuánto costó realmente una noche?
Cada ejecución deja un rastro en la actividad de la tarea, con llamadas a herramientas, minutos y, si el agente los informa, tokens, y un trace_url opcional a la transcripción de la sesión. get_agent_economics informa de ejecuciones, llamadas a herramientas y minutos por agente y de la tasa de aprobación de ese trabajo, solo en unidades. Done no guarda ninguna cifra en moneda, así que no te dirá dólares.
Una configuración inicial razonable
- Ejecuta de forma desatendida solo tareas con criterios de aceptación, para que el agente sepa qué significa hecho.
- Fija un presupuesto de llamadas a herramientas por tarea en lo que sea abierto; deja sin tope las tareas cortas.
- Fija un tope nocturno que pare bastante antes de que te moleste: unas pocas tareas y un límite de tiempo, y súbelo cuando varias noches hayan ido bien.
- Usa el prompt del runner, o asegúrate de que tu propio runner llame a start_run, check_night_budget y end_run.
- Lee Needs you por la mañana: qué se entregó, qué espera tu aprobación y qué espera una respuesta.
Preguntas frecuentes
¿Puede un agente de IA subir su propio presupuesto?
No. create_task y update_task rechazan budget_tool_calls y budget_minutes. Para pedir más, el agente llama a ask_decision y decide una persona.
¿Qué pasa cuando una tarea se queda sin presupuesto?
start_run se rechaza con budget_exceeded, así que no puede empezar ninguna ejecución nueva en esa tarea hasta que una persona suba el presupuesto o se haga cargo. Una ejecución en curso no se corta; si supera el presupuesto, end_run la registra como over_budget.
¿Done aplica el tope nocturno?
No, es consultivo. check_night_budget informa de los topes, el uso y una marca stop, y se espera que el agente pare cuando la marca lo indique. El prompt del runner que te da Done incluye esa comprobación; un runner propio tiene que llamarla.
¿Se reinicia el tope nocturno si mi rutina falla y se reinicia?
No. El uso se suma a partir de las ejecuciones registradas en tu cuenta dentro de la ventana (12 horas por defecto), así que un reinicio ve los mismos totales en lugar de empezar de cero.
¿Cómo detengo a todos los agentes a la vez?
Pausa el tablero. Ningún agente recibe trabajo hasta que lo reanudes. Consulta el artículo sobre pausar a un agente atascado en un bucle para ver la diferencia entre pausar una tarea y pausar el tablero.