Fehlerbehebung¶

Lösungen für häufige DeskAgent-Probleme.

DeskAgent startet nicht¶

Kein Fenster erscheint¶

Probiere diese Schritte:

1. Prüfe ob bereits läuft - Führe zuerst stop.bat aus, dann versuche es erneut
2. Prüfe die Logs - Öffne workspace/.logs/system.log für Fehlermeldungen
3. Computer neu starten - Manchmal braucht Windows einen Neustart

"Port bereits in Verwendung"-Fehler¶

Ein anderes Programm verwendet Port 5005.

Lösung:

1. Führe deskagent\stop.bat aus
2. Wenn das nicht hilft, starte deinen Computer neu
3. Versuche DeskAgent erneut zu starten

Outlook-Probleme¶

"Outlook nicht verfügbar"¶

Lösungen:

1. Stelle sicher, dass Outlook geöffnet und aktiv ist
2. Schließe und öffne DeskAgent erneut
3. Bei mehreren Monitoren: stelle sicher, dass Outlook nicht minimiert ist

E-Mail-Ordner nicht gefunden¶

Lösung:

Frage DeskAgent: "Liste meine E-Mail-Ordner auf" - verwende dann den exakten angezeigten Ordnernamen.

"Keine E-Mail ausgewählt"¶

Lösungen:

• Klicke einmal auf die E-Mail in Outlook (nicht Doppelklick zum Öffnen)
• Stelle sicher, dass nur eine E-Mail ausgewählt ist
• Versuche eine andere E-Mail auszuwählen

AI antwortet nicht¶

"Ungültiger API-Key"¶

Lösungen:

1. Öffne config/backends.json in einem Texteditor
2. Prüfe, ob dein API-Key korrekt ist
3. Stelle sicher, dass keine zusätzlichen Leerzeichen vorhanden sind
4. Hole einen neuen Key von der Website deines AI-Anbieters

Langsame Antworten¶

"Kontext zu lang"¶

Die AI verarbeitet zu viele Informationen.

Lösungen:

1. Teile deine Anfrage in kleinere Teile auf
2. Starte ein neues Gespräch
3. Beschränke, welche Wissensdateien verwendet werden

Agent-Probleme¶

Agent wird nicht im Menü angezeigt¶

Prüfe:

1. Ist die Agent-Datei im agents/-Ordner?
2. Ist sie in config/agents.json aufgelistet?
3. Ist "enabled": true gesetzt?
4. Starte DeskAgent nach Änderungen neu

Agent gibt falsche Antworten¶

Versuche:

1. Sei spezifischer in deiner Anfrage
2. Füge mehr Details zu den Agent-Anweisungen hinzu
3. Teste zuerst mit einer einfacheren Aufgabe

Agent stoppt ohne fertig zu werden¶

Debugging:

1. Prüfe workspace/.logs/agent_latest.txt auf Fehler
2. Prüfe workspace/.logs/system.log für Details
3. Versuche die gleiche Aufgabe im Chat-Modus

Erweiterungs-Probleme¶

Erweiterung verbindet nicht¶

Prüfe:

1. Ist sie in Einstellungen → Integrationen aktiviert?
2. Sind deine Zugangsdaten korrekt?
3. Ist der Dienst von deinem Netzwerk aus erreichbar?

Authentifizierungsfehler¶

"Rate Limit"-Fehler¶

Du machst zu viele Anfragen.

Lösungen:

1. Warte ein paar Minuten und versuche es erneut
2. Verwende Batch-Operationen statt Einzelanfragen
3. Prüfe, ob dein Dienstplan Limits hat

Dateizugriffs-Probleme¶

"Berechtigung verweigert"¶

Lösungen:

1. Stelle sicher, dass die Datei nicht in einem anderen Programm geöffnet ist
2. Prüfe, ob du Zugriff auf den Ordner hast
3. Versuche an einem anderen Ort zu speichern

"Datei nicht gefunden"¶

Lösungen:

1. Überprüfe den Dateipfad nochmal
2. Verwende den vollständigen Pfad (z.B. C:\Dokumente\datei.pdf)
3. Stelle sicher, dass die Datei tatsächlich existiert

Performance-Probleme¶

Langsamer Start¶

Ursachen:

• Viele Erweiterungen werden geladen
• Große Wissensbasis
• Langsame Festplatte

Lösungen:

1. Deaktiviere nicht verwendete Erweiterungen
2. Reduziere die Anzahl der Wissensdateien
3. Erwäge eine SSD zu verwenden

Hoher Speicherverbrauch¶

Lösungen:

1. Starte DeskAgent regelmäßig neu
2. Lösche den workspace/.temp/-Ordner
3. Verwende weniger Erweiterungen gleichzeitig

Weitere Hilfe¶

Logs prüfen¶

Die nützlichsten Logs sind:

• workspace/.logs/system.log - Allgemeine Systemaktivität
• workspace/.logs/agent_latest.txt - Details des letzten Agent-Laufs

Support kontaktieren¶

Wenn du das Problem nicht lösen kannst:

1. Notiere, was du versucht hast zu tun
2. Kopiere alle Fehlermeldungen
3. Prüfe die Logs für Details
4. Kontaktiere den realvirtual Support