Zum Inhalt springen

Credits & Billing

Credits Billing

Credits sind die Währungseinheit, die bei Agent-Ausführungen auf der nara-Plattform verbraucht wird. Jede Agent-Ausführung verbraucht Credits proportional zu den genutzten LLM-Tokens während der Konversation — einschließlich Input-Tokens (Prompt und Kontext), Output-Tokens (Antworten des Agents) und Tool-Call-Overhead.

Credits bieten eine planbare Möglichkeit, die KI-Nutzung in deiner Organisation zu verfolgen und zu budgetieren — unabhängig davon, welches LLM-Modell oder welcher Agent verwendet wird.

Navigiere zu Settings > Credits, um das aktuelle Credit-Guthaben deiner Organisation einzusehen. Die Guthabenseite zeigt:

FeldBeschreibung
Available creditsDie Anzahl der Credits, die aktuell zur Verfügung stehen
Reserved creditsCredits, die aktuell für laufende Agent-Ausführungen reserviert sind
Total consumedDie kumulierte Anzahl verbrauchter Credits seit der Kontoerstellung

Der Credit Ledger ist eine detaillierte, chronologische Historie aller Credit-Transaktionen in deiner Organisation. Jeder Eintrag enthält:

SpalteBeschreibung
TimestampWann die Transaktion stattfand
TypeDer Transaktionstyp: Verbrauch, Reservierung, Freigabe, Korrektur oder Kauf
AmountDie Anzahl der Credits (negativ bei Verbrauch, positiv bei Zugängen)
Balance afterDer laufende Kontostand nach dieser Transaktion
AgentDer Agent, der mit dieser Transaktion verknüpft ist (falls zutreffend)
SessionDie Session oder der Lauf, der die Transaktion ausgelöst hat
DescriptionEine kurze Erklärung der Transaktion

Nutze den Ledger, um die Credit-Nutzung zu prüfen, unerwartete Verbrauchsmuster zu identifizieren und die Billing-Genauigkeit zu verifizieren.

Überwache, wie Credits über verschiedene Dimensionen hinweg verbraucht werden:

Sieh, welche Agents die meisten Credits verbrauchen. Diese Ansicht sortiert Agents nach Gesamtverbrauch im gewählten Zeitraum und hilft dir, kostenintensive Agents zu identifizieren, die von Prompt-Optimierung oder Modellwechsel profitieren könnten.

Die tägliche Nutzungsansicht bietet eine Aufschlüsselung des Credit-Verbrauchs für jeden Tag:

  • Gesamtverbrauch Credits — aggregierter Verbrauch für den Tag.
  • Anzahl Agent-Läufe — wie viele Agent-Ausführungen stattfanden.
  • Durchschnittliche Credits pro Lauf — die mittleren Kosten jeder Agent-Ausführung.
  • Spitzenstunde — die Stunde mit dem höchsten Credit-Verbrauch.

Nutzungsverteilungs-Diagramme visualisieren diese Statistiken als Graphen und Heatmaps, sodass Trends und Anomalien auf einen Blick erkennbar sind.

Credits folgen einem reservierungsbasierten Ablauf, um eine korrekte Abrechnung während der Agent-Läufe sicherzustellen:

  1. Reservieren — wenn ein Agent-Lauf beginnt, werden Credits basierend auf einem geschätzten Maximalverbrauch von deinem verfügbaren Guthaben reserviert. Das verhindert Überziehung bei gleichzeitigen Läufen.

  2. Agent-Lauf — der Agent verarbeitet die Konversation, ruft Tools auf und generiert Antworten. Der tatsächliche Token-Verbrauch wird während des gesamten Laufs getrackt.

  3. Festschreiben — wenn der Lauf abgeschlossen ist, werden die tatsächlichen Credit-Kosten basierend auf dem realen Token-Verbrauch berechnet. Der festgeschriebene Betrag (der typischerweise unter der Reservierung liegt) wird dauerhaft von deinem Guthaben abgezogen.

  4. Freigeben — der ungenutzte Teil der Reservierung wird an dein verfügbares Guthaben zurückgegeben. Die Differenz zwischen reserviertem und festgeschriebenem Betrag wird erstattet.

Available Balance: 1000
↓ Reserve 100 for agent run
Available: 900 | Reserved: 100
↓ Agent run completes (actual cost: 42 credits)
↓ Commit 42, release 58
Available: 958 | Reserved: 0

In seltenen Fällen muss ein Administrator das Credit-Guthaben manuell korrigieren — zum Beispiel zur Kompensation eines Plattformfehlers oder zur Gutschrift eines Promotions-Credits. Korrekturen werden im Ledger mit einer klaren Beschreibung erfasst und sind im Transaktionsverlauf für das Auditing sichtbar.

Wenn dein Credit-Guthaben zur Neige geht, kannst du zusätzliche Credits erwerben:

  1. Navigiere zu Settings > Credits.

  2. Klicke auf Purchase Credits.

  3. Wähle ein Credit-Paket oder gib einen individuellen Betrag ein.

  4. Schließe den Kauf über den Billing-Flow ab.

  5. Die gekauften Credits werden deinem verfügbaren Guthaben sofort gutgeschrieben und erscheinen als Transaktion im Ledger.