KI-Handler Log AI calls (protocol)

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.

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

Eine allgemeine Beschreibung von KI-Handlern finden Sie unter ALBERT | AI KI-Handler einrichten.

Eigenschaft	Wert
Anzeigename in der Oberfläche	Aufrufe protokollieren
Technischer Handler-Name	`agorum.ai.protocol` (Name der Konfiguration: `agorum_ai_protocol`)
Standardmäßig aktiv	ja
Eingriffspunkte (Hooks)	`after`

Wann verwenden

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.

Funktionsweise

Der Handler agorum_ai_protocol 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.

Einstellungen

Dieser Handler hat keine eigenen konfigurierbaren Einstellungen.

In einer KI-Voreinstellung verwenden

Öffnen Sie ☰ > Administration > Konfiguration > KI-Voreinstellungen.
Wählen Sie die gewünschte KI-Voreinstellung aus und klicken Sie Bearbeiten.
Scrollen Sie zum Bereich KI-Handler und klicken Sie auf KI-Handler hinzufügen.
Wählen Sie den KI-Handler Aufrufe protokollieren in der Liste aus.
Speichern Sie die KI-Voreinstellung.
Ergebnis: Alle KI-Anfragen und -Antworten in Chats mit dieser KI-Voreinstellung werden als JSON-Dateien im Workspace-Bereich von agorum core protokolliert.

Kombination mit anderen Handlern

Frage	Antwort
Reihenfolge	Der Handler 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.
Geeignete Kombinationen	Der Handler agorum_ai_protocol kann mit anderen Handlern kombiniert werden. Kombinieren Sie diesen Handler mit dem Debug-Handler (agorum_ai_debug), um sowohl Konsolenausgaben als auch persistente Protokolldateien zu erhalten.
Nicht kombinieren mit	Keine Besonderheiten bekannt.

Tipps und Fehlersuche

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.