トラブルシューティングとプライバシー

権限

403 FORBIDDEN は、現在のワークスペースロールに必要な権限（document:upload、agent:run、context_engine:manage、library:edit、library:approve、graph:review、agent_credential:manage、learning:manage、ask_history:manage、または structured:manage）が無いことを意味します。ワークスペースの owner または admin にロール変更を依頼してください。セッション Cookie やパスワードは共有しないでください。

AI プロバイダーとモデルルーティング

必要なプロバイダーキーが未接続（AI_PROVIDER_NOT_CONNECTED）の場合、または選択されたモデルがワークスペースのデータポリシーで承認されていない（MODEL_NOT_APPROVED）場合、生成や埋め込みは失敗します。すべてのモデル選択（項目別または 設定 → AI モデル）はそのまま実行されるか拒否されるかのどちらかであり、別のモデルへ勝手に差し替えられることはありません。設定 → AI プロバイダー で OpenAI、Anthropic、Google のキーを接続・削除できるのは owner または admin のみです。Amazon Bedrock がチャットを担当するデプロイでは、ワークスペース選択は指定されたプロバイダーで実行されますが、エージェントやディスカバリーの項目別選択はワークスペース既定に戻さない限り MODEL_CHOICE_BEDROCK で拒否されます。

ソース、インデックス、コンテキストエンジンレイヤー

接続テストの失敗は読み取り確認が成功しなかったことを意味します。Google Drive で source_reauthorization_required が出た場合は、データ追加または設定 → 接続で同じ Google アカウントを使って Reconnect を実行します。processing から進まない抽出にはワーカーキューの稼働が必要です。検索結果が 0 件の場合は、コレクションの固定埋め込みプロファイルとインデックス済みベクトルの不一致、またはインデックス未完了が原因であることが多くあります。コンテキストエンジン（/platform/context-engine）またはコレクションの Knowledge タブを開き、文書ごとの理由コード（not_built、builder_updated、map_changed、stored_text_reversed、waiting_for_topology、budget_exhausted）を確認してください。

クォータと制限されたランタイム

認証ルート、ワークスペース検索、コンテキストスタジオ、および /api/agent/v1 エンドポイントにはレート制限（Retry-After ヘッダー付きの 429 RATE_LIMITED）が適用されます。非保持ワークスペースは保存型専用エンドポイントを 403 NON_RETAINING_WORKSPACE で拒否し、非保持抽出のランタイムが準備できていない場合は PROCESSOR_UNAVAILABLE を返します。エスカレーション時は、ワークスペース ID、コレクション ID、実行またはリクエスト ID、および error.code のみを送ってください。

プライバシー

サポートチケットやログには、プロバイダー API キー、bdk_… エージェントトークン、接続パスワード、文書のバイトデータ、回答本文を絶対に含めないでください。非保持の結果はサーバーに保存されません。保存型ワークスペースでは、非公開の質問履歴とガバナンス付きエージェントメモリは作成したメンバー本人にのみ帰属し、質問からの学習が owner によって有効化された場合も個人識別情報は保存前にマスクされます。