# Wie setzt man ein hartes Ausgabenlimit für eine Coding-Agent-Aufgabe? > Ein hartes Ausgabenlimit muss vor jedem Modell- oder kostenpflichtigen Tool-Aufruf von einem Gateway durchgesetzt werden, das das Aufgabenbudget kontrolliert. Reservieren Sie die maximalen Kosten, rechnen Sie die tatsächliche Nutzung ab, lehnen Sie zu teure Aufrufe ab und stoppen Sie mit einem brauchbaren Checkpoint. # Wie setzt man ein hartes Ausgabenlimit für eine Coding-Agent-Aufgabe? Ein hartes Budget ist Zugangskontrolle. Vor jedem kostenpflichtigen Aufruf muss ein vertrauenswürdiges Gateway beweisen, dass die maximal erlaubten Kosten in das Restguthaben passen. Nachträgliche Warnungen stoppen keine bereits entstandene Überschreitung. Berücksichtigen Sie Eingabe, maximale Ausgabe, Wiederholungen, Fallbacks, Unteragenten, Embeddings, Suche, Sandboxes und alle kostenpflichtigen Tools. ## Harte Limits und weiche Ziele trennen Nutzen Sie drei Werte: | Kontrolle | Zweck | Verhalten | |---|---|---| | Ziel | Erwartete Kosten | Warnen oder günstigeren Plan wählen | | Weiches Limit | Eskalationsschwelle | Genehmigung anfordern oder Qualität reduzieren | | Hartes Limit | Maximal genehmigte Ausgabe | Vor dem nächsten Aufruf ablehnen | Beispiel: Ziel $0.60, Genehmigung bei $0.90, Stopp bei $1.00. Das harte Limit gehört auf den Server, nicht nur in den Prompt. ## Jede kostenpflichtige Aktion über ein Gateway führen Geben Sie dem Agenten kurzlebige Zugangsdaten, die nur Ihr Gateway aufrufen. Es hängt `task_id` an, prüft das Budget, schätzt die Aktion und reserviert oder lehnt ab. Geben Sie keinen Provider-Schlüssel frei, der die Abrechnung umgeht. Wenden Sie dieselbe Regel auf Suche, Sandbox, Codeausführung und bezahlten Abruf an. ## Vorher reservieren und nachher abstimmen Schätzen Sie die Obergrenze aus bekannten Eingabe-Token und maximaler Ausgabe. Reservieren Sie atomar, führen Sie den Aufruf aus und ersetzen Sie die Reservierung durch die tatsächliche Nutzung. ```text remaining = hard_limit - committed_cost - open_reservations worst_case = input_cost + max_output_cost + tool_allowance if worst_case > remaining: reject("task_budget_exceeded") else: reserve(worst_case) call_provider() reconcile(actual_cost) ``` Atomare Reservierung verhindert, dass zwei Unteragenten dasselbe Guthaben verbrauchen. ## Mit einer versionierten Preisliste rechnen Speichern Sie den verwendeten Preis mit jeder Schätzung. Tarife ändern sich; vergangene Nutzung darf später nicht mit dem aktuellen Preis neu berechnet werden. Wenn der Provider finale Kosten liefert, bewahren Sie Schätzung und Betrag auf. Liefert er nur Token, verwenden Sie die vor dem Aufruf gewählte Preisliste. Planen Sie Puffer für unklare Tool-Kosten ein oder lehnen Sie nicht begrenzbare Aufrufe ab. ## Streaming sicher machen Reservieren Sie vor Stream-Start die gesamte erlaubte Ausgabe. Rechnen Sie Nutzung ab, nehmen Sie aber nicht an, dass das Schließen des Clients sofort die Abrechnung stoppt. Abbruch ist Optimierung, nicht Durchsetzungsgrenze. Setzen Sie Ausgabegrenze und Timeout pro Aufruf. Das Aufgabenlimit umfasst alle Streams, Wiederholungen und Fallbacks. ## Wiederholungen und Unteragenten einbeziehen Jeder Versuch belastet dasselbe Eltern-Ledger. Ein neues Budget pro Wiederholung hebt das Limit auf. Nutzen Sie hierarchische Budgets: | Ledger | Limit | Regel | |---|---:|---| | Elternaufgabe | $1.00 | Absolute Obergrenze | | Implementierungsagent | $0.55 | Nicht mehr als Restguthaben der Elternaufgabe | | Testanalyse | $0.25 | Gibt ungenutzte Reservierung zurück | | Abschlussprüfung | $0.20 | Läuft nur mit Restguthaben | Unterlimits sind Zuweisungen, kein zusätzliches Geld. ## Mit einem brauchbaren Checkpoint stoppen Passt die nächste Aktion nicht, geben Sie einen typisierten Fehler zurück und wiederholen Sie den abgelehnten Aufruf nicht. Erstellen Sie aus dem vorhandenen Kontext einen Checkpoint mit: * erledigten Änderungen und Tests; * offener Arbeit und blockierter Aktion; * aktuellem Repository-Zustand; * geschätztem Zusatzbudget; * Resume-Token oder Aufgaben-ID. So wird der Budgetstopp zur kontrollierten Übergabe. ## Provider-Kontrollen als Rückfallebene nutzen Kontolimits begrenzen den Schaden, sind aber selten genau pro Aufgabe. Sie können Repositories bündeln, verspätet aktualisieren oder Tool-Kosten auslassen. Auch bei einem Multimodell-Gateway wie Atlas Cloud bleibt das maßgebliche Ledger in Ihrer Orchestrierung. Speichern Sie Nutzungs-IDs für die Abstimmung; das Limit bleibt bei Modellwechseln bestehen. ## Das Limit wie eine Finanzkontrolle testen Testen Sie Parallelität, lange Streams, Timeouts, fehlende Nutzung, Wiederholungen, Fallbacks und Ledger-Ausfälle. Bei Ausfall des Budgetdienstes wird standardmäßig abgelehnt. Bestätigte Kosten plus Reservierungen dürfen nie die Obergrenze überschreiten. ## Fazit Ein echtes hartes Limit wird vor der Ausgabe mit atomaren Reservierungen und einem Ledger für alle kostenpflichtigen Aktionen durchgesetzt. Warnt das System erst danach, ist es Monitoring und kein hartes Limit. ## FAQ ### Ist max_tokens ein hartes Geldlimit? Nein. Es begrenzt die Länge einer Antwort, nicht Gesamtkosten, Eingabe-Token, Wiederholungen, Modellwechsel oder Tools. Ein Geldlimit benötigt ein Budget-Ledger für jede kostenpflichtige Aktion. ### Wo sollte das Agentenbudget durchgesetzt werden? In einem serverseitigen Gateway oder einer Orchestrierungsschicht, die alle Modell- und Tool-Aufrufe passieren müssen. Client-Zähler können umgangen werden oder bei Parallelität konkurrieren. ### Wie budgetiert man Streaming-Antworten? Reservieren Sie vor Öffnen des Streams die maximal erlaubten Ausgabekosten und rechnen Sie danach die gemeldete Nutzung ab. Nutzen Sie Abbruch beim Provider, verlassen Sie sich aber nicht allein darauf. ### Teilen Wiederholungen das ursprüngliche Budget? Ja. Wiederholungen, Fallbacks, Unteragenten und Auswertungen belasten dasselbe Ledger, sofern kein separates Budget ausdrücklich genehmigt wurde. ### Was geschieht bei zu kleinem Restbudget? Lehnen Sie den nächsten kostenpflichtigen Aufruf ab und lassen Sie aus dem vorhandenen Kontext einen Checkpoint mit erledigter Arbeit, offenen Punkten und Zusatzbudget erstellen. ### Können Provider-Kontolimits das Aufgabenlimit ersetzen? Meist nicht. Sie schützen das ganze Konto und können verzögert aktualisiert werden. Ein Aufgaben-Gateway isoliert sofort; das Kontolimit bleibt eine zusätzliche Sicherung.