Zum Inhalt springen

Nutzung, Budget & Credits

Credits sind die Nutzungswährung von nara. Jede abrechenbare Aktion — ein nara-Lauf, eine Telefonminute, ein Dateiimport — verbraucht Credits vom Organisationsguthaben. Organisations-Admins verwalten die Nutzung unter Konto > Budget (/admin/credits) mit den Tabs Übersicht, Limits und Buchungen. Personen mit der Credits-Berechtigung, die keine Organisations-Admins sind, sehen nur den Tab Buchungen.

Der Tab Buchungen zeigt drei Werte:

  • Available credits — was aktuell ausgegeben werden kann.
  • Reserved credits — Schätzbeträge, die für laufende Ausführungen zurückgehalten werden.
  • Total consumed — kumulierter Verbrauch.

Bevor eine abrechenbare Aktion startet, reserviert nara die geschätzten Kosten. Nach Abschluss werden die tatsächlichen Kosten verbucht und der nicht genutzte Rest der Reservierung freigegeben. Da die Reservierung vorab gegen das verfügbare Guthaben geprüft wird, kann die Organisation nie überzogen werden. Eine Ausführung, die das Guthaben übersteigen würde, wird mit einem Fehler wegen unzureichender Credits abgelehnt, statt zu starten.

Limits stoppen neue Arbeit, sobald die Nutzung sie erreicht. Bereits laufende Arbeit kann danach noch verbucht werden, daher kann ein Zeitraum leicht über seinem Limit enden. Alle Limits sind standardmäßig aus, und das verfügbare Guthaben bleibt immer die harte Grenze.

  • Organisation: Monats- und Jahreslimit ändern Sie in der Übersicht direkt an der jeweiligen Zeile über Ändern. Der Monat folgt dem Abrechnungszeitraum Ihres Plans. Den Beginn des Geschäftsjahres stellen Sie unter Regeln ein; ein neuer Beginn gilt ab der nächsten Jahresgrenze.
  • Reserve für wichtige Assistenten und Fähigkeiten (unter Regeln): ein Teil des Organisationslimits, den nur Assistenten und Fähigkeiten mit der Priorität Läuft immer nutzen dürfen. Sie setzt mindestens einen davon voraus.
  • Gruppen und Personen (Tab Limits): optionale Limits für bestehende Gruppen (alle direkten Mitglieder teilen sich ein Limit), ein Limit pro Person für alle ohne eigene Einstellung und eigene Limits mit einem höheren, niedrigeren oder keinem persönlichen Limit. Jedes passende Limit gilt.
  • Assistenten und Fähigkeiten (Tab Limits): Priorität Läuft immer, Normal oder Kann warten direkt in der Zeile, dazu über Bearbeiten ein optionales Monats- und Jahreslimit, ein Höchstbetrag pro Anfrage und Zählt für Gruppe für Anfragen ohne Person. Eine Fähigkeit nutzt ihre eigene Priorität, auch in einem Chat mit einem Assistenten; sonst gilt die Priorität des Assistenten. Die Limits beider gelten, und der kleinere Höchstbetrag pro Anfrage zählt.
  • Höchstbetrag pro Anfrage: Eine Anfrage stoppt, sobald sie diesen Betrag verbraucht hat. Der letzte Schritt kann ihn leicht überschreiten. Den Standard für alle Assistenten und Fähigkeiten stellen Sie unter Regeln ein.
  • Feste Grenzen: Jede Anfrage, Automatisierung und Wissensverarbeitung hat feste Schritt- und Zeitgrenzen. Eine Anfrage stoppt, wenn derselbe Tool-Aufruf dreimal mit demselben Fehler scheitert.

Nutzung wird Personen und Gruppen ab der ersten Anfrage nach Veröffentlichung dieser Funktion zugeordnet. Wenn Sie ein Limit mitten in einem Zeitraum setzen, der früher begonnen hat, fragt nara, wie viel im aktuellen Zeitraum noch verbraucht werden darf. Das volle Limit gilt ab dem nächsten Zeitraum.

  • Personen sehen am Eingabefeld, welches Limit ihre Anfrage gestoppt hat, und den Hinweis bei Stopp aus der Übersicht. Ihre eigenen Limits und Stopps stehen in ihrem Profil.
  • Wartende Hintergrundarbeit pausiert. Admins können sie unter Wartet auf dich Fortsetzen, sobald das Limit es wieder erlaubt, oder Verwerfen.
  • Teilweise erledigte Arbeit stoppt und muss geprüft werden. nara startet sie nicht automatisch neu.
  • Unwichtiges anhalten (oben rechts) hält neue Arbeit von Assistenten und Fähigkeiten mit Kann warten und alle Importe an, bis Sie fortsetzen.

Erreicht eine Gruppe oder die Organisation ihr Limit, wartet ein Import auf Freigabe oder pausiert Arbeit, zeigen alle Admin-Seiten einen Hinweis. Die Benachrichtigungsglocke nennt zusätzlich Limits, die bald erreicht werden.

Einmalige Arbeit läuft als Import: Datei-Uploads, der Erstimport eines Connectors und die Neuindexierung eines Datentyps. Ein Upload oder Connector-Import wartet, bis ein Admin ihn in der Übersicht unter Importe mit Freigeben zur angezeigten Schätzung freigibt. Bis dahin werden Dateien und Objekte gespeichert, aber nicht verarbeitet. Eine Neuindexierung läuft ohne Freigabe.

  • Uploads zum selben Datentyp innerhalb von 24 Stunden kommen in den offenen Import.
  • Ein Import pausiert, wenn er seinen freigegebenen Betrag erreicht. Erhöhen Sie ihn, um fortzufahren. Bereits übermittelte Provider-Batches werden noch verbucht.
  • Ablehnen oder Schließen bricht die wartende Arbeit ab. Die Connector-Synchronisierung nach dem Erstimport zählt als reguläre Nutzung.
  • Importe zählen für verbrauchte Credits und Limits, bleiben aber aus der wiederkehrenden Prognose heraus.

Die Prognose nutzt die wiederkehrende Nutzung der letzten 14 Tage, einschließlich Tagen ohne Nutzung. Mit weniger als 7 Tagen Daten ist sie als vorläufig markiert. Änderungen (oben rechts) listet jede Änderung an Limits und Einstellungen, jede Freigabe, fortgesetzte oder verworfene Arbeit und jeden Stopp durch ein Limit, filterbar nach Einstellungen, Stopps und Freigaben.

Die Tabelle nennt die Mindestkosten je abrechenbarer Aktion. nara-Läufe und Medienanalysen werden nach gemessener Modellnutzung abgerechnet. Ein Durchlauf mit mehr Kontext, mehr Ausgabe oder Wiederholungen kostet mehr als den Mindestwert. Alle anderen Aktionen kosten genau den genannten Wert.

Aktion Item Code Mindest-Credits
nara-Lauf (pro) AGENT_TURN_PRO 8
nara-Lauf (balanced) AGENT_TURN_BALANCED 4
nara-Lauf (budget) AGENT_TURN_BUDGET 1
Telefonminute PHONE_MINUTE 50
Wissens-Dateiimport MEMORY_INGEST_FILE 5
Wissens-Schreibvorgang MEMORY_EMBEDDING_WRITE 1
Wissens-Medienanalyse MEMORY_MEDIA_EXTRACTION 1
Ticketerstellung TICKET_CREATE 0

Zusätzliche Credits kosten jeweils 0,025 €. Die für Ihre Organisation konfigurierten Kosten zeigt die Tabelle Konfigurierte Credit-Kosten auf der Seite.

Der Tab Buchungen erfasst jede Credit-Bewegung als Ledger-Eintrag mit Created At, Type, Item Code, Sequence, Units, Unit Cost, Total Cost und Details. Einträge aus einer Konversation oder einem Ticket verlinken direkt auf den zugehörigen Chat bzw. das Ticket, sodass sich jede Abbuchung zur Quelle zurückverfolgen lässt.

Eintragstyp Bedeutung
PURCHASE Über einen Kauf hinzugefügte Credits
INITIAL Startguthaben
USAGE Direkter Verbrauch
RESERVATION Vor einer Ausführung zurückgehaltene Schätzung
RESERVATION_COMMIT Nach der Ausführung verbuchte tatsächliche Kosten
RESERVATION_RELEASE Nicht genutzter Teil einer Reservierung, zurückgegeben
REFUND Erstattete Credits
CORRECTION Manuelle Korrektur (nur Admins)
MONTHLY_GRANT Gutgeschriebenes monatliches Kontingent
MONTHLY_EXPIRATION Verfallenes ungenutztes Monatskontingent

Diagramme und Aufschlüsselungen des Verbrauchs nach Person, Assistent, Fähigkeit, Kanal und Zeitraum finden Sie unter Reports (/admin/reports). Der Tab Buchungen verlinkt dorthin.

Käufe erzeugen PURCHASE-Einträge im Ledger. Manuelle CORRECTION-Einträge sind Admins vorbehalten und dienen der Korrektur von Abrechnungsabweichungen. Enthält Ihr Plan ein Monatskontingent, werden die Credits monatlich als MONTHLY_GRANT-Einträge gutgeschrieben; nicht genutzte Anteile verfallen am Periodenende mit einem passenden MONTHLY_EXPIRATION-Eintrag.