Log AI calls (protocol)

Technischer Name: agorum_ai_protocol

Anzeigename: Log AI calls (protocol)

Was macht der Handler?

Der Handler agorum_ai_protocol protokolliert alle KI-Anfragen und -Antworten als JSON-Dateien in einer strukturierten Ordnerhierarchie im Workspace-Bereich von agorum core.

Funktionsweise

Der Handler wird nach jeder KI-Verarbeitung ausgeführt (after-Hook) und führt folgende Schritte durch:

Ermittelt den aktuellen Benutzernamen und den Namen des verwendeten KI-Presets.
Erstellt automatisch eine Ordnerstruktur basierend auf dem aktuellen Datum.
Speichert das vollständige Ergebnisobjekt (Request und Response) als formatierte JSON-Datei.
Verknüpft bei Folgeanfragen das Protokoll mit bestehenden Einträgen über eine Protocol-ID.

Speicherstruktur

Die Protokolldateien werden in folgender Pfadstruktur abgelegt:

/agorum/roi/workspace/agorum.ai/logs/{Benutzername}/{Preset-Name}/{YYYY}/{MM}/{DD}/{uuid}.json

Dabei werden die Ordner automatisch angelegt, falls sie noch nicht existieren.

Empfohlener Einsatzzweck

Der Handler eignet sich ideal für:

Debugging und Fehleranalyse: Nachvollziehen von KI-Anfragen und -Antworten bei Problemen.
Audit und Compliance: Dokumentation aller KI-Interaktionen für Revisionszwecke.
Qualitätssicherung: Überprüfung der KI-Ergebnisse und Optimierung von Prompts.
Entwicklung und Testing: Analyse des KI-Verhaltens während der Entwicklungsphase.

Hinweis: Die Protokolldateien können je nach Nutzungsintensität viel Speicherplatz belegen. Es wird empfohlen, regelmäßig alte Protokolldateien zu archivieren oder zu löschen.

Verwendung in KI-Voreinstellungen

Der Handler agorum_ai_protocol kann mit anderen Handlern kombiniert werden. Er sollte idealerweise als letzter Handler in der Reihenfolge konfiguriert werden, damit alle Änderungen anderer Handler (z. B. Filter oder Debug-Handler) ebenfalls im Protokoll erfasst werden.

Tipp: Kombinieren Sie diesen Handler mit dem Debug-Handler (agorum_ai_debug), um sowohl Konsolenausgaben als auch persistente Protokolldateien zu erhalten.