Open WebUI、埋め込みバッチ設定の空値を修正　ファイルのアップロード後に処理が失敗する問題に対応

Open WebUIは10月28日、PR #33288をdevブランチにマージし、ドキュメント設定における空値処理の不具合を修正しました。管理者がEmbedding Batch Sizeを空にして保存すると、その後にアップロードしたファイルの処理が完了しないことがありました。この変更は、ドキュメントの取り込みと検索拡張生成（RAG）の前処理に直接影響します。修正記録

報告者はLinuxの開発版でOllama埋め込みエンジンを使って問題を再現し、OpenAI互換エンジンのテスト環境でも同じ結果になったと述べています。管理画面のDocumentsページでバッチサイズを空にして保存すると、システムは保存成功を表示します。ページを再読み込みすると数値の1が再び表示されることさえありますが、小さなテキストファイルを添付すると、NoneTypeを整数として扱えないというエラーが発生しました。画面上のデフォルト表示が、実際の設定状態を見えにくくしていました。不具合報告

公式ドキュメントによると、このパラメーターは外部の埋め込みサービスが1回のAPIリクエストで受け取るテキストチャンク数を制御します。デフォルトは1で、Ollama、OpenAI、Azure OpenAIで使用できますが、デフォルトのSentenceTransformersエンジンには適用されません。バッチサイズを増やすとリクエスト数を減らせますが、サービスとモデルが複数入力に対応していることを事前に確認する必要があります。また、同時リクエスト数を制御する並行処理パラメーターとは別の設定です。設定ドキュメント

修正の説明では、原因は設定の書き込み境界にあるとされています。空のフィールドはnullとして送信され、バックエンドがそのまま保存していた一方、埋め込み関数は数値を必要としていました。新しい処理では、保存時に空値を1に変換します。作者によると、修正後は同じテキストファイルを正常に処理でき、既存ドキュメントと検索関連のテストも通過したとのことです。これらの検証結果は、貢献者から報告されたものです。修正と検証

運用担当者にとって、この事例はドキュメントの取り込みに失敗した際、設定が有効な数値として実際に保存されているかも確認すべきことを示しています。影響を受けた環境では、有効なバッチサイズを入力して再保存し、小さなファイルをアップロードして復旧を確認できます。現時点で確認できるのは、修正が開発ブランチにマージされたことまでであり、安定版に含まれたとは判断できません。空値が設定済みの環境では、修正の説明にあるとおり、Documents設定をもう一度保存する必要があります。対応に関する説明