Documentation BibGenieDé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 ExistComparez 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.