Nutzung und Budget verfolgen

SupaCloud verfolgt zwei verschiedene Dinge, die begrenzen, wie viel Agenten-Arbeit ein Workspace leisten kann, und zeigt sie in zwei getrennten Oberflächen:

Abo-Auslastung – für Provider, die über ein OAuth-Abo verbunden sind (ein vorausbezahlter Tarif mit rollierenden Nutzungsfenstern). Du beobachtest, wie voll die Fenster sind, nicht was du ausgibst.
Dollar-Budget – für Provider, die pro Token über einen API-Key abgerechnet werden. Du legst ein monatliches USD-Limit fest und beobachtest die Ausgaben dagegen.

Die Auslastungsanzeigen liegen unter Einstellungen → Arbeitsbereich, und die Dollar-Budget-Karte liegt dort ebenfalls. Ein Workspace, der nur API-Keys nutzt, sieht ausschließlich die Budget-Oberfläche; ein Workspace mit einem Abo sieht zusätzlich die Auslastungsanzeigen.

Nutzung unter „Berichte“ finden

Der Bereich Berichte in der Seitenleiste ist die Heimat für alles, was du an einem Workspace misst. Seine Tabs sind:

Tab	Was er zeigt
Übersicht	Periodisch wählbare Diagramme, die die Agenten-Arbeit aufschlüsseln
Nutzung	Dieselben Werte zu Abo-Auslastung und Budget je Provider
Lieferung	Die Lieferübersicht je Agenten-Profil
Audit	Das Audit-Ereignisprotokoll
Operations	Die Operability-Ansicht des Tenants (Dispatch-Metriken, Routing, Circuit Breaker)

Der Tab Nutzung ist der Ort, an dem die unten beschriebenen Werte je Provider liegen. Öffne Berichte → Nutzung, um sie in der UI zu lesen, oder nutze die Web-Terminal-Befehle usage und budget aus den späteren Abschnitten.

Die Übersicht-Diagramme lesen

Berichte → Übersicht stellt die Agenten-Arbeit über einen von dir wählbaren Zeitraum dar (zum Beispiel den letzten Tag, die letzte Woche oder den letzten Monat). Die Aufschlüsselungen sind:

Nach Agent – Arbeit, die jedem Agenten-Profil zugeordnet ist.
Nach Modell – Arbeit, die jedem Modell zugeordnet ist.
Nach Lauf-Art – zum Beispiel interaktive Aufgabe, Workflow oder Backlog-Lauf.
Nach Projekt – Arbeit, die jedem Projekt zugeordnet ist.

Jede Aufgabe meldet außerdem die produzierten Codezeilen (LOC), vom Runner erfasst, sodass die Übersicht LOC neben Kosten und Lauf-Anzahl zeigen kann.

Die Übersicht liest GET /api/reports/overview.

Die Abo-Auslastungsanzeigen lesen

Jeder verbundene Abo-Provider stellt eine Anzeige pro Nutzungsfenster dar. Ein Fenster ist ein rollierendes Kontingent, das sich nach einem Zeitplan wieder auffüllt:

Fenster	Was es misst
5-Stunden-Fenster	Das rollierende 5-Stunden-Kontingent
Wöchentlich	Das rollierende Wochenkontingent
Monatlich	Das rollierende Monatskontingent (falls der Tarif eines hat)

Jede Anzeige zeigt:

Einen Füllbalken mit dem Prozentsatz des verbrauchten Fensters.
Einen Erneuerungs-Countdown – Setzt in X Std. Y Min. zurück oder Setzt bald zurück, wenn ein Fenster unmittelbar fällig ist.
Ein Geschätzt-Etikett, wenn der Wert aus Telemetrie statt aus einem vom Provider gemeldeten harten Limit stammt – behandle ihn als Schätzung mit geringerer Sicherheit.

Die Balkenfarbe gibt das Auslastungsband an:

Band	Bedeutung	Farbe
Unterhalb des Drosselungsbands	Komfortabler Spielraum	Primär (Türkis)
Bald gedrosselt	Innerhalb des Drosselungsbands – Verlangsamungen sind nah	Warnung (Bernstein)
Erschöpft	Das Fenster ist zu 100 % oder mehr gefüllt	Fehler (Rot)

Über das Web-Terminal

Dieselben Abo-Fenster sind im Web-Terminal verfügbar:

usage

Es listet jedes Abo-Fenster mit seinem Füllprozentsatz und einer Markierung exhausted, throttling soon oder refresh in Xm auf. Einem reinen API-Key-Workspace wird gesagt, stattdessen budget zu nutzen; einem Aufrufer ohne Admin-Rechte wird mitgeteilt, dass die Ansicht nur für Admins/Owner ist.

Ein Workspace-Budget festlegen

Die Karte KI-Budget steuert das monatliche Dollar-Limit und die Ausgaben für API-Mode-Agents (pro Token).

Öffne Einstellungen → Arbeitsbereich und finde die Karte KI-Budget. Sie zeigt Diesen Monat (bisherige Ausgaben), Verbleibend und ein Status-Abzeichen (OK / Warnung / Kritisch / Blockiert / Unbegrenzt).
Lege das Monatliche USD-Limit fest. Lass es leer für ein unbegrenztes (limitfreies) Budget.
Lege optional die Schwellen Warnung % und Kritisch % fest (wann das Status-Abzeichen umschlägt), die kommagetrennten Alarm-Schwellen (z. B. 50,80,100), die Benachrichtigungen auslösen, sowie Provider-Limits unter Provider-Limits.
Schalte Hard Stop am Limit ein, um neue API-Mode-Läufe zu blockieren, sobald das Limit erreicht ist, oder aus, um sie über das Limit hinaus fortlaufen zu lassen – dann nur mit dem Status.
Klicke auf Budget speichern.

Du kannst das Budget auch über das Web-Terminal lesen:

budget

Es gibt den Status, die Monatsausgaben gegen das Limit, den verbleibenden Betrag, etwaige Provider-Ausgaben und aktive Alarme aus.

Abo-Fenster vs. Dollar-Budget

	Abo-Fenster	Dollar-Budget
Gilt für	OAuth-Abo-Provider (vorausbezahlte Tarife)	API-Key-Provider (pro Token)
Begrenzt durch	Rollierende Nutzungsfenster (5-Stunden / wöchentlich / monatlich)	Ein monatliches USD-Limit
Du beobachtest	Wie voll ein Fenster ist (die Auslastungsanzeigen)	Wie viel du gegen das Limit ausgibst
Am Limit	Läufe pausieren und werden bei Erneuerung automatisch fortgesetzt	Läufe werden blockiert (bei aktivem Hard Stop) oder laufen mit Status weiter
Oberfläche	Panel Nutzung & Auslastung (Admin/Owner) · `usage`	Karte KI-Budget (alle Mitglieder) · `budget`

Kurz gesagt: Ein Abo wird über Zeitfenster, die sich wieder auffüllen gemessen, also steuerst du es, indem du die Auslastung liest und deine Arbeit timest; ein API-Key wird über ausgegebenes Geld gemessen, also steuerst du ihn, indem du ein Limit festlegst.