LogoBibGenie-Dokumentation

Fehlerbehebung

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 Exist

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

On this page