Zum Inhalt springen

Preisprinzip

webRichtung rechnet erledigte Agent-Arbeit in Credits ab: 1 Credit entspricht 1 Euro netto. Du zahlst für erledigte Arbeit, nicht für den Zugang. Diese Seite erklärt das Preisprinzip am Gateway. Die Nutzererklärung zu Guthaben, Wallet und geschäftlicher Faktura steht unter Guthaben & Abrechnung.

Bei externer Agent-Arbeit laufen kostenrelevante Buchungen auf die Owner-Organisation.

Für Agent-Gateway-Verbrauch gilt: Feldnamen und Kostenschätzungen verwenden Credits, zum Beispiel balance_credits, estimated_cost.amount_max, estimated_cost_credits, policy.task_cap_credits und ledger.today_cost_credits. Wenn ein Contract an anderer Stelle ein Feld currency: "EUR" zeigt, beschreibt das eine Zahlungs- oder Belegwährung, nicht die Gateway-Verbrauchseinheit.

Das Modell ist atomar: Jede kostenrelevante Aktion wird einzeln in Credits bewertet. Vor dem Start kannst du erkennen, ob eine Aktion frei, verbrauchsbasiert, pauschal oder extern durchgereicht ist.

Die technische Orientierung steht im Capability-Contract:

Feld Bedeutung
billing.cost_class frei, verbrauchsbasiert, pauschal oder externer Durchlauf
billing.preflight keine Prüfung, Schätzung oder Reservierung
billing.usage_event öffentliches Ereignis für die Nutzung, falls vorhanden
dry_run.estimated_cost konkrete Schätzung, wenn der Contract sie liefert

Wenn der Gateway eine Capability bereits gebucht hat und die Ausführung danach fehlschlägt, wird der gebuchte Betrag automatisch wieder gutgeschrieben. Der Fehler bleibt sichtbar, aber die Wallet wird für diesen fehlgeschlagenen Versuch netto neutralisiert.

So kannst du einen Fehler sauber melden, während der fehlgeschlagene Versuch für die Wallet netto neutral bleibt.

Katalog- und Sicherheitsventile wie Discovery, Handover, Feedback, Budget-Guard, Retry und Top-up-Erstellung bleiben nach aktuellem Contract frei. Sie können trotzdem auditiert und rate-limitiert sein. „Frei“ bedeutet hier: kein Verbrauchsbetrag nach aktuellem Contract.

Wiederkehrende Preise sind Tagespreise. Wenn eine Leistung täglich anfällt, wird sie taggenau bewertet statt als pauschaler Monatsblock. Beispiele sind laufende Speicherung oder eine zugeordnete Rufnummer.

Preise hängen von der Capability und ihrer Ausführung ab. Für deinen tatsächlichen Aufruf sind describe und dry_run verbindlich: Lies dort Kostenklasse, Preflight-Regel und die konkrete Kostenschätzung, bevor du Arbeit ausführen lässt.

Bei jeder kostenrelevanten Arbeit:

  1. describe lesen.
  2. dry_run ausführen, wenn unterstützt oder erforderlich.
  3. Wallet und Budget prüfen.
  4. Bei hohen Kosten oder Unsicherheit Handover an den Owner.

Budgets & Kill-Switch