> For the complete documentation index, see [llms.txt](https://docs.blockbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockbrain.ai/de/fur-administratoren/kostenkontrolle.md). # Kostenkontrolle ### Glossar | Begriff | Definition | | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Compute-Block (CB)** | Die Einheit, die den Ressourcenverbrauch auf der Plattform misst. Jede Aktion – wie das Senden einer Chatnachricht oder das Hochladen einer Datei – verbraucht eine festgelegte Anzahl von CBs. | | **CB-Limit** | Die maximale Anzahl an Compute-Blocks, die ein Benutzer innerhalb eines bestimmten Zeitraums verbrauchen darf. | | **Zeitraum** | Der Zeitraum, über den der CB-Verbrauch gezählt und zurückgesetzt wird – täglich, wöchentlich oder monatlich. | | **Hartes Limit** | Ein Durchsetzungsmodus, bei dem nach Erreichen des CB-Limits keine weiteren CB-verbrauchenden Aktionen mehr möglich sind, bis ein Administrator das Limit erhöht. Der Benutzer kann keinen Self-Service durchführen. | | **Weiches Limit** | Ein Durchsetzungsmodus, bei dem der Benutzer nach Erreichen des CB-Limits nicht vollständig blockiert wird: Er kann im Pop-up einen Projektcode/Kostenstellen-Code eingeben, um sich vorübergehend zusätzliche Compute-Blocks zu gewähren und weiterzuarbeiten. Die zusätzliche Nutzung wird diesem Code zugeordnet und läuft nach einem festgelegten Zeitraum ab. | | **Standardlimit** | Ein systemweites CB-Limit, das für alle Benutzer gilt, sofern keine individuelle Überschreibung festgelegt ist. | | **Gruppenlimit** | Ein CB-Limit, das auf eine gesamte Active-Directory-(AD)-Gruppe angewendet wird und allen Mitgliedern gleichzeitig dasselbe Kontingent zuweist. | | **API-Schlüssel-Limit** | Ein CB-Limit, das auf Ebene des API-Schlüssels durchgesetzt wird und begrenzt, wie viele Compute-Blocks ein bestimmter API-Schlüssel innerhalb eines Zeitraums verbrauchen darf. | | **Kostenstelle / Projektcode** | Eine optionale numerische Kennzeichnung, die ein Benutzer eingeben kann, damit seine Nutzung einer internen Kostenstelle, einem Projekt oder einem Aktenzeichen (*Aktenzeichen*) für Berichte zugeordnet werden kann. | | **Nutzungswarnung** | Ein einmaliges, wegklickbares Banner (und/oder E-Mail), das vor Erreichen des harten Limits erscheint und den Benutzer warnt, wenn er sich seinem Kontingent nähert. | {% hint style="info" %} Die Funktion ist standardmäßig deaktiviert. Administratoren müssen sie einschalten, um das Compute-Block-Limit verwenden zu können. {% endhint %}
### Administratorkonfiguration #### Standard-CB-Limit Administratoren konfigurieren ein **Standard-Benutzerlimit** das global für alle Benutzer gilt. Dieses Limit besteht aus zwei Parametern: | Parameter | Standardwert | Verfügbare Optionen | | ------------------ | ------------ | ---------------------------------------- | | **Compute-Blocks** | 500.000 | Jeder benutzerdefinierte numerische Wert | | **Zeitraum** | Monatlich | Täglich / Wöchentlich / Monatlich | {% hint style="info" %} Das Standardlimit ist die Grundlage für jedes Benutzerkonto. Es wird wirksam, sofern für einen bestimmten Benutzer keine individuelle Überschreibung konfiguriert ist. {% endhint %} *** #### **Limit-Überschreibungen (Benutzer & Gruppen)** Überschreibungen erlauben es Administratoren, vom Standardlimit für bestimmte Benutzer oder ganze Gruppen abzuweichen. Sie werden im **Bereich der Limit-Überschreibungen** der CB-Limit-Adminseite verwaltet, die in zwei Registerkarten unterteilt ist — **Benutzer** und **Gruppen** — mit einer gemeinsamen Suchleiste und einer **Neue Überschreibung** Aktion. Beide Registerkarten unterstützen Inline-Bearbeitung, Massenaktionen und Paginierung. **Priorität (höchste bis niedrigste):** 1. **Benutzerspezifische Überschreibung** — setzt sich immer durch. 2. **Gruppenlimit** — gilt für Mitglieder einer begrenzten Gruppe. Wenn ein Benutzer mehreren begrenzten Gruppen angehört, gilt das **großzügigste** Limit (höchste Tagesäquivalenzrate). 3. **Standardlimit** — die globale Basis. #### **Benutzerspezifische Überschreibung** Administratoren können das Standardlimit für jeden einzelnen Benutzer direkt in **Benutzerverwaltung**überschreiben. Jede Benutzerzeile bietet zwei bearbeitbare Spalten: * **Compute-Blocks** - das maximale CB-Kontingent für diesen Benutzer * **Zeitraum** - den Rücksetzungszeitraum für das Limit dieses Benutzers **Um das Limit eines Benutzers zu überschreiben:** 1. Gehen Sie zu **Benutzerverwaltung**. 2. Suchen Sie den Benutzer in der Liste. 3. Bearbeiten Sie die **Compute-Blocks** und **Zeitraum** Werte in der Zeile dieses Benutzers. 4. Speichern Sie Ihre Änderungen.
{% hint style="info" %} Das Limit eines einzelnen Benutzers hat immer **Vorrang** vor dem globalen Standardlimit. {% endhint %} *** #### Gruppenlimit & Massenaktualisierungen für Benutzer Administratoren können CB-Limits auf **mehrere Benutzer gleichzeitig** anwenden, indem sie eine **Active-Directory-(AD)-Gruppe**auswählen. Dadurch entfallen manuelle Änderungen in der Benutzerverwaltung, die einzeln vorgenommen werden müssten. **Um ein Limit für eine Gruppe festzulegen:** 1. Gehen Sie zum **Gruppen** Bereich in Admin. 2. Wählen Sie die AD-Gruppe aus, die Sie konfigurieren möchten. 3. Setzen Sie die **Compute-Blocks** und **Zeitraum** Werte für die Gruppe. 4. Speichern Sie Ihre Änderungen — das Limit wird sofort auf alle Gruppenmitglieder angewendet. {% hint style="info" %} Individuelle Benutzerüberschreibungen haben weiterhin **Vorrang** Vorrang vor Gruppenlimits. Gruppenlimits haben Vorrang vor dem globalen Standard. {% endhint %} | Parameter | Standardwert | Verfügbare Optionen | | ------------------ | ------------ | ---------------------------------------- | | **Compute-Blocks** | 5,000,000 | Jeder benutzerdefinierte numerische Wert | | **Zeitraum** | Monatlich | Täglich / Wöchentlich / Monatlich | {% hint style="info" %} Gruppenlimits haben Vorrang vor dem globalen Standard, individuelle Benutzerüberschreibungen haben jedoch weiterhin Vorrang vor Gruppenlimits. {% endhint %} #### CB-Limit pro API-Schlüssel Administratoren können CB-Limits auf der **Ebene des API-Schlüssels**setzen und durchsetzen. Dies ist die natürliche Durchsetzungsebene für API-basierte Nutzung und verhindert, dass einzelne Schlüssel ihr zugewiesenes Budget überschreiten. **Um ein Limit für einen API-Schlüssel festzulegen:** 1. Gehen Sie zu **API-Schlüsselverwaltung** in Admin. 2. Wählen oder erstellen Sie einen API-Schlüssel. 3. Setzen Sie die **Compute-Blocks** Limit und **Zeitraum** für diesen Schlüssel. 4. Speichern Sie Ihre Änderungen. | Parameter | Standardwert | Verfügbare Optionen | | ------------------ | ------------ | ---------------------------------------- | | **Compute-Blocks** | 5,000,000 | Jeder benutzerdefinierte numerische Wert | | **Zeitraum** | Monatlich | Täglich / Wöchentlich / Monatlich | {% hint style="info" %} API-Schlüssel-Limits funktionieren unabhängig von Benutzerlimits. Ein Benutzer kann noch Kapazität haben, während sein API-Schlüssel blockiert ist, oder umgekehrt. {% endhint %} #### Benutzerdefinierte Benachrichtigungsnachricht Wenn ein Benutzer sein hartes CB-Limit erreicht, wird eine Popup-Benachrichtigung angezeigt. Administratoren können den **Textinhalt** dieser Nachricht festlegen. Das Popup enthält automatisch: * den vom Administrator definierten Nachrichtentext * das dem Benutzer zugewiesene CB-Limit * den aktiven Zeitraum **Beispiel einer vom Administrator definierten Nachricht:** {% hint style="info" %} *"Sie haben Ihr Nutzungslimit erreicht. Um eine Erhöhung anzufordern, wenden Sie sich bitte an* [*admin@yourcompany.com*](mailto:admin@yourcompany.com)*."* {% endhint %}
#### **Warnbenachrichtigungen** Administratoren können Benutzer warnen **wenn sie sich ihrem Limit nähern**, bei konfigurierbaren Schwellenwerten, über ein **Banner in der App** und/oder **E-Mail**. Dies wird im **Warnbenachrichtigungen** Bereich der Compute-Block-Einstellungen konfiguriert. **Kanäle** — aktivieren Sie jede beliebige Kombination: * **Banner in der App** — zeigt ein Banner in der App an, wenn ein Schwellenwert erreicht wird. * **Senden Sie dem Benutzer, der den Schwellenwert erreicht, eine E-Mail** — sendet die Warn-E-Mail an den betroffenen Benutzer. * **Senden Sie den ausgewählten Administratoren eine E-Mail** — sendet die Warn-E-Mail auch an ausgewählte Administratoren. **Administrator-Empfänger** — Wenn Administrator-E-Mails aktiviert sind, suchen und wählen Sie die Administratoren aus, die die Warn-E-Mail ebenfalls erhalten sollen, wenn ein Schwellenwert erreicht wird. **E-Mail-Inhalt** — Verwenden Sie **E-Mail-Inhalt bearbeiten** um Betreff und Text der an Benutzer und Administratoren gesendeten E-Mail anzupassen. **Schwellenwerte** — Definieren Sie einen oder mehrere Schwellenwerte, bei denen Warnungen ausgelöst werden. Für jeden Schwellenwert können Sie festlegen: * **Prozentsatz** — den Anteil des Limits, bei dem die Warnung ausgelöst wird (z. B. 70 %, 90 %) * **Farbe** — die Farbe, die für das Banner bei diesem Schwellenwert verwendet wird (z. B. Bernstein bei 70 %, Rot bei 90 %) * **Banner / E-Mail** — ob dieser Schwellenwert das Banner in der App, die E-Mail oder beides auslöst Verwenden Sie **Schwellenwert hinzufügen** um zusätzliche Schwellenwerte zu erstellen und **Entfernen** einen zu löschen.
{% hint style="info" %} Standardmäßig sind zwei Schwellenwerte konfiguriert: **70%** und **90%**, die jeweils sowohl das Banner als auch die E-Mail auslösen. {% endhint %} #### **Hinweise zum Feld Projektcode / Kostenstelle** Administratoren können **mandantenspezifischen Anleitungstext** für das **Feld Projektcode / Kostenstelle** im Popup angezeigt, das erscheint, wenn das Limit erreicht ist. Das hilft Benutzern zu verstehen, was genau einzugeben ist (zum Beispiel das erwartete Format oder welcher Code zu verwenden ist), und reduziert fehlerhafte Eingaben. * Die Hinweise werden pro Mandant in der entsprechenden Administrator-Einstellung festgelegt. * Sie wird dem Benutzer ohne weitere Interaktion angezeigt — entweder als eingeblendeter Hilfetext unter dem Feld oder als verbesserter Platzhalter. * Wenn kein benutzerdefinierter Text definiert ist, wird ein Standardplatzhalter angezeigt.
#### **Projektcodes** Wenn ein Benutzer sein CB-Limit erreicht, kann er einen **Projektcode** im Limit-Popup eingeben, um sich zusätzliche Compute-Blocks zu gewähren, die diesem Code zugeordnet werden. Administratoren können all diese Anfragen in der **Projektcodes** Ansicht überprüfen. {% hint style="info" %} Jeder zusätzliche Compute-Block, den ein Benutzer durch Eingabe eines Projektcodes hinzugefügt hat, wird hier angezeigt — eine Zeile pro Anfrage. {% endhint %} Jede Zeile zeigt: | Spalte | Beschreibung | | --------------- | ------------------------------------------------------------------------------------ | | **Projektcode** | Der Code, den der Benutzer beim Anfordern zusätzlicher Compute-Blocks eingegeben hat | | **Benutzer** | Der Benutzer, der die Anfrage gestellt hat (Name und E-Mail) | | **Gewährt** | Die Anzahl zusätzlicher Compute-Blocks, die für diese Anfrage gewährt wurden | | **Verwendet** | Wie viele der gewährten Compute-Blocks verbraucht wurden | | **Status** | Der aktuelle Status der Gewährung (z. B. Aktiv, Abgelaufen) | | **Angefordert** | Wann die Anfrage gestellt wurde | | **Läuft ab** | Wann das gewährte Kontingent abläuft | Administratoren können **nach Projektcode suchen** und **nach Datumsbereich filtern** (Von / Bis), um die Liste einzugrenzen.
#### **Nutzungsprotokollierung & Export** Die Nutzung wird pro Sitzung protokolliert und kann als **CSV** aus dem **Admin-Panel → Compute Block** Bereich exportiert werden. Der Export gibt Administratoren ein vollständiges Bild pro Benutzer — das zugewiesene Limit, die tatsächliche Nutzung unterhalb des Limits und jede Überschreitung, sobald das Limit überschritten ist (zusammen mit jeder vom Benutzer eingegebenen Kostenstelle / jedem Projektcode).
*** #### Limits anpassen CB-Limits können jederzeit in **Benutzerverwaltung** – sowohl das Standardlimit als auch individuelle Benutzerüberschreibungen. Änderungen werden **sofort** beim Speichern wirksam. *** ### Benutzerseitiges Verhalten #### Sichtbarkeit der Nutzung Benutzer können ihren CB-Verbrauch in ihrem **Benutzerprofil**. Die Nutzung wird als **Fortschrittsbalken**, der Folgendes anzeigt: * Insgesamt im aktuellen Zeitraum verbrauchte CBs * Das zugewiesene CB-Limit *** #### **Frühzeitige Nutzungswarnungen** Bevor das CB-Limit erreicht ist, erhalten Benutzer proaktive Warnungen, damit eine Sperre nie überraschend kommt. Warnungen werden bei vom Administrator konfigurierten Schwellenwerten (**70%** und **90%** standardmäßig) ausgelöst und können als Banner in der App, als E-Mail oder beides zugestellt werden. * Das **Banner in der App** ist ein einmaliges, wegklickbares Banner, das oberhalb des Eingabefensters angezeigt wird und je nach Schwellenwert farbcodiert ist. Es dient nur zur Information und **blockiert** keine Aktionen. * Das **E-Mail** benachrichtigt den Benutzer (und optional ausgewählte Administratoren), dass der Schwellenwert erreicht wurde. {% hint style="info" %} Die konkreten Schwellenwerte, Farben und Kanäle werden von Ihrem Administrator festgelegt (siehe **Warnbenachrichtigungen**). {% endhint %} #### Durchsetzung des Limits Sobald das CB-Limit eines Benutzers erreicht ist, wird folgendes Verhalten ausgelöst: 1. Ein **Popup-Dialog** erscheint und zeigt Folgendes an: * die benutzerdefinierte Nachricht des Administrators * das Limit und den Zeitraum des Benutzers * Ein Feld zur Eingabe eines **Projektcodes / Kostenstellennummers**, damit die Nutzung des Benutzers für Berichtszwecke der richtigen Kostenstelle zugeordnet werden kann. Das Feld zeigt einen Anleitungshilfetext an, der vorgibt, was einzugeben ist (Administratoren können diesen Text pro Mandant anpassen — siehe [#project-code-cost-center-field-guidance](#project-code-cost-center-field-guidance "mention")
2. Durch die Eingabe eines Projektcodes und das Absenden wird dem Benutzer **eine festgelegte Anzahl zusätzlicher Compute-Blocks gewährt**, die diesem Code zugeordnet sind und es dem Benutzer ermöglichen, weiterzuarbeiten. Die Gewährung läuft ab, und ihre Nutzung wird protokolliert (Administratoren können alle Gewährungen in der **Projektcodes** Ansicht überprüfen — siehe oben). 3. Der Dialog erscheint erneut, wann immer der Benutzer eine beliebige **CB-verbrauchende Aktion** (*Anzahl der Male, die ein Benutzer mehr CBs anfordern kann, ist ebenfalls vom Administrator konfigurierbar*)— einschließlich des Sendens einer Chatnachricht, des Hochladens oder Importierens von Dateien im Wissensmanagement, des Hinzufügens von Anhängen, des Erstellens von Notizen oder Zusammenfassungen, Text-zu-Sprache und Exporten. 4. Bis zusätzliche Compute-Blocks gewährt werden (über einen Projektcode oder indem ein Administrator das Limit erhöht), sind alle CB-verbrauchenden Aktionen **blockiert**. {% hint style="info" %} Der Benutzer kann weiterhin frei **navigieren** auf der Plattform. Nur Aktionen, die Compute-Blocks verbrauchen, sind eingeschränkt. {% endhint %} *** #### Zugriff wiedererlangen Wie ein Benutzer den Zugriff wiedererlangt, hängt vom Durchsetzungsmodus ab: * **Weiches Limit:** der Benutzer kann im Popup einen Projektcode eingeben, um sich vorübergehend zusätzliche Compute-Blocks zu gewähren und sofort weiterzuarbeiten. Sobald dieses Kontingent aufgebraucht ist oder abläuft, gilt das Limit erneut. * **Hartes Limit:** der Benutzer **kann keinen Self-Service durchführen** eine Erhöhung. Er muss einen Administrator kontaktieren und eine Anpassung des CB-Limits anfordern; sobald der Administrator das Limit erhöht, wird der Zugriff **sofort wiederhergestellt**. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.blockbrain.ai/de/fur-administratoren/kostenkontrolle.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.