Wie begrenze ich einen KI-Agenten, der über Nacht läuft?
Zwei Limits halten einen unbeaufsichtigten Agenten davon ab, deine ganze Queue zu verbrennen: ein Budget pro Aufgabe, das Done bei start_run durchsetzt, und ein Limit für die ganze Nacht, das der Agent zwischen den Aufgaben abfragt. Was jedes erzwingt und was nicht.

Von Alejandro Rioja6 Min. Lesezeit
Nutze zwei Limits, denn sie stoppen Unterschiedliches. Ein Budget pro Aufgabe (Tool-Aufrufe, Minuten oder beides) begrenzt, wie viel eine einzelne Aufgabe verbrauchen darf, und Done setzt es durch: start_run wird abgelehnt, sobald die Aufgabe ihr ganzes Budget ausgegeben hat. Ein Nachtlimit (Aufgaben, Minuten, Tool-Aufrufe) begrenzt die ganze Sitzung, und der Agent muss danach fragen: Er ruft zwischen den Aufgaben check_night_budget auf und hört auf, wenn die Antwort stop sagt. Keines von beiden bricht einen Prozess mitten im Tool-Aufruf ab. Done führt dein Modell nicht aus; ein Limit ist also etwas, das dem Agenten gesagt wird und woran das Protokoll ihn misst, kein Notausschalter.
Warum reicht ein einziges Limit nicht?
Ein Budget auf einer Aufgabe sieht die anderen elf nicht. Ein Agent, der jede Aufgabe innerhalb ihres Budgets erledigt, kann trotzdem alle in einer Nacht abarbeiten. Umgekehrt scheitert es auch: Ein Nachtlimit ohne Budget pro Aufgabe lässt eine hartnäckige Aufgabe das gesamte Kontingent auffressen. Das Limit pro Aufgabe begrenzt die schlimmste Einzelaufgabe, das Nachtlimit die Summe.
Wie funktioniert das Budget pro Aufgabe?
Ein Mensch setzt budget_tool_calls und/oder budget_minutes auf einer Aufgabe. Ein Agent kann sein eigenes weder setzen noch erhöhen: create_task und update_task lehnen diese Felder ab, und der Weg zu mehr führt über ask_decision, das dich fragt.
- start_run öffnet einen Lauf auf der Aufgabe und liefert das Budget samt bisherigem Gesamtverbrauch, damit der Agent sich einteilen kann. Hat die Aufgabe ihr ganzes Budget über frühere Läufe schon verbraucht, wird start_run mit budget_exceeded abgelehnt, und ein Mensch muss das Budget erhöhen oder die Aufgabe übernehmen.
- check_budget liest das verbleibende Budget, ohne einen Lauf zu öffnen. Mitten in der Aufgabe heißt over_budget: true: aufhören und zurückgeben.
- end_run hält fest, was der Lauf verbraucht hat. Ein Lauf, der das Budget überschreitet, kann trotzdem abgeschlossen werden; er wird als over_budget verzeichnet. Der harte Stopp liegt also am Beginn eines Laufs, nicht mittendrin.
Wie funktioniert das Limit für die ganze Nacht?
Unter Konto & Einstellungen → Wo Agenten laufen → Nachtroutine legst du fest, wann ein Lauf stoppen soll: nach einer Anzahl von Aufgaben, Minuten oder Tool-Aufrufen. Der Agent ruft zwischen den Aufgaben check_night_budget auf. Es liefert für jede Dimension Limit, Verbrauch und Rest sowie stop und einen Grund. Das Standardfenster sind die letzten 12 Stunden, sodass der Verbrauch von gestern Nacht nicht gegen heute zählt.
Die Summen werden aus den auf deinem Konto erfassten Läufen gezählt, nicht aus einem Zähler im Speicher des Agenten. Stürzt die Routine mitten in der Nacht ab und startet neu, übernimmt sie dieselben Summen, statt bei null zu beginnen und die Nacht unbemerkt zu verdoppeln. Nur deine eigenen Läufe zählen gegen deine Limits; die eines Teammitglieds in einem gemeinsamen Workspace nicht.
Ist stop true, lautet die Anweisung an den Agenten: end_run mit einer Zusammenfassung, release_task, damit die Übernahme die Aufgabe nicht blockiert, und den Rest in der Queue lassen. Die Zusammenfassung ist wichtig. Eine Nacht, die nach vier von acht Aufgaben stoppte, liest sich wie „alles erledigt“, wenn der Agent nicht sagt, was liegen blieb.
Stoppt Done den Agenten am Nachtlimit tatsächlich?
Nein. check_night_budget ist beratend: eine Abfrage, die dem Agenten sagt, er soll aufhören. Ein Agent, der sie nie aufruft, wird nie davon gestoppt. Die Schaltfläche Runner-Prompt kopieren unter Wo Agenten laufen (die Anweisung, der dein geplanter Lauf folgt) weist den Agenten an, am Anfang start_run, vor jeder Aufgabe check_night_budget und am Ende end_run aufzurufen; ein darauf aufbauender Lauf tut das also. Schreibst du einen eigenen Runner, baue diese drei Aufrufe ein.
Was unabhängig vom Agenten gilt: das Freigabe-Gate. Was auch immer er verbraucht, eine Aufgabe ohne Markierung agent_ok erreicht „erledigt“ nur durch deine Freigabe; eine außer Kontrolle geratene Nacht erzeugt also eine längere Prüf-Queue, keinen Haufen geschlossener Aufgaben. Und pause_board, oder die Pause in der App, teilt allen Agenten auf dem Board keine Arbeit mehr zu, bis du fortsetzt. Der Agent kann sie auch selbst aufrufen, wenn er den ganzen Lauf schieflaufen sieht.
Wie sehe ich, was eine Nacht tatsächlich gekostet hat?
Jeder Lauf hinterlässt eine Spur in der Aktivität der Aufgabe, mit Tool-Aufrufen, Minuten und, falls der Agent sie meldet, Tokens, plus einem optionalen trace_url zum Sitzungsprotokoll. get_agent_economics meldet Läufe, Tool-Aufrufe und Minuten pro Agent sowie die Freigabequote dieser Arbeit, nur in Einheiten. Done speichert keinen Währungsbetrag und nennt dir daher keine Dollar.
Eine sinnvolle Startkonfiguration
- Lass nur Aufgaben mit Akzeptanzkriterien unbeaufsichtigt laufen, damit der Agent weiß, was „erledigt“ heißt.
- Setze ein Tool-Call-Budget pro Aufgabe bei allem Offenen; kurze Aufgaben lässt du ohne Limit.
- Setze ein Nachtlimit, das deutlich vor deiner Schmerzgrenze stoppt: ein paar Aufgaben und ein Zeitlimit, dann erhöhe es nach ein paar guten Nächten.
- Nutze den Runner-Prompt oder stelle sicher, dass dein eigener Runner start_run, check_night_budget und end_run aufruft.
- Lies morgens Needs you: was geliefert wurde, was auf Freigabe wartet, was auf eine Antwort wartet.
Häufige Fragen
Kann ein KI-Agent sein eigenes Budget erhöhen?
Nein. create_task und update_task lehnen budget_tool_calls und budget_minutes ab. Für mehr ruft der Agent ask_decision auf, und ein Mensch entscheidet.
Was passiert, wenn einer Aufgabe das Budget ausgeht?
start_run wird mit budget_exceeded abgelehnt, sodass auf dieser Aufgabe kein neuer Lauf beginnen kann, bis ein Mensch das Budget erhöht oder sie übernimmt. Ein laufender Lauf wird nicht abgebrochen; überschreitet er das Budget, verzeichnet end_run ihn als over_budget.
Setzt Done das Nachtlimit durch?
Nein, es ist beratend. check_night_budget meldet Limits, Verbrauch und ein stop-Flag, und der Agent soll aufhören, wenn es das anzeigt. Der Runner-Prompt von Done enthält diese Prüfung; ein eigener Runner muss sie aufrufen.
Wird das Nachtlimit zurückgesetzt, wenn meine Routine abstürzt und neu startet?
Nein. Der Verbrauch wird aus den auf deinem Konto erfassten Läufen im Fenster (standardmäßig 12 Stunden) summiert, ein Neustart sieht also dieselben Summen, statt bei null zu beginnen.
Wie stoppe ich alle Agenten auf einmal?
Pausiere das Board. Kein Agent bekommt Arbeit zugeteilt, bis du fortsetzt. Der Artikel über das Pausieren eines in einer Schleife festhängenden Agenten erklärt den Unterschied zwischen einer pausierten Aufgabe und einem pausierten Board.