インデックス作成のエラーコード

AI Search はアップロード、同期、クロールのリクエストを受け付けたあと、検索できるようにコンテンツをバックグラウンドで処理します。処理に失敗すると、このページのいずれかのエラーコードが記録されます。1 つのアイテムだけに影響するエラーと、インスタンス全体を停止するエラーがあります。

この処理はリクエスト成功のあとで行われるため、元の API レスポンスにはエラーは返りません。確認するには、アイテムログ、アイテム詳細、またはインスタンスの統計を見てください。リクエスト失敗時にすぐ返るエラーは、API エラーコード に別途記載しています。

インデックス作成のエラーは非同期です。アップロード、同期、クロールのリクエストは成功したあと、AI Search の処理中にコンテンツが失敗することがあります。次の 2 種類に分かれます。

• アイテム単位のエラー は 1 つのアイテムにだけ影響します。そのアイテムは status: "error" になり、インスタンスのほかの処理は続きます。
• インスタンス単位のエラー はインスタンス全体に影響します。ソース、トークン、モデル、上限などの問題ですべてのアイテムが止まるため、AI Search はインデックス作成を一時停止します。

失敗した 1 つのアイテムを再試行するには、アイテムログ を確認し、明らかなソースや設定の問題を直してから、もう一度 アイテムを同期 します。Website と R2 のデータソースでは、ソース同期ジョブ も実行できます。

インスタンスが一時停止している場合は、根本原因を解消してからインスタンスを再開します。

一時的なエラーが再試行後も続く場合は、アイテム ID、インスタンス ID、エラーコード、リクエスト時刻を添えて Cloudflare サポート に問い合わせてください。

これらのエラーは 1 つのアイテムにだけ影響します。そのアイテムは status: "error" になり、インスタンスのほかの処理は続きます。アイテムを直すか、再試行してください。

これらのエラーは、AI Search がソースファイルを読み取れない、変換できない、チャンク分割できない、埋め込めないときに出ます。対応形式とファイルサイズの上限は データソース を参照してください。チャンク分割とモデルの上限は チャンク分割 と 対応モデル を参照してください。

これらのエラーは、Website データソース のページを AI Search が取得、レンダリング、または取り込みできないときに出ます。AI Search はバックグラウンドで Browser Run を使ってページをクロールし、レンダリングします。この管理は AI Search 側で行います。

これらのエラーは、埋め込みモデル、Workers AI、外部プロバイダー、または AI Gateway がアイテムのコンテンツを処理できないときに出ます。

これらのエラーは、アイテムの保存やインデックスに失敗したとき、またはインスタンスが容量上限に達したときに出ます。AI Search はバックグラウンドで Vectorize を使ってベクトルを保存します。この管理は AI Search 側で行います。

これらのエラーはインスタンス全体を一時停止し、根本原因を解消してインスタンスを再開するまで、すべてのインデックス作成を止めます。手動の一時停止や、一定期間の非活動後の自動一時停止とは別です。