ALBERT | AI Kostenkontrolle einrichten

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. In dieser Dokumentation erhalten Sie Hintergrundinformationen zur Einrichtung.

Erste Schritte

1. Öffnen Sie im Hauptmenü den Eintrag KI Nutzungs- & Kostenanalyse und richten Sie über den Button Lokale Zählung die mitgelieferte Handler-Konfiguration ein, siehe Die lokale Zählung einrichten.
2. Hinterlegen Sie an den verwendeten KI-Voreinstellungen Preisschätzungen, siehe Preise in KI-Voreinstellungen konfigurieren. Ohne Preise werden nur Token und Tool-Aufrufe gezählt, die Kosten bleiben 0.
3. Berechtigen Sie die Benutzer, die die Auswertung sehen sollen, siehe ALBERT | AI Kostenkontrolle berechtigen.
4. Richten Sie optional den Anomalie-Check an. Wollen Sie den Check KI-gestützt betreiben, hinterlegen Sie vorher ein Sprachmodell in der mitgelieferten KI-Voreinstellung Check Usage Protocol base, siehe Anomalie-Check einrichten.
5. Pseudonymisieren Sie optional die Benutzerinformationen, siehe Pseudonymisierung einrichten.

Die lokale Zählung einrichten

Damit die Auswertung Daten erhält, muss die mitgelieferte Handler-Konfiguration global zugewiesen sein. Das erledigen Sie in der Auswertung über den Button Lokale Zählung. Er steht ausschließlich Administratoren zur Verfügung und erscheint in Warnfarbe, solange die Zählung ausgeschaltet ist.

1. Öffnen Sie im Hauptmenü den Eintrag KI Nutzungs- & Kostenanalyse.
2. Wählen Sie Lokale Zählung.
   
   Ergebnis: Der Dialog Lokale Zählung einrichten öffnet sich. 
3. Überprüfen Sie die Einstellungen für Serveradresse und Kennung. 
4. Wählen Sie Aktivieren (bei erstmaliger Einrichtung) oder Neu aktivieren (für Änderungen), um die Einstellungen zu hinterlegen und die Kostenkontrolle zu starten.

Aktion	Wirkung
Aktivieren	Stellt für den technischen Benutzer ein JWT ohne Ablaufdatum aus, trägt es zusammen mit Serveradresse und Kennung verschlüsselt in die Handler-Konfiguration ein und weist die Konfiguration global zu.
Neu aktivieren	Dieselbe Schaltfläche, solange die Zählung bereits läuft. Sie übernimmt geänderte Adresse und Kennung und stellt dabei einen neuen Schlüssel aus.
Deaktivieren	Entfernt nur die globale Zuweisung. Schlüssel, Adresse und Kennung bleiben gespeichert.
Verbindung prüfen	Prüft, ob der Dienst unter der eingegebenen Adresse erreichbar ist und die Anmeldung annimmt. Dabei wird kein Datensatz angelegt.

Im Abschnitt Status sehen Sie zwei Angaben: ob die Zählung aktiv oder inaktiv ist und ob ein API-Schlüssel hinterlegt ist. Unter dem Feld Serveradresse zeigt die Maske die vollständige Adresse, an die gemeldet wird; sie wird aus Ihrer Eingabe gebildet.

Die Zählung an ein anderes agorum core pro System melden

Soll die Nutzung an ein anderes System gemeldet werden, etwa an eine zentrale Auswertung, ist die Maske nicht der richtige Weg. Gehen Sie stattdessen so vor:

1. Auf dem Zielsystem muss die ALBERT | AI Kostenkontrolle installiert sein. Erzeugen Sie dort unter Administration > Werkzeuge > JWT-Generator ein Token für den technischen Benutzer: agorum.ai.usage.protocol.user
2. Legen Sie auf dem sendenden System unter Administration > Konfiguration > KI-Handler eine neue Handler-Konfiguration mit dem Handler Usage protocol an, füllen Sie die Felder aus der folgenden Tabelle aus und setzen Sie die Konfiguration aktiv.
3. Weisen Sie die Konfiguration global zu: in der MetaDB unter MAIN_MODULE_MANAGEMENT/customers/agorum.ai/global-handlers/[ agorum.ai.usage.protocol ] einen Eintrag nach dem Schema NNNN name anlegen, mit dem Namen der Konfiguration als Wert.

Feld	Wert
Handler	Usage protocol
URL	Die Adresse des REST-Service auf dem Zielsystem, nach dem Muster https://<zielsystem>/api/rest/custom/agorum.ai.usage.protocol.services.usageProtocol
Kennung	Eine frei wählbare Kennung für das sendende System. Sie erscheint in der Auswertung als Identifier und hält die Einträge der einzelnen Systeme auseinander.
API-Schlüssel	Das Token aus Schritt 1.