Anomalie-Check einrichten

Der Anomalie-Check prüft regelmäßig, ob sich die KI-Nutzung auffällig verändert hat, etwa weil die Kosten eines einzelnen Benutzers oder einer einzelnen KI-Voreinstellung plötzlich stark steigen. Diese Dokumentation richtet sich an Administratoren. Sie beschreibt, wozu der Anomalie-Check dient, wie Sie ihn in seinen beiden Varianten einrichten und was Sie danach erwarten dürfen.

Die Maske Anomalie-Check einstellen erreichen Sie über den gleichnamigen Button in der Kopfleiste der KI Nutzungs- & Kostenanalyse. Der Button steht ausschließlich Administratoren zur Verfügung.

Wozu der Anomalie-Check dient

Die Kostenanalyse zeigt Ihnen, was die KI-Nutzung kostet, aber nur, wenn jemand hineinsieht. Eine Fehlkonfiguration, etwa eine KI-Voreinstellung, die sich in einer Endlosschleife dreht, fällt dabei oft erst Tage später auf. Der Anomalie-Check sieht regelmäßig für Sie hinein und meldet sich von selbst, sobald die Nutzung aus dem Rahmen fällt.

Was geprüft wird

Grundlage sind die Protokolleinträge der letzten 30 Tage, zusammengefasst nach Tagen. Verglichen wird der jüngste Tag mit dem Durchschnitt der Vortage. Überschreitet die prozentuale Abweichung eine Schwelle, gilt das als Anomalie.

Die beiden Varianten

Beide Varianten arbeiten auf denselben Daten. Sie unterscheiden sich darin, wer urteilt und was dabei herauskommt.

Die KI-gestützte Variante einrichten

Schritt 1: Ein Sprachmodell hinterlegen

Die KI-gestützte Variante arbeitet mit drei mitgelieferten KI-Voreinstellungen: Check Usage Protocol base sowie den beiden darauf aufbauenden Check Usage Protocol byTime und Check Usage Protocol byPreset. 

1. Öffnen Sie Administration > Konfiguration > KI-Voreinstellungen.
2. Wählen Sie die Voreinstellung Check Usage Protocol base und öffnen Sie sie über Bearbeiten.
3. Tragen Sie im Bereich Referenzeinstellung eine KI-Voreinstellung ein, die eine Verbindung zu einem KI-Sprachmodell herstellt.
4. Speichern Sie die Änderungen.
   
   Ergebnis: Die beiden aufbauenden Voreinstellungen verwenden dieses Sprachmodell mit, denn sie verweisen ihrerseits auf die Basis-Voreinstellung.

Schritt 2: Den Meldungsweg eintragen

Zwei Textdateien steuern, was die KI beurteilt und wie sie meldet. Sie bearbeiten beide direkt in der Oberfläche Anomalie-Check einstellen, im Abschnitt Kontextdateien bearbeiten:

Öffnen Sie Ursache & Meldung anpassen und ersetzen Sie die drei Platzhalter durch Ihre eigenen Angaben:

{{E-Mail-Empfänger}}

{{Ordner für die Anomalie-Notizen}}

{{Zu benachrichtigende Benutzer}}

Schritt 3: Die Schwellenwerte prüfen

Wählen Sie Anomalie-Erkennung anpassen. Die ausgelieferte Datei beurteilt die Tageskosten und bringt diese Werte mit:

Schritt 4: Zeitplan einstellen und aktivieren

1. Öffnen Sie die KI Nutzungs- & Kostenanalyse und wählen Sie Anomalie-Check einstellen.
2. Stellen Sie im Abschnitt Zeitplan konfigurieren ein, wann die Prüfung laufen soll. Die fünf Auswahlfelder entsprechen Minute, Stunde, Tag des Monats, Monat und Wochentag; darunter sehen Sie eine Vorschau des nächsten Ausführungszeitpunkts. Voreingestellt ist täglich um 07:00 Uhr.
3. Klicken Sie auf Anomalie-Check aktivieren.
   
   Ergebnis: Die Prüfung wird als Task eingerichtet und läuft ab jetzt nach dem eingestellten Zeitplan.

Den Anomalie-Check einstellen

Die Maske im Überblick

Die regelbasierte Variante einrichten

Die regelbasierte Variante rechnet ohne KI und verursacht deshalb keine Kosten. Sie wird nicht über die Maske eingerichtet: Die Maske registriert ausschließlich die KI-gestützte Prüfung als geplante Aufgabe. Die regelbasierte Variante rufen Sie stattdessen selbst auf: einmalig zur Beurteilung Ihres Datenbestands oder regelmäßig aus einer eigenen Aufgabe heraus.

Zeitraum und Schwellen selbst festlegen

Jede Messgröße hat eine eigene Schwelle in Prozent. Angegeben werden nur die Werte, die von der Vorgabe abweichen sollen:

let check = require('/agorum/roi/customers/agorum.ai.usage.protocol/js/scripts/check-usage-anomaly-rules');

let result = check.run({
  start:      '2026-05-09T00:00:00Z',
  end:        '2026-06-09T00:00:00Z',
  gap:        '+1DAY',
  thresholds: { cost: 400, count: 400, toolCallCount: 300, tokensAlbertOutput: 300 },
});

Was die Prüfung zurückgibt

Das Ergebnis nennt, ob etwas gefunden wurde, und führt jede Auffälligkeit einzeln auf:

Was Sie nach der Einrichtung erwarten dürfen

Wann geprüft wird

Die KI-gestützte Prüfung läuft als geplante Aufgabe nach Ihrem Zeitplan, im Hintergrund und ohne Zutun. Ob sie läuft, sehen Sie jederzeit im Feld Status der Maske, zusammen mit dem eingestellten Zeitplan.

Was bei einem Fund passiert

Jeder Lauf beurteilt zuerst die Gesamt-Zeitreihe. Ist der jüngste Tag unauffällig, endet der Lauf hier, Sie hören nichts. Andernfalls folgt ein zweiter Schritt, der die Kosten dieses Tages nach KI-Voreinstellung aufschlüsselt und daraus die Meldung formuliert:

• Die verantwortliche KI-Voreinstellung wird mit Namen genannt.
• Eine kurze, sachliche Begründung nennt, woran die Anomalie zu erkennen ist, etwa am Kostenanteil oder am Anstieg gegenüber dem Schnitt.
• Nach Möglichkeit folgt ein Vorschlag für den nächsten Schritt, etwa die Voreinstellung auf eine Endlosschleife zu prüfen.

Diesen Text erhalten Sie auf zwei Wegen: als E-Mail an die eingetragenen Empfänger, mit dem Betreff ACHTUNG - Anomalie bei den KI-Prozessen, und als Notiz am eingetragenen Ordner für die eingetragenen Benutzer.

Wenn sich der Check nicht meldet

Keine Meldung ist zunächst ein gutes Zeichen. Bleibt sie auch dann aus, wenn Sie eine erwarten, prüfen Sie in dieser Reihenfolge:

Was die Prüfung kostet

Jeder Lauf der KI-gestützten Variante kostet einen KI-Aufruf, bei einem Fund zwei. Diese Aufrufe erscheinen wie jede andere Nutzung in der Kostenanalyse. Die regelbasierte Variante kostet nichts.