BibGenieBibGenie

Dépannage

Diagnostiquez et résolvez les anomalies courantes dans Zotero : pannes d’API, délais d’extraction PDF dépassés, quotas de modèles et conflits d’extensions.

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.

Trouver la bonne aide

ProblèmePar où commencer
Erreur de clé API, de modèle ou de connexion localeModèles personnalisés
Le contenu de l’article manque dans la réponseAjouter du contexte
La recherche sémantique manque des articles ou l’indexation échoueIndex sémantique
Un client IA externe ne se connecte pas à ZoteroParamètres MCP
Échec d’accès ou de mise à jour dans NotionConnexion Notion

Avant de partager une erreur pour obtenir de l’aide, retirez les clés API et les données de recherche privées. Conservez le nom de l’erreur et les informations utiles sur le modèle ou la connexion.

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

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.

Statistiques d’utilisation et synchronisation

  • Synchronisation incomplète : Les données enregistrées restent disponibles. Vérifiez la connexion et relancez la synchronisation.
  • Impossible d’enregistrer l’utilisation locale : Les statistiques peuvent être incomplètes. Une synchronisation réussie ne reconstitue pas les données jamais enregistrées. Vérifiez l’espace disque et contactez l’assistance si l’avertissement persiste ; ne supprimez pas la base de données d’utilisation.

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.