> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ナレッジコンテンツの管理

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/self-host/use-dify/knowledge/manage-knowledge/maintain-knowledge-documents) を参照してください。

## ドキュメントの管理

ナレッジベース内では、インポートされたすべてのアイテム（ローカルファイル、Notion ページ、またはウェブページなど）がドキュメントとして扱われます。

ドキュメント一覧から、すべてのドキュメントを閲覧・管理し、ナレッジの正確性、関連性、最新性を維持できます。

<Tip>
  画面上部のナレッジベース名をクリックすると、他のナレッジベースへ素早く切り替えできます。
</Tip>

<Frame>
  <img src="https://mintcdn.com/dify-6c0370d8/Z6MqdkI3dck9_1H6/images/use-dify/knowledge/manage-knowledge-documents.png?fit=max&auto=format&n=Z6MqdkI3dck9_1H6&q=85&s=fa9ecc455e91a4bd78902dfaa8959890" alt="ナレッジドキュメントの管理" width="3432" height="1840" data-path="images/use-dify/knowledge/manage-knowledge-documents.png" />
</Frame>

| 操作            | 説明                                                                                                                 |
| :------------ | :----------------------------------------------------------------------------------------------------------------- |
| 追加            | 新しいドキュメントをインポートします。                                                                                                |
| チャンク設定の変更     | ドキュメントのチャンク設定を変更します（チャンク構造を除く）。<Info>各ドキュメントには個別のチャンク設定を持たせることができますが、チャンク構造はナレッジベース全体で共通であり、一度設定すると変更できません。</Info> |
| 削除            | ドキュメントを完全に削除します。**削除は元に戻せません。**                                                                                    |
| 有効／無効         | 一時的にドキュメントを検索対象に含める／除外します。                                                                                         |
| 要約を生成         | ドキュメント内のすべてのチャンクの要約を自動生成します。**サマリー自動生成** が有効な場合に利用できます。<Note>既存の要約は上書きされます。</Note>                                 |
| アーカイブ／アーカイブ解除 | 検索には不要だが保持しておきたいドキュメントをアーカイブします。アーカイブ済みドキュメントは読み取り専用で、いつでもアーカイブ解除可能です。                                             |
| 編集            | ドキュメント内のチャンクを編集して、コンテンツを修正します。詳細は [チャンクの管理](#チャンクの管理) を参照してください。                                                   |
| 名前を変更         | ドキュメントの名前を変更します。                                                                                                   |

## チャンクの管理

チャンク設定に基づき、すべてのドキュメントは検索の基本単位であるコンテンツチャンクに分割されます。

各ドキュメント内のチャンク一覧からそれらを閲覧・管理し、検索の効率と精度を向上させることができます。

<Tip>
  左上のドキュメント名をクリックすると、別のドキュメントへ素早く切り替えられます。
</Tip>

<Frame>
  <img src="https://mintcdn.com/dify-6c0370d8/Z6MqdkI3dck9_1H6/images/use-dify/knowledge/manage-document-chunks.png?fit=max&auto=format&n=Z6MqdkI3dck9_1H6&q=85&s=3b58f3fa398adfc511e8d7b7f5a1d855" alt="チャンクの管理" width="3398" height="1320" data-path="images/use-dify/knowledge/manage-document-chunks.png" />
</Frame>

| 操作             | 説明                                                                                                                                                                                                                                                                                                                                                                     |
| :------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 追加             | 新しいチャンクを 1 つまたは複数まとめて追加します。<br /><br />親子分割モードのドキュメントでは、親チャンクと子チャンクの両方を追加可能です。                                                                                                                                                                                                                                                                                         |
| 削除             | チャンクを完全に削除します。**削除は元に戻せません。**                                                                                                                                                                                                                                                                                                                                          |
| 有効／無効          | 一時的にチャンクを検索対象に含める／除外します。無効化されたチャンクは編集できません。                                                                                                                                                                                                                                                                                                                            |
| 編集             | チャンクの内容を修正します。編集されたチャンクには **Edited** マークが付きます。<br /><br />親子分割モードを使用するナレッジベースでは：<ul><li>親チャンクを編集するとき、子チャンクを再生成するか変更せずに保持するかを選択できます。</li><li>子チャンクを編集しても、親チャンクは更新されません。</li></ul>                                                                                                                                                                                       |
| キーワードの追加／編集／削除 | チャンクにキーワード（最大 10 個）を追加・編集して検索精度を向上させます。経済的インデックス方式を使用するナレッジベースでのみ利用可能です。                                                                                                                                                                                                                                                                                               |
| 画像添付ファイルの追加／削除 | ドキュメントから抽出された画像を削除したり、対応するチャンク内に新しい画像をアップロードしたりできます。<br /><br />抽出された画像の URL はチャンクテキスト内に残りますが、テキストをきれいに保つためにこれらの URL を安全に削除できます。抽出された画像には影響しません。<Note>各チャンクにはデフォルトで最大 10 枚まで画像の添付が可能で、検索時にチャンクと一緒に返されます。この制限を超える画像は抽出されません。制限は環境変数 `SINGLE_CHUNK_ATTACHMENT_LIMIT` で調整できます。</Note><Tip>マルチモーダル埋め込みモデル（**Vision** アイコン付き）を選択すると、抽出された画像も埋め込み・インデックス化され、検索に利用されます。</Tip> |
| 要約の追加／編集／削除    | チャンクに要約を追加、編集、または削除します。<br /><br />要約も埋め込み・インデックス化され、検索に利用されます。要約がクエリにマッチすると、対応するチャンクも返されます。<Tip>複数のチャンクに同一の要約を追加することで、グループ検索が可能になり、関連するチャンクをまとめて取得できます（Top K の制限に従います）。</Tip>                                                                                                                                                                                         |

## ベストプラクティス

### チャンク品質の確認

ドキュメントをチャンク分割した後は、各チャンクを丁寧に確認し、意味的に完結し、検索精度と回答の関連性を最適化できるサイズであることを確認してください。

注意すべき一般的な問題：

* チャンクが **短すぎる**：文脈不足により意味情報が失われ、回答の精度が低下します。

* チャンクが **長すぎる**：不要情報を含み、意味的ノイズを引き起こして検索精度を下げます。

* チャンクが **意味的に不完全**：文や段落の途中で強制的に区切られた結果、検索時に情報が欠落または誤解を招く場合があります。

### 子チャンクを親チャンクの検索フックとして使用

親子分割モードで分割されたドキュメントでは、システムは子チャンクを検索し、結果として親チャンクを返します。子チャンクを編集しても親チャンクは更新されないため、子チャンクを親チャンクの **セマンティックタグ（意味的タグ）** や **検索ヒント** として活用できます。

そのためには、子チャンクを **キーワード** ・**要約** ・**ユーザーの一般的な質問** のいずれかに書き換えることを推奨します。
たとえば、親チャンクが技術的な「LED ステータスインジケーター」を扱う場合、子チャンクを次のように設定できます：

* *点滅、電源が入らない、赤いライト、接続エラー、フリーズ*（キーワード）

* *LED の色の解釈とハードウェアの電源やペアリング問題のトラブルシューティングガイド*（要約）

* *赤いライトが点灯し続けるのはどういう意味ですか？*（クエリ）

### 要約を使用してクエリとコンテンツのギャップを埋める

高品質なインデックス化によりセマンティック検索が可能になりますが、生のチャンクが具体的すぎたり、ノイズが多かったり、構造が複雑すぎてユーザーのクエリとうまく一致しない場合、検索が困難になることがあります。

要約は、チャンクの核心的な意図を明確にする凝縮されたセマンティックレイヤーを提供することで、このギャップを埋めます。

以下の場合に要約を使用してください：

* **ユーザーのクエリがドキュメントの言語と異なる場合**：フォーマルに書かれた技術文書に対して、ユーザーが実際に質問する方法で要約を追加します。

* **コンセプトが暗黙的または詳細に埋もれている場合**：核心的なコンセプトと意図を表面化する高レベルな要約を追加し、テキスト全体に散らばった細かい詳細に頼らずにチャンクをマッチできるようにします。

* **生のテキストが非テキスト的な場合**：チャンクが主にコード、テーブル、ログ、トランスクリプト、またはその他セマンティックにマッチしにくいものである場合、チャンクの内容を明確にラベル付けする説明的な要約を追加します。

* **関連するチャンクをまとめて検索する必要がある場合**：一連の関連チャンクに同一の要約を適用してグループ検索を有効にします。このセマンティックな接着剤により、トピックの複数の部分をまとめて検索でき、より豊富なコンテキストを提供できます。

  <Info>
    返される関連チャンクの数は、検索設定で定義された Top K の制限に従います。
  </Info>
