Dify v1.12.0は避けて v1.12.1 を使うべき理由(Summary Index / AI要約の表示場所も解説)
Dify v1.12系では、ナレッジ検索を強化する Summary Index(AI要約による検索補助) が導入されました。
ただし、検証・利用を始めるなら v1.12.0ではなく v1.12.1 を推奨します。理由は、v1.12.1 が クライアント側 base URL 修正などのバグ修正を含むパッチ版だからです。
参考:Dify Releases(v1.12.1)(github.com)
この記事の対象
- Dify(Self-host / OSS)を使っている人
- v1.12系の Summary Index / Summary Auto-Gen(AI要約) を試したい人
- v1.12.0で挙動が不安定だった人(筆者は起動直後の画面表示で詰まった)
結論:v1.12.0は避けて v1.12.1 を使う
v1.12.1 のリリースノート上でも、以下のように 「Fix base URL in client and other bugs」 が明記されています。実際、v1.12.1 では base URL 修正や自動要約(auto summary)関連の環境変数修正などが入っています。
参考:Dify Releases(v1.12.1)(github.com)
- fix: base url in client
- fix: auto summary env
- ほか複数の不具合修正
v1.12.0で筆者が遭遇した不具合(アプリ一覧が表示されない)
筆者の環境では、v1.12.0 でDifyを起動すると、ログイン後の起動画面でアプリ一覧などが表示されない事象が発生しました。
- 症状:ログイン後、アプリ一覧(Apps)が出ず、画面が期待どおり表示されない
- 影響:管理画面に入れない/操作が進まない
- 対応:v1.12.1へ上げたところ改善(同環境で再現しなくなった)
※この事象は筆者環境での再現であり、全環境で必ず起きると断言するものではありません。
ただし v1.12.1 は「クライアント base URL 修正」を含むため、UI表示・遷移系のトラブルに当たった場合はアップデートを優先するのが安全です。
v1.12.0/1.12.1の目玉:Summary Index(AI要約で検索を賢くする)
Summary Index は、ナレッジ内の文書をチャンク化したあとに 各チャンクの要約(summary)を生成して埋め込みし、検索に使う仕組みです。
「本文チャンクの埋め込み」だけでは拾いにくい問い合わせに対しても、要約ベースで当たりやすくするのが狙いです。
参考:v1.12.0 リリース議論(Summary Index)(github.com)
AI要約(Summary Auto-Gen)はどこに表示される?
ここが一番ハマりやすいポイントですが、AI要約は **ドキュメント全体の要約ではなく “チャンクごとの要約”**として管理されます。
1) 取り込み時:Summary Auto-Gen をONにする場所
ナレッジに文書を追加するときの チャンク設定(Chunk Settings) に
Enable Summary Auto-Gen(Summary Auto-Gen を有効化) があります。
参考:Chunking & Cleaning Text(Knowledge)(docs.dify.ai)
- Self-hosted(オンプレ/OSS)限定の機能
- ONにすると 新規追加された文書・チャンクに対して要約が生成される
- 要約は検索用に埋め込み・インデックス化され、要約がクエリにマッチすると 対応する本文チャンクが返る
2) 既存文書:ドキュメント単位で「要約生成」する場所
既存文書(すでに取り込み済み)に要約を付けたい場合、
**Documents(ドキュメント一覧)から対象ドキュメントを選んで「Generate Summary」**を実行します。
参考:Maintain Knowledge Documents(Knowledge)(docs.dify.ai)
- 「Generate Summary」は そのドキュメント内の全チャンク要約を自動生成
- 既存の要約は上書きされる(注意)
3) 表示・編集:AI要約が見える場所(チャンク画面)
要約の“表示先”はここです。
Knowledge → 対象データセット → Documents → 対象ドキュメント → チャンク(Chunks)
このチャンク画面で、各チャンクに紐づく ** Summary(要約) ** を確認・手編集できます。
また、必要ならドキュメント単位で再生成も可能です。
参考:Chunking & Cleaning Text(Knowledge)(docs.dify.ai)
まとめ
- v1.12系の目玉は Summary Index(チャンク要約を検索に使う)
- ただし、利用開始は v1.12.0ではなく v1.12.1推奨(base URL修正など複数バグ修正入り)
- AI要約は ドキュメント全体ではなくチャンクごとに付く
- 取り込み時:Chunk Settingsで Summary Auto-Gen ON
- 既存文書:Documentsで Generate Summary
- 表示先:ドキュメントのチャンク(Chunks)画面で要約を確認・編集