ほとんどのインシデントは認証情報、スコープ、古いコンテンツに関するものです。本ページでは迅速なトリアージ順序を示します。チケット作成時はログとタイムスタンプを添付してください。
ダッシュボードのテスト チャットで再現し、問題がチャネル固有か、エージェント全体に及ぶかを判断してください。
サポート
トラブルシューティング
よくある障害 — キー、コネクター、ウィジェット CSP、空の取得 — およびサポートに連絡する前に原因を切り分ける方法。
トラブルシューティングエラーデバッグ
API キーとモデル キーのエラー
401/403 は通常、誤ったキー、誤った組織、または期限切れの BYOK 認証情報を示します。環境（本番 vs ステージング）が設定したキーと一致しているか確認してください。
ローテーション後、ヘッダーをキャッシュしている依存サービスを再起動または更新してください。
弱いまたは空の回答
エージェントが期待するナレッジベースを使用しているか確認してください。コンテンツが最近変更された場合、同期またはクロール ジョブを再実行してください。
指示が過度に制限的でないか確認してください — 取得が正しくても、モデルが拒否する場合があります。
ウィジェットが読み込まれない
CSP、広告ブロッカー、スクリプト配置を確認してください。connect-src ホストがブロックされているコンソール エラーを探してください。
埋め込みキーがエージェントおよび（有効な場合）許可ドメイン リストと一致しているか確認してください。
インポートまたはクロールのクォータ エラー（402 / 「上限到達」）
多数の画像またはメディア ファイルの後にナレッジ インポートがクォータまたは支払いエラーで失敗する場合、ホスト型の月次 Gemini 画像認識またはメディア文字起こし制限を使い切った可能性があります。
緩和策：設定 → LLM API キーで Google Gemini API キーを追加し、これらの操作が Google プロジェクトを使用するようにする、管理者にプラン上限の引き上げを依頼する、または一時的にネイティブ テキスト形式をインポートし、クロールのメディア処理を無効化する。
- 画像またはメディアを有効にしたクロールには、解決可能な Gemini 設定（ホスト型または組織）が必要です。ない場合、API は Gemini 不足メッセージでクロール開始を拒否します。
- Vision をスキップした場合でも、画像からの OCR テキストのみが表示されることがあります。ファイルが完全に失敗したと決めつけないでください — 保存されたドキュメント本文を確認してください。
さらに探索する