ALBERT | AI Kostenkontrolle

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Suite. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Die ALBERT | AI Kostenkontrolle protokolliert die Nutzung der KI-Funktionen in agorum core pro und stellt eine Übersicht über Kosten, Modelle und Benutzeraktivitäten bereit. Sie wird mit der ALBERT | AI Suite ausgeliefert und installiert. Einträge entstehen allerdings erst, wenn Sie die Zählung einschalten.

Die KI-Funktionen in agorum core pro verursachen Kosten, die sonst niemand sieht: Jeder Chat, jeder Agentenlauf und jeder Tool-Aufruf über den MCP-Server verbraucht Token bei einem KI-Anbieter. Die ALBERT | AI Kostenkontrolle zeichnet diese Nutzung auf. Je KI-Runde entsteht ein Protokolleintrag mit Zeitpunkt, Benutzer, KI-Voreinstellung, Modell, Token, Tool-Aufrufen und den daraus geschätzten Kosten.

Diese Seite führt Sie zu den einzelnen Dokumentationen. Beginnen Sie mit ALBERT | AI Kostenkontrolle, wenn Sie die Kostenkontrolle zum ersten Mal einrichten, und mit ALBERT | AI Kostenkontrolle verwenden, wenn Sie mit der Auswertung arbeiten wollen.

Hinweis: Was in die Zählung einfließt:

Token-Verbrauch und Tool-Aufrufe aus dem ALBERT | AI Chat und aus Agenten.
Werkzeugaufrufe, die über die MCP-Schnittstelle bei agorum core pro eingehen. Sie werden an alle global zugewiesenen Konfigurationen dieses Handlers gemeldet. Weitere Informationen finden Sie unter ALBERT | AI als MCP-Server verwenden.

Übersicht über die ALBERT | AI Kostenkontrolle

Wozu Sie die Kostenkontrolle einsetzen

Kostenkontrolle. Die Auswertung KI Nutzungs- & Kostenanalyse zeigt, wofür die KI im Haus verwendet wird und was das kostet: aufgeteilt nach Zeitraum, KI-Voreinstellung, Modell, Benutzer und einer frei wählbaren Kennung, mit der sich Einträge etwa einer Abteilung, einem Projekt oder einem sendenden System zuordnen lassen. Der Aufwand ist damit nicht nur als Gesamtsumme sichtbar, sondern einer Ursache zuzuordnen. Mehrere Systeme können ihre Zählung an eine zentrale Auswertung melden.

Anomalie-Check. Eine Auswertung hilft nur, wenn jemand hineinsieht. Der Anomalie-Check übernimmt das: Er prüft nach einem Zeitplan, ob Anzahl Aufrufe, Kosten, Tool-Aufrufe oder Ausgabe-Token gegenüber den vorangehenden Zeiträumen auffällig gestiegen sind – insgesamt, je KI-Voreinstellung und je Benutzer – und meldet sich per E-Mail und per Notiz. Die Prüfung arbeitet wahlweise KI-gestützt oder rein rechnerisch nach festen Schwellen. Ein Ausreißer fällt damit auf, wenn er entsteht, und nicht erst bei der Abrechnung.

Pseudonymisierung. Jeder Protokolleintrag nennt den Benutzer, dessen Nutzung er beschreibt. Wo das nicht gewollt ist, ersetzt die Pseudonymisierung den Anmeldenamen beim Speichern durch ein gleichbleibendes Pseudonym. Die Auswertung bleibt dabei brauchbar, weil sich die Einträge weiterhin auseinanderhalten lassen, und jeder Anwender sieht seine eigenen Einträge unverändert. Eine Anonymisierung ist es ausdrücklich nicht.

Hinweis: Kosten weist die Auswertung nur aus, wenn an den verwendeten KI-Voreinstellungen Preise hinterlegt sind. Ohne Preise werden Token und Tool-Aufrufe gezählt, die Kosten bleiben bei 0. Die ausgewiesenen Beträge sind Schätzwerte und keine Abrechnungsgrundlage.

Bausteine der ALBERT | AI Kostenkontrolle

Baustein	Funktion
Menüeintrag KI Nutzungs- & Kostenanalyse	Öffnet die Auswertung mit Filterbereich, Ergebnisliste und Kosten-Diagramm.
Handler-Konfiguration agorum_ai_usage_protocol_default	Wird mitgeliefert, Anzeigename KI Nutzungs- & Kostenanalyse: Nutzung und Kosten protokollieren. Sie muss global zugewiesen sein, damit Protokolleinträge entstehen.
REST-Service agorum.ai.usage.protocol.services.usageProtocol	Nimmt die Start- und End-Aufrufe der KI entgegen und legt die Protokoll-Datensätze an.
Technischer Benutzer agorum.ai.usage.protocol.user	Trägt das JWT, mit dem sich der Handler beim Service anmeldet.
Protokoll-Datensätze	Je KI-Runde entsteht ein Datensatz, zusätzlich je Chat ein kumulativer. Die Auswertung arbeitet mit den Runden-Datensätzen.
Stalled-Check	Läuft stündlich und markiert Einträge, die seit mehr als 24 Stunden als laufend gelten, als unterbrochen.
Anomalie-Check	Geplante Prüfung auf auffällige Veränderungen, wahlweise KI-gestützt oder regelbasiert.
Pseudonymisierung	Ersetzt den Anmeldenamen in den Protokolleinträgen durch ein gleichbleibendes Pseudonym. Im Auslieferungszustand ausgeschaltet.

ALBERT | AI Kostenkontrolle einrichten

Thema	Beschreibung	Dokument
Einrichten	Bausteine der Kostenkontrolle, lokale Zählung einrichten, Zählung an ein anderes agorum core pro System melden und was in die Zählung einfließt.	ALBERT \| AI Kostenkontrolle einrichten
Anomalie-Check	Regelmäßige Prüfung auf auffällige Veränderungen der Nutzung, wahlweise KI-gestützt oder regelbasiert, mit Zeitplan und Kontextdateien.	Anomalie-Check einrichten
Pseudonymisierung	Den Anmeldenamen in den Protokolleinträgen durch ein gleichbleibendes Pseudonym ersetzen und Bestandsdaten umschreiben.	Pseudonymisierung einrichten
Berechtigen	ACL und Benutzergruppen, eigene Einträge und die Masken, die nur Administratoren sehen.	ALBERT \| AI Kostenkontrolle berechtigen

ALBERT | AI Kostenkontrolle verwenden

Thema	Beschreibung	Dokument
Verwenden	Die Auswertung öffnen, filtern, das Diagramm umschalten und die Einträge der Ergebnisliste lesen.	ALBERT \| AI Kostenkontrolle verwenden