Blog

Comment limiter un agent IA qui travaille la nuit ?

Deux plafonds empêchent un agent sans surveillance d’avaler toute votre file : un budget par tâche que Done applique à start_run, et un plafond pour toute la nuit que l’agent consulte entre deux tâches. Ce que chacun applique, ou non.

Par Alejandro Rioja6 min de lecture

Utilisez deux plafonds, car ils n’arrêtent pas les mêmes choses. Un budget par tâche (appels d’outils, minutes, ou les deux) limite ce qu’une seule tâche peut consommer, et Done l’applique : start_run est refusé dès que la tâche a dépensé tout son budget. Un plafond de nuit (tâches, minutes, appels d’outils) limite toute la session, et c’est à l’agent de le demander : il appelle check_night_budget entre deux tâches et s’arrête quand la réponse dit stop. Aucun des deux ne tue un processus en pleine exécution d’un outil. Done n’exécute pas votre modèle : un plafond est une consigne donnée à l’agent, que l’historique lui oppose, pas un interrupteur.

Pourquoi un seul plafond ne suffit-il pas ?

Un budget sur une tâche ne voit pas les onze autres. Un agent qui traite chaque tâche dans son budget peut quand même toutes les traiter en une nuit. L’inverse échoue aussi : un plafond de nuit sans budget par tâche laisse une tâche têtue consommer toute l’enveloppe. Le plafond par tâche borne la pire tâche ; celui de la nuit borne la somme.

Comment fonctionne le budget par tâche ?

Une personne définit budget_tool_calls et/ou budget_minutes sur une tâche. Un agent ne peut ni fixer ni augmenter le sien : create_task et update_task refusent ces champs, et pour en obtenir plus il passe par ask_decision, qui vous interroge.

  • start_run ouvre une exécution sur la tâche et renvoie le budget et la consommation cumulée, pour que l’agent se règle. Si la tâche a déjà dépensé tout son budget sur les exécutions précédentes, start_run est refusé avec budget_exceeded, et une personne doit relever le budget ou reprendre la tâche.
  • check_budget lit le budget restant sans ouvrir d’exécution. En cours de tâche, over_budget: true signifie : arrêtez-vous et rendez la main.
  • end_run enregistre ce que l’exécution a dépensé. Une exécution qui dépasse le budget peut quand même être clôturée ; elle est notée over_budget. L’arrêt strict se situe donc au début d’une exécution, pas au milieu.

Comment fonctionne le plafond de toute la nuit ?

Dans Compte et réglages → Où tournent les agents → Routine nocturne, vous choisissez quand une exécution doit s’arrêter : après un certain nombre de tâches, de minutes ou d’appels d’outils. L’agent appelle check_night_budget entre deux tâches. Il renvoie le plafond, le consommé et le restant pour chaque dimension, ainsi que stop et un motif. La fenêtre par défaut est celle des 12 dernières heures : la dépense d’hier soir ne compte pas contre ce soir.

Les totaux sont calculés à partir des exécutions enregistrées sur votre compte, et non à partir d’un compteur en mémoire dans l’agent. Si la routine plante et redémarre en pleine nuit, elle retrouve les mêmes totaux au lieu de repartir de zéro et de doubler discrètement la nuit. Seules vos propres exécutions comptent pour vos plafonds ; celles d’un coéquipier dans un espace partagé, non.

Quand stop vaut true, la consigne à l’agent est : end_run avec un résumé, release_task pour que la prise en charge ne laisse pas la tâche bloquée, et laisser le reste en file. Le résumé compte. Une nuit arrêtée à quatre tâches sur huit se lit comme « tout est traité » si l’agent ne dit pas ce qu’il a laissé.

Done arrête-t-il vraiment l’agent au plafond de nuit ?

Non. check_night_budget est consultatif : c’est une lecture qui dit à l’agent de s’arrêter. Un agent qui ne l’appelle jamais n’est jamais arrêté par lui. Le bouton Copier le prompt d’exécution dans Où tournent les agents (la consigne que suit votre exécution planifiée) demande à l’agent d’appeler start_run au début, check_night_budget avant chaque tâche et end_run à la fin ; une exécution construite dessus le fait donc. Si vous écrivez votre propre runner, mettez ces trois appels.

Ce qui tient quoi que fasse l’agent : la porte d’approbation. Quoi qu’il dépense, une tâche qui n’est pas marquée agent_ok n’atteint « terminé » qu’avec votre approbation ; une nuit qui dérape produit donc une file de relecture plus longue, pas un tas de tâches closes. Et pause_board, ou la pause dans l’app, cesse de confier du travail à tous les agents du tableau jusqu’à ce que vous repreniez. L’agent peut aussi l’appeler, si toute l’exécution lui semble mal partie.

Comment voir ce qu’une nuit a réellement coûté ?

Chaque exécution laisse une trace dans l’activité de la tâche, avec les appels d’outils, les minutes et, si l’agent les déclare, les tokens, ainsi qu’un trace_url facultatif vers la transcription de la session. get_agent_economics rapporte les exécutions, appels d’outils et minutes par agent, et le taux d’approbation de ce travail, en unités seulement. Done ne stocke aucun montant en devise : il ne vous donnera pas de dollars.

Une configuration de départ raisonnable

  • Ne lancez sans surveillance que des tâches avec des critères d’acceptation, pour que l’agent sache ce que « terminé » veut dire.
  • Fixez un budget d’appels d’outils par tâche sur tout ce qui est ouvert ; laissez les tâches courtes sans plafond.
  • Fixez un plafond de nuit qui s’arrête bien avant de vous contrarier : quelques tâches et une limite de temps, puis relevez-le après quelques nuits réussies.
  • Utilisez le prompt d’exécution, ou assurez-vous que votre runner appelle start_run, check_night_budget et end_run.
  • Lisez Needs you le matin : ce qui est livré, ce qui attend votre approbation, ce qui attend une réponse.

Questions fréquentes

Un agent IA peut-il relever son propre budget ?

Non. create_task et update_task refusent budget_tool_calls et budget_minutes. Pour en demander plus, l’agent appelle ask_decision et une personne tranche.

Que se passe-t-il quand une tâche n’a plus de budget ?

start_run est refusé avec budget_exceeded : aucune nouvelle exécution ne peut démarrer sur cette tâche tant qu’une personne n’a pas relevé le budget ou repris la tâche. Une exécution en cours n’est pas tuée ; si elle dépasse le budget, end_run la note over_budget.

Done applique-t-il le plafond de nuit ?

Non, il est consultatif. check_night_budget rapporte les plafonds, la consommation et un indicateur stop, et l’agent doit s’arrêter quand il l’indique. Le prompt d’exécution fourni par Done inclut cette vérification ; un runner personnalisé doit l’appeler.

Le plafond de nuit est-il remis à zéro si ma routine plante et redémarre ?

Non. La consommation est additionnée à partir des exécutions enregistrées sur votre compte dans la fenêtre (12 heures par défaut) : un redémarrage retrouve les mêmes totaux au lieu de repartir de zéro.

Comment arrêter tous les agents d’un coup ?

Mettez le tableau en pause. Aucun agent ne reçoit de travail avant que vous repreniez. Voir l’article sur la pause d’un agent bloqué dans une boucle pour la différence entre mettre une tâche en pause et le tableau.

À lire aussi

Confiez votre liste de tâches à l’IA.

Gratuit pour commencer. Sans carte bancaire.