Documentación de BibGenieSolución de problemas
Diagnostica errores BibGenie comunes y resuelve problemas de modelo, red y configuración.
Esta página le ayuda a diagnosticar errores BibGenie comunes y a elegir el siguiente paso correcto.
Actualice primero
Antes de solucionar problemas, asegúrese de estar utilizando la última versión de BibGenie. Es posible que muchos problemas de modelo, compatibilidad con Zotero y red ya se hayan solucionado en una versión más reciente.
Los detalles del error son importantes
Los cuadros de diálogo de error suelen incluir detalles útiles como el nombre del modelo, la URL de solicitud, la respuesta del proveedor y el motivo del error. Léalos atentamente antes de cambiar la configuración.
Modelo no compatible
Lo que ve
Un cuadro de diálogo titulado "ModelNotSupported".
Causa probable
El modelo seleccionado no admite el tipo de entrada actual. Esto sucede a menudo cuando envía una imagen a un modelo que no admite entrada de visión.
Cómo solucionarlo
Elija un modelo que admita la capacidad requerida, como Vision para entrada de imágenes o capturas de pantalla.
Si está utilizando un modelo personalizado y sabe que admite imágenes, verifique que el modelo esté marcado como modelo Vision en modelos personalizados.
Si la tarea requiere el uso de herramientas, asegúrese de que el modelo admita Llamadas a funciones.
AI_APICallError
Lo que ve
Un cuadro de diálogo titulado "AI_APICallError".
Causa probable
La solicitud de API del modelo falló. Las causas comunes incluyen clave API no válida, ID de modelo incorrecto, URL base incorrecta, tiempo de espera del proveedor o falla de la red.
Tipos de errores comunes
Las claves no válidas o caducadas pueden generar mensajes como:
Unauthorized Failure reason: Authentication Fails
(auth header format should be Bearer sk-...)Incorrect API key provided.Verifique que la clave API esté completa, activa y pertenezca al proveedor que seleccionó.
Las ID de modelo incorrectas pueden generar mensajes como:
Model Not ExistCompare el ID del modelo en BibGenie con el ID del modelo exacto mostrado por el proveedor.
Las URL base incorrectas pueden producir errores de solicitud o 404.
Verifique la ruta de la versión
Muchos proveedores requieren una URL base que termine en /v1. Una URL como /v/ en lugar de /v1/ fallará.
Cómo solucionarlo
Error de red
Lo que ve
Un error como TypeError: NetworkError when attempting to fetch resource.
Causa probable
BibGenie no pudo alcanzar el punto final del proveedor.
Posibles causas:
- El servidor del modelo local no se está ejecutando.
- La URL base o el puerto son incorrectos.
- El firewall, el proxy o la política de red bloquean la solicitud.
- El punto final del proveedor no está disponible temporalmente.
- El proveedor configurado no admite solicitudes del lado del navegador en su entorno.
Problemas de apego o contexto
Si BibGenie no puede leer un PDF, una instantánea, una nota o un texto seleccionado:
- Asegúrese de que el archivo exista en este dispositivo.
- Si utiliza la sincronización Zotero, verifique que el archivo adjunto se haya descargado localmente.
- Para los usuarios de WebDAV, verifique que la sincronización del archivo Zotero esté funcionando.
- Intente abrir el archivo adjunto directamente en Zotero.
- Reinicie Zotero si el estado del lector parece obsoleto.
MCP Problemas de conexión
Si un cliente MCP externo no puede conectarse:
- Confirme que Habilitar servidor MCP esté activado.
- Copie la URL del servidor nuevamente.
- Haga clic en Probar conexión en Configuración de MCP.
- Asegúrese de que Zotero todavía se esté ejecutando.
- Desconecte a los clientes en los que no confía.
Obtener ayuda
Si el problema persiste, envíe la siguiente información cuando solicite ayuda:
- Versión BibGenie
- Versión Zotero
- Sistema operativo
- Ya sea que esté utilizando un modelo oficial o personalizado
- Tipo de proveedor e ID de modelo
- Mensaje de error completo
- Si el problema ocurre con un PDF, nota o tipo de contexto específico
Canal de soporte
Puede unirse al BibGenie Discord community para obtener ayuda.