BibGenieドキュメントトラブルシューティング
BibGenie でよくあるエラーを診断し、モデル、ネットワーク、設定の問題を解決します。
このページでは、BibGenie でよくあるエラーを診断し、適切な次の手順を選ぶための情報をまとめています。
まず更新してください
トラブルシューティングの前に、BibGenie の最新版を使用していることを確認してください。モデル、Zotero 互換性、ネットワークに関する多くの問題は、新しいリリースですでに修正されている場合があります。
エラー詳細は重要です
エラーダイアログには、モデル名、Request URL、プロバイダーの応答、失敗理由などの有用な情報が含まれることがあります。設定を変更する前に、内容をよく確認してください。
ModelNotSupported
表示される内容
"ModelNotSupported" というタイトルのダイアログ。
考えられる原因
選択中のモデルが現在の入力タイプに対応していません。Vision 入力に対応していないモデルへ画像を送信した場合によく発生します。
修正方法
画像やスクリーンショット入力には Vision など、必要な機能に対応したモデルを選びます。
カスタムモデルを使っていて、そのモデルが画像に対応している場合は、Custom Models で Vision モデルとしてマークされているか確認します。
タスクでツール利用が必要な場合は、モデルが Function Calling に対応していることを確認します。
AI_APICallError
表示される内容
"AI_APICallError" というタイトルのダイアログ。
考えられる原因
モデル API リクエストに失敗しました。一般的な原因には、無効な API Key、誤った Model ID、不正な Base URL、プロバイダーのタイムアウト、ネットワーク障害などがあります。
よくあるエラー種別
無効または期限切れのキーでは、次のようなメッセージが表示されることがあります。
Unauthorized Failure reason: Authentication Fails
(auth header format should be Bearer sk-...)Incorrect API key provided.API Key が完全で有効であり、選択したプロバイダーのものか確認してください。
誤った Model ID では、次のようなメッセージが表示されることがあります。
Model Not ExistBibGenie の Model ID と、プロバイダーが表示している正確なモデル ID を照合してください。
不正な Base URL は、リクエストエラーや 404 エラーを引き起こすことがあります。
バージョンパスを確認
多くのプロバイダーでは、Base URL が /v1 で終わる必要があります。/v1/ ではなく /v/ のような URL は失敗します。
修正方法
NetworkError
表示される内容
TypeError: NetworkError when attempting to fetch resource. のようなエラー。
考えられる原因
BibGenie がプロバイダーのエンドポイントへ到達できませんでした。
考えられる原因：
- ローカルモデルサーバーが起動していない。
- Base URL またはポートが正しくない。
- ファイアウォール、プロキシ、ネットワークポリシーがリクエストをブロックしている。
- プロバイダーのエンドポイントが一時的に利用できない。
- 設定されたプロバイダーが、この環境でブラウザー側リクエストをサポートしていない。
添付ファイルまたはコンテキストの問題
BibGenie が PDF、スナップショット、ノート、選択テキストを読めない場合：
- ファイルがこのデバイスに存在することを確認してください。
- Zotero 同期を使っている場合は、添付ファイルがローカルにダウンロード済みか確認してください。
- WebDAV ユーザーは、Zotero のファイル同期が機能しているか確認してください。
- Zotero で添付ファイルを直接開いてみてください。
- リーダーの状態が古いように見える場合は、Zotero を再起動してください。
MCP 接続の問題
外部 MCP クライアントが接続できない場合：
- Enable MCP Server がオンになっていることを確認します。
- Server URL をもう一度コピーします。
- MCP Settings で Test Connection をクリックします。
- Zotero がまだ起動していることを確認します。
- 信頼できないクライアントは切断します。
ヘルプを受ける
問題が続く場合は、問い合わせ時に次の情報を送ってください。
- BibGenie のバージョン
- Zotero のバージョン
- オペレーティングシステム
- 公式モデルまたはカスタムモデルのどちらを使用しているか
- Provider Type と Model ID
- 完全なエラーメッセージ
- 特定の PDF、ノート、コンテキスト種別で発生する問題かどうか
サポートチャンネル
サポートが必要な場合は、BibGenie Discord コミュニティ に参加できます。