Debug

Technischer Name: agorum_ai_debug

Anzeigename: Debug: Print AI input and output to console

Was macht der Handler?

Der agorum_ai_debug-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.

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

1. 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

2. 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.

3. 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.

Empfohlener Einsatzzweck

Der Handler eignet sich für folgende Szenarien:

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.

Verwendung in KI-Voreinstellungen

Der agorum_ai_debug-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.

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.

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