LogoDocumentation BibGenie

Dépannage

Diagnostiquez les erreurs courantes de BibGenie et résolvez les problèmes de modèles, réseau et configuration.

Cette page vous aide à diagnostiquer les erreurs courantes de BibGenie et à choisir la bonne étape suivante.

Commencez par mettre à jour

Avant de dépanner, assurez-vous d'utiliser la dernière version de BibGenie. De nombreux problèmes de modèles, de compatibilité Zotero ou de réseau peuvent déjà être corrigés dans une version plus récente.

Les détails d'erreur comptent

Les boîtes de dialogue d'erreur contiennent souvent des informations utiles comme le nom du modèle, la Request URL, la réponse du fournisseur et la raison de l'échec. Lisez-les attentivement avant de modifier les paramètres.

ModelNotSupported

Ce que vous voyez

Une boîte de dialogue intitulée "ModelNotSupported".

Cause probable

Le modèle sélectionné ne prend pas en charge le type d'entrée actuel. Cela arrive souvent lorsque vous envoyez une image à un modèle qui ne prend pas en charge les entrées Vision.

Comment corriger

Choisissez un modèle qui prend en charge la capacité requise, par exemple Vision pour les images ou captures d'écran.

Si vous utilisez un modèle personnalisé et savez qu'il prend en charge les images, vérifiez qu'il est marqué comme modèle Vision dans Custom Models.

Si la tâche nécessite l'utilisation d'outils, assurez-vous que le modèle prend en charge Function Calling.

AI_APICallError

Ce que vous voyez

Une boîte de dialogue intitulée "AI_APICallError".

Cause probable

La requête vers l'API du modèle a échoué. Les causes fréquentes incluent une API Key invalide, un mauvais Model ID, une Base URL incorrecte, un délai d'attente fournisseur ou une panne réseau.

Types d'erreurs courants

Les clés invalides ou expirées peuvent produire des messages comme :

Unauthorized Failure reason: Authentication Fails
(auth header format should be Bearer sk-...)
Incorrect API key provided.

Vérifiez que l'API Key est complète, active et qu'elle appartient au fournisseur sélectionné.

De mauvais Model IDs peuvent produire des messages comme :

Model Not Exist

Comparez le Model ID dans BibGenie avec l'identifiant exact affiché par le fournisseur.

Des Base URLs incorrectes peuvent provoquer des erreurs de requête ou des 404.

Vérifiez le chemin de version

De nombreux fournisseurs exigent une Base URL se terminant par /v1. Une URL comme /v/ au lieu de /v1/ échouera.

Comment corriger

NetworkError

Ce que vous voyez

Une erreur comme TypeError: NetworkError when attempting to fetch resource.

Cause probable

BibGenie n'a pas pu atteindre le point de terminaison du fournisseur.

Causes possibles :

  • Le serveur de modèle local n'est pas lancé.
  • La Base URL ou le port est incorrect.
  • Un pare-feu, un proxy ou une politique réseau bloque la requête.
  • Le point de terminaison du fournisseur est temporairement indisponible.
  • Le fournisseur configuré ne prend pas en charge les requêtes côté navigateur dans votre environnement.

Problèmes de pièces jointes ou de contexte

Si BibGenie ne peut pas lire un PDF, un instantané, une note ou un texte sélectionné :

  • Assurez-vous que le fichier existe sur cet appareil.
  • Si vous utilisez la synchronisation Zotero, vérifiez que la pièce jointe a été téléchargée localement.
  • Pour les utilisateurs WebDAV, vérifiez que la synchronisation des fichiers Zotero fonctionne.
  • Essayez d'ouvrir directement la pièce jointe dans Zotero.
  • Redémarrez Zotero si l'état du lecteur semble obsolète.

Problèmes de connexion MCP

Si un client MCP externe ne parvient pas à se connecter :

  • Confirmez que Enable MCP Server est activé.
  • Copiez à nouveau la Server URL.
  • Cliquez sur Test Connection dans MCP Settings.
  • Assurez-vous que Zotero est toujours en cours d'exécution.
  • Déconnectez les clients auxquels vous ne faites pas confiance.

Obtenir de l'aide

Si le problème persiste, envoyez les informations suivantes lorsque vous demandez de l'aide :

  • Version de BibGenie
  • Version de Zotero
  • Système d'exploitation
  • Utilisation d'un modèle officiel ou personnalisé
  • Provider Type et Model ID
  • Message d'erreur complet
  • Indiquez si le problème survient avec un PDF, une note ou un type de contexte particulier

Canal de support

Vous pouvez rejoindre la communauté Discord BibGenie pour obtenir de l'aide.

On this page