> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# ナレッジコンテンツの管理
## ドキュメントの管理
ナレッジベース内では、インポートされたすべてのアイテム（ローカルファイル、Notion ページ、またはウェブページなど）がドキュメントとして扱われます。
ドキュメント一覧から、すべてのドキュメントを閲覧・管理し、ナレッジの正確性、関連性、最新性を維持できます。
画面上部のナレッジベース名をクリックすると、他のナレッジベースへ素早く切り替えできます。
| 操作 | 説明 |
| :------------ | :----------------------------------------------------------------------------------------------------------------- |
| 追加 | 新しいドキュメントをインポートします。 |
| チャンク設定の変更 | ドキュメントのチャンク設定を変更します（チャンク構造を除く）。各ドキュメントには個別のチャンク設定を持たせることができますが、チャンク構造はナレッジベース全体で共通であり、一度設定すると変更できません。 |
| 削除 | ドキュメントを完全に削除します。**削除は元に戻せません。** |
| 有効／無効 | 一時的にドキュメントを検索対象に含める／除外します。 |
| アーカイブ／アーカイブ解除 | 検索には不要だが保持しておきたいドキュメントをアーカイブします。アーカイブ済みドキュメントは読み取り専用で、いつでもアーカイブ解除可能です。 |
| 編集 | ドキュメント内のチャンクを編集して、コンテンツを修正します。詳細は [チャンクの管理](#チャンクの管理) を参照してください。 |
| 名前を変更 | ドキュメントの名前を変更します。 |
## チャンクの管理
チャンク設定に基づき、すべてのドキュメントは検索の基本単位であるコンテンツチャンクに分割されます。
各ドキュメント内のチャンク一覧からそれらを閲覧・管理し、検索の効率と精度を向上させることができます。
左上のドキュメント名をクリックすると、別のドキュメントへ素早く切り替えられます。
| 操作 | 説明 |
| :------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 追加 | 新しいチャンクを 1 つまたは複数まとめて追加します。
親子分割モードのドキュメントでは、親チャンクと子チャンクの両方を追加可能です。 |
| 削除 | チャンクを完全に削除します。**削除は元に戻せません。** |
| 有効／無効 | 一時的にチャンクを検索対象に含める／除外します。無効化されたチャンクは編集できません。 |
| 編集 | チャンクの内容を修正します。編集されたチャンクには **Edited** マークが付きます。
親子分割モードを使用するナレッジベースでは：- 親チャンクを編集するとき、子チャンクを再生成するか変更せずに保持するかを選択できます。
- 子チャンクを編集しても、親チャンクは更新されません。
|
| キーワードの追加／編集／削除 | チャンクにキーワード（最大 10 個）を追加・編集して検索精度を向上させます。経済的インデックス方式を使用するナレッジベースでのみ利用可能です。 |
| 画像添付ファイルの追加／削除 | ドキュメントから抽出された画像を削除したり、対応するチャンク内に新しい画像をアップロードしたりできます。
抽出された画像の URL はチャンクテキスト内に残りますが、テキストをきれいに保つためにこれらの URL を安全に削除できます。抽出された画像には影響しません。各チャンクにはデフォルトで最大 10 枚まで画像の添付が可能で、検索時にチャンクと一緒に返されます。この制限を超える画像は抽出されません。制限は環境変数 `SINGLE_CHUNK_ATTACHMENT_LIMIT` で調整できます。マルチモーダル埋め込みモデル（**Vision** アイコン付き）を選択すると、抽出された画像も埋め込み・インデックス化され、検索に利用されます。 |
## ベストプラクティス
### チャンク品質の確認
ドキュメントをチャンク分割した後は、各チャンクを丁寧に確認し、意味的に完結し、検索精度と回答の関連性を最適化できるサイズであることを確認してください。
注意すべき一般的な問題：
* チャンクが **短すぎる**：文脈不足により意味情報が失われ、回答の精度が低下します。
* チャンクが **長すぎる**：不要情報を含み、意味的ノイズを引き起こして検索精度を下げます。
* チャンクが **意味的に不完全**：文や段落の途中で強制的に区切られた結果、検索時に情報が欠落または誤解を招く場合があります。
### 子チャンクを親チャンクの検索フックとして使用
親子分割モードで分割されたドキュメントでは、システムは子チャンクを検索し、結果として親チャンクを返します。子チャンクを編集しても親チャンクは更新されないため、子チャンクを親チャンクの **セマンティックタグ（意味的タグ）** や **検索ヒント** として活用できます。
そのためには、子チャンクを **キーワード** ・**要約** ・**ユーザーの一般的な質問** のいずれかに書き換えることを推奨します。
たとえば、親チャンクが技術的な「LED ステータスインジケーター」を扱う場合、子チャンクを次のように設定できます：
* *点滅、電源が入らない、赤いライト、接続エラー、フリーズ*（キーワード）
* *LED の色の解釈とハードウェアの電源やペアリング問題のトラブルシューティングガイド*（要約）
* *赤いライトが点灯し続けるのはどういう意味ですか？*（クエリ）