BibGenie-DokumentationFehlerbehebung
Diagnostiziere häufige BibGenie-Fehler und löse Modell-, Netzwerk- und Konfigurationsprobleme.
Diese Seite hilft dir, häufige BibGenie-Fehler zu diagnostizieren und den passenden nächsten Schritt zu wählen.
Zuerst aktualisieren
Stelle vor der Fehlerbehebung sicher, dass du die neueste Version von BibGenie verwendest. Viele Modell-, Zotero-Kompatibilitäts- und Netzwerkprobleme sind in neueren Versionen möglicherweise bereits behoben.
Fehlerdetails sind wichtig
Fehlerdialoge enthalten oft nützliche Details wie Modellname, Request URL, Anbieterantwort und Fehlergrund. Lies sie sorgfältig, bevor du Einstellungen änderst.
ModelNotSupported
Was du siehst
Ein Dialog mit dem Titel "ModelNotSupported".
Wahrscheinliche Ursache
Das ausgewählte Modell unterstützt den aktuellen Eingabetyp nicht. Das passiert häufig, wenn du ein Bild an ein Modell sendest, das keine Vision-Eingaben unterstützt.
So behebst du es
Wähle ein Modell, das die benötigte Fähigkeit unterstützt, zum Beispiel Vision für Bild- oder Screenshot-Eingaben.
Wenn du ein eigenes Modell verwendest und weißt, dass es Bilder unterstützt, prüfe, ob es in Custom Models als Vision-Modell markiert ist.
Wenn die Aufgabe Tool-Nutzung erfordert, stelle sicher, dass das Modell Function Calling unterstützt.
AI_APICallError
Was du siehst
Ein Dialog mit dem Titel "AI_APICallError".
Wahrscheinliche Ursache
Die Modell-API-Anfrage ist fehlgeschlagen. Häufige Ursachen sind ein ungültiger API Key, eine falsche Model ID, eine fehlerhafte Base URL, ein Anbieter-Timeout oder ein Netzwerkfehler.
Häufige Fehlertypen
Ungültige oder abgelaufene Schlüssel können Meldungen wie diese erzeugen:
Unauthorized Failure reason: Authentication Fails
(auth header format should be Bearer sk-...)Incorrect API key provided.Prüfe, ob der API Key vollständig und aktiv ist und zum ausgewählten Anbieter gehört.
Falsche Model IDs können Meldungen wie diese erzeugen:
Model Not ExistVergleiche die Model ID in BibGenie mit der exakten Modell-ID, die der Anbieter anzeigt.
Fehlerhafte Base URLs können Request- oder 404-Fehler auslösen.
Versionspfad prüfen
Viele Anbieter verlangen eine Base URL, die auf /v1 endet. Eine URL wie /v/ statt /v1/ schlägt fehl.
So behebst du es
NetworkError
Was du siehst
Einen Fehler wie TypeError: NetworkError when attempting to fetch resource.
Wahrscheinliche Ursache
BibGenie konnte den Anbieter-Endpunkt nicht erreichen.
Mögliche Ursachen:
- Der lokale Modellserver läuft nicht.
- Base URL oder Port ist falsch.
- Firewall, Proxy oder Netzwerkrichtlinie blockiert die Anfrage.
- Der Anbieter-Endpunkt ist vorübergehend nicht verfügbar.
- Der konfigurierte Anbieter unterstützt in deiner Umgebung keine browserseitigen Anfragen.
Probleme mit Anhängen oder Kontext
Wenn BibGenie ein PDF, einen Snapshot, eine Notiz oder ausgewählten Text nicht lesen kann:
- Stelle sicher, dass die Datei auf diesem Gerät vorhanden ist.
- Wenn du Zotero-Sync verwendest, prüfe, ob der Anhang lokal heruntergeladen wurde.
- Prüfe als WebDAV-Nutzer, ob Zotero-Dateisync funktioniert.
- Öffne den Anhang testweise direkt in Zotero.
- Starte Zotero neu, wenn der Reader-Zustand veraltet wirkt.
MCP-Verbindungsprobleme
Wenn ein externer MCP-Client keine Verbindung herstellen kann:
- Bestätige, dass Enable MCP Server aktiviert ist.
- Kopiere die Server URL erneut.
- Klicke in MCP Settings auf Test Connection.
- Stelle sicher, dass Zotero noch läuft.
- Trenne Clients, denen du nicht vertraust.
Hilfe erhalten
Wenn das Problem bestehen bleibt, sende bei deiner Support-Anfrage folgende Informationen:
- BibGenie-Version
- Zotero-Version
- Betriebssystem
- Ob du ein offizielles oder eigenes Modell verwendest
- Provider Type und Model ID
- Vollständige Fehlermeldung
- Ob das Problem bei einem bestimmten PDF, einer Notiz oder einem Kontexttyp auftritt
Support-Kanal
Du kannst der BibGenie Discord-Community beitreten, um Support zu erhalten.