KI-Handler Debug

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 dient zur Protokollierung und Diagnose aller eingehenden und ausgehenden Nachrichten bei KI-Aufrufen. Er bietet Entwicklern und Administratoren volle Transparenz über den KI-Verarbeitungsprozess.

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

Eigenschaft	Wert
Anzeigename in der Oberfläche	Debug: Ein- und Ausgaben in der Konsole ausgeben
Technischer Handler-Name	`agorum.ai.debug` (Name der Konfiguration: `agorum_ai_debug`)
Standardmäßig aktiv	ja
Eingriffspunkte (Hooks)	`before`, `callAi`, `after`

Wann verwenden

Entwicklung und Debugging: Zur Analyse des Datenflusses bei der Entwicklung neuer KI-Anwendungen
Fehlersuche: Zur Identifizierung von Problemen bei KI-Aufrufen durch detaillierte Protokollierung
Performance-Analyse: Zur Messung der Verarbeitungszeiten von KI-Anfragen
Validierung: Zur Überprüfung, welche Daten tatsächlich an die KI übermittelt werden
Token-Überwachung: Zur Kontrolle des Token-Verbrauchs bei KI-Anfragen

Achtung: Dieser Handler sollte nur in Entwicklungs- und Testumgebungen aktiv sein. In Produktivumgebungen kann die umfangreiche Protokollierung die Performance beeinträchtigen.

Funktionsweise

Der agorum_ai_debug-Handler protokolliert Daten an drei verschiedenen Punkten im KI-Verarbeitungsablauf:

Before-Hook (Vor der KI-Verarbeitung): Protokolliert die folgenden Eingabeparameter in der Konsole:
- Preset Name: Name der verwendeten KI-Voreinstellung
- Input: Die Benutzereingabe
- History: Der bisherige Gesprächsverlauf
- Parameters: Die übergebenen Parameter
CallAi-Hook (Beim KI-Aufruf): Protokolliert den Request Body, der an das Sprachmodell (LLM) gesendet wird. Dies ermöglicht die Analyse der exakten Anfrage, die an die KI übermittelt wird.
After-Hook (Nach der KI-Verarbeitung): Protokolliert die vollständigen Ergebnisdaten:
- Text: Die generierte Antwort der KI
- Error: Fehlermeldungen (falls vorhanden)
- Stopped: Ob die Verarbeitung abgebrochen wurde
- Tool Calls: Aufgerufene Tools (falls vorhanden)
- Duration: Verarbeitungsdauer in Millisekunden
- Response ID: Die ID der KI-Antwort
- Finish Reason: Grund für das Beenden der Antwort
- Tokens: Token-Verbrauch (falls verfügbar)
- Statistics: Statistische Informationen (falls verfügbar)
- Parsed Content: Geparste Inhalte (falls verfügbar)
- Preset Name: Name der verwendeten Voreinstellung
- History: Der aktualisierte Gesprächsverlauf

Hinweis: Der Handler wird immer ausgeführt, auch wenn andere Handler deaktiviert sind.

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 Debug: Ein- und Ausgaben in der Konsole ausgeben in der Liste aus.
Speichern Sie die KI-Voreinstellung.
Ergebnis: Die Ein- und Ausgaben der KI-Verarbeitung werden in der Konsole protokolliert.

Kombination mit anderen Handlern

Frage	Antwort
Reihenfolge	Empfohlene Position: Der Handler sollte als erster Handler in der Reihenfolge konfiguriert werden. Dadurch werden alle Eingabedaten bereits vor der Verarbeitung durch andere Handler protokolliert.
Geeignete Kombinationen	Der Handler kann mit allen anderen Handlern kombiniert werden. Da er ausschließlich protokolliert und keine Daten verändert, hat er keine Auswirkungen auf die Funktionalität anderer Handler.
Nicht kombinieren mit	Keine Besonderheiten bekannt: Der Handler kann mit allen anderen Handlern kombiniert werden.

Tipps und Fehlersuche

Wenn Sie mehrere Handler verwenden und Probleme auftreten, aktivieren Sie den Debug-Handler temporär, um den vollständigen Datenfluss zu analysieren.