§ DOCUMENTATION

AI FinOps

Ordnen Sie KI-Agentenausgaben den Dimensionen cost_center, project und team zu. Erstellen Sie Kostenrückverrechnungs-CSV-Berichte für die Finanzabteilung, legen Sie Budgetobergrenzen mit Warnzuständen fest und prognostizieren Sie die Monatsendausgaben, bevor sie Sie überraschen.

§ 01

Dimensionen der Kostenzuordnung

Übergeben Sie beim Trace-Ingest die Felder costCenter, project und/oder team zusammen mit der Standard-Trace-Nutzlast. Execlave speichert diese als dedizierte Spalten in execution_traces und verwendet sie als Gruppierungsschlüssel für alle Kostenberichte, Budgetobergrenzen und Prognosen. Das Tagging ist pro Trace optional; nicht getaggte Traces fließen in die Summen ein, lassen sich aber nicht nach Dimension aufschlüsseln.

Dimension	Typische Verwendung
costCenter	Wird einem Kostenstellencode der Finanzabteilung für die Rückverrechnung zugeordnet
project	Gruppiert Ausgaben nach Produktinitiative oder Kundenprojekt
team	Gruppiert Ausgaben nach Engineering- oder Business-Team für internes Showback

§ 02

Kostenrückverrechnungsberichte & CSV-Export

Taggen Sie einen Trace zum Zeitpunkt des Ingests über die Felder costCenter, project und team:

curl -X POST https://api.execlave.com/api/v1/traces/ingest \  -H "Authorization: Bearer $EXECLAVE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "agentId": "agt_01j...",    "input": "Summarise Q2 revenue figures",    "output": "...",    "costCenter": "finance",    "project":    "q2-reporting",    "team":       "data-analytics",    "tokensUsed": 1840,    "modelId":    "claude-sonnet-4-6"  }'

GET /api/v1/cost/report gibt die nach beliebigen Dimensionen gruppierten Ausgaben zurück. Fügen Sie format=csv hinzu, um eine korrekt escapte CSV für Ihr Finanzteam zu erhalten:

# Kostenrückverrechnungsbericht gruppiert nach cost_center (gibt standardmäßig JSON zurück)curl "https://api.execlave.com/api/v1/cost/report?groupBy=costCenter" \  -H "Authorization: Bearer $EXECLAVE_API_KEY" # Als CSV für die Finanzabteilung exportierencurl "https://api.execlave.com/api/v1/cost/report?groupBy=costCenter&format=csv" \  -H "Authorization: Bearer $EXECLAVE_API_KEY" \  -o chargeback.csv

§ 03

Budgetobergrenzen & Statuswarnungen

Legen Sie eine monatliche Ausgabenobergrenze für einen beliebigen Dimensionswert fest. Obergrenzen werden in der Tabelle budget_caps gespeichert (RLS-isoliert pro Organisation). GET /api/v1/cost/budgets/status gibt die aktuellen Ausgaben im Verhältnis zu jeder Obergrenze sowie einen Warnzustand zurück, sodass Sie Warnungen in Dashboards oder Alerting-Pipelines anzeigen können:

# Monatliche Budgetobergrenze für die Kostenstelle "finance" erstellencurl -X POST https://api.execlave.com/api/v1/cost/budgets \  -H "Authorization: Bearer $EXECLAVE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "dimension":  "costCenter",    "value":      "finance",    "limitUsd":   500,    "periodType": "monthly"  }' # Aktuelle Ausgaben vs. Obergrenze prüfencurl https://api.execlave.com/api/v1/cost/budgets/status \  -H "Authorization: Bearer $EXECLAVE_API_KEY"

§ 04

Monatsendkostenprognose

GET /api/v1/cost/forecast prognostiziert die Monatsendausgaben aus der jüngsten täglichen Kostenreihe. Das Backend ruft den Processing-Dienst unter POST /forecast/cost auf, der eine Zeitreihenprognose auf die täglichen Ausgabendaten anwendet und eine prognostizierte Monatsendausgabe zusammen mit einer Überschreitungswahrscheinlichkeit zurückgibt — der Wahrscheinlichkeit, dass die aktuelle Entwicklung aktive Budgetobergrenzen überschreitet.

Da die Prognose die aktuelle tägliche Reihe zum Zeitpunkt der Anfrage liest, berücksichtigt sie Ausgabenänderungen mitten im Monat automatisch. Rufen Sie den Endpunkt aus einem geplanten Job auf oder zeigen Sie ihn im Dashboard an, um Finanz- und Engineering-Teams frühzeitig zu warnen, bevor eine Budgetobergrenze erreicht wird.

§ 05

Beziehung zum Echtzeit-Kosten-Schutzschalter

Die Budgetobergrenzen von AI FinOps sind asynchron — sie summieren Ausgaben, vergleichen sie mit einem Schwellenwert und melden einen Warnzustand. Sie sind das richtige Werkzeug für Monatsplanung, Kostenrückverrechnung und Trendtransparenz.

Der Echtzeit-Kosten-Schutzschalter ist eine synchrone Richtlinie, die im Hot Path jeder Agentenaktion auslöst. Wenn die Ausgaben pro Organisation oder pro Agent die konfigurierte Obergrenze erreichen, blockiert der Schutzschalter die Aktion sofort, statt im Nachhinein eine Warnung anzuzeigen. Siehe die Governance-Übersicht für Details zur Konfiguration des Schutzschalters in einer Richtlinien-Regeldefinition.

§ 06

Häufig gestellte Fragen

Muss ich jeden Trace taggen, damit die Kostenzuordnung funktioniert?

Nein. Das Tagging ist pro Trace optional. Traces ohne Kostendimensionen werden weiterhin erfasst und erscheinen in der Gesamtsumme der Ausgaben; sie lassen sich lediglich nicht nach cost_center, project oder team aufschlüsseln. Für Zwecke der Kostenrückverrechnung werden nicht getaggte Ausgaben als separate, nicht zugeordnete Zeile ausgewiesen, damit Finanzteams das vollständige Bild sehen.

Wie behandelt die Monatsendprognose Budgetänderungen mitten im Monat?

Der Prognose-Endpunkt fragt die jüngste tägliche Kostenreihe zum Zeitpunkt der Anfrage ab und sendet sie an den Processing-Dienst. Da er die aktuelle Reihe und nicht einen zwischengespeicherten Snapshot liest, wird eine Budgetänderung mitten im Monat oder ein plötzlicher Anstieg der Agentenaktivität beim nächsten Prognoseaufruf automatisch berücksichtigt. Der Processing-Dienst gibt sowohl eine prognostizierte Monatsendausgabe als auch eine Überschreitungswahrscheinlichkeit zurück.

Was ist der Unterschied zwischen einer Budgetobergrenze und dem Echtzeit-Kosten-Schutzschalter?

Budgetobergrenzen (POST /api/v1/cost/budgets) sind asynchrone Ausgabenlimits — sie verfolgen kumulierte Ausgaben gegen einen Schwellenwert und melden einen Warnzustand über GET /api/v1/cost/budgets/status. Sie sind für FinOps-Transparenz und die Durchsetzung der Kostenrückverrechnung gedacht. Der Echtzeit-Kosten-Schutzschalter ist eine synchrone Richtlinie pro Organisation oder pro Agent, die einzelne Agentenaktionen in dem Moment blockiert, in dem eine Ausgabenobergrenze erreicht wird. Beide ergänzen sich: Budgetobergrenzen steuern die Monatsplanung; der Schutzschalter steuert die Durchsetzung zur Laufzeit.

Gibt es ein Feature-Flag, um AI FinOps zu aktivieren?

Nein. Die Kostenzuordnung ist verfügbar, sobald die Migration ausgeführt wird und Sie damit beginnen, Traces mit costCenter, project oder team zu taggen. Es gibt kein Feature-Flag, das die Kosten-Endpunkte sperrt. Budgetobergrenzen und der Prognose-Endpunkt sind ebenfalls ohne Opt-in verfügbar.