docker-faqsearchで、旧キーワード検索版からの更新手順と、クロール・ベクトル化の失敗検出が改善されました。helpdeskテーマにもカテゴリ選択や回答表示の修正が入り、更新後の検索結果を確かめやすくなっています。
バージョンと初期値を確認する
最新の設定例は FESS_VERSION=15.9.0、OPENSEARCH_VERSION=3.9.0、OPENSEARCH_HEAP=3g です。ただし確認時点のFess正式版は15.8.0で、15.9.0の正式イメージは配布済みと確認できていません。これらの修正を試すには対応する開発ビルドが必要です。PRでの実機検証はFess snapshotを使っています。
git pull は既存の .env や data/fess/themes/helpdesk を置き換えません。setup.shのバージョン警告は通知だけで、値は自動変更されません。更新前に .env の固定バージョンとテーマの実体を確認し、必要な値を変更してsetup.shを実行します。既存データを残す場合はバックアップを取ってから進めます。
旧15.7のキーワード検索版から文書を維持して移行する場合、メンテナンスの再インデックスで「エイリアスの更新」を行い、ベクトル対応のインデックスにします。クロールだけでは既存インデックスのベクトルマッピングは追加されません。保存済みGroovyジョブのJavaScriptへの切り替えと、Content Chunk Vector Indexerの実行も必要です。
登録スクリプトを再実行する
bin/register-faq-crawl.sh は既存の faq-content WebConfigをスクリプトのURL・除外条件などへ更新し、クロールとベクトルジョブを実行します。手動で変えた対象項目も更新される点に注意してください。--no-crawl でも設定は更新されます。
ジョブの最終状態がokでなければ失敗終了します。ベクトルジョブがokでも文書の content_chunk_status がdoneでなければ止まります。ただし検査は管理検索一覧の先頭ページのサンプルで、全件の保証ではありません。ジョブログとfess-chunk.log、実際の検索を併せて確認します。除外条件を更新しても、既に登録された入口ページなどの文書は自動削除されません。
bin/seed-faq.sh はラベルをvalue、関連コンテンツと関連クエリーをtermで照合し、未登録分だけ追加します。同じ識別子の既存内容は上書きしません。一覧取得が失敗した場合は止まります。検索ログ生成とLabel Updaterなどの実行は再実行時にも行われます。
FAQに合わせて類似度を調整する
SEMANTIC_MIN_SCORE の初期値0.3は12件のデモFAQに合わせた値です。実際のFAQでは正答の言い換えと対象外の質問を試し、モデルと内容に合わせて調整します。閾値を下げると無関係な回答も増える可能性があります。
# data/fess/opt/fess/system.properties
content_chunker.search.min_score=0.3このファイルの値はJVMの-D指定より優先され、数秒以内に検索へ反映されます。行を削除すると-Dの値に戻ります。.env 側の値を変える場合はコンテナの再作成が必要です。検索時の閾値変更なのでベクトルジョブの再実行は不要です。3gは新しい初期値ですが、あらゆる負荷で容量不足を防げる保証ではありません。
回答画面で確かめること
helpdeskテーマでは、ホームのカテゴリタイルから移動した後の新しい検索へカテゴリが残らなくなります。利用者がオプション欄で明示的に選んだカテゴリは引き継ぎます。関連検索はURLにも反映し、400で拒否された検索では以前の回答・ページャー・ファセットを消します。
閉じたオプションパネルはTab順から外れ、開閉時のフォーカスとEscape、検索欄へ移動する /、ページリンクや狭い画面の表示が改善されました。テーマのソース版は15.9.10、minFessVersionは15.9です。
Fess本体では regex: を使うおすすめ回答の不正な正規表現を保存時に拒否し、既存の不正設定は読み込み時に警告してスキップします。空の検索ではおすすめ回答を返しません。また、空白で区切られた2語以上の通常クエリーでは、末尾の英数字に続く1つの ? を疑問符として取り除きます。I forgot my password? が対象で、単語1つの te? はワイルドカードのままです。空白なしの日本語文も対象外で、find te? の末尾ワイルドカードは使えなくなるという制限があります。