> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/knowledge-base/document-preprocessing.md).

# 文書解析と OCR

ナレッジベースは、すでに解析されたテキストのみ検索できます。スキャンPDF、二段組み論文、複雑な表、画像形式のページは、まず本文を正しく解析してから、モデルとリコールパラメータを調整してください。

{% hint style="info" %}
解析が合格かどうかは、「インポート成功」の4文字を見るのではなく、本文の順序、重要な表、金額・日付、スキャン文字が正しく読み取れるかで判断します。
{% endhint %}

## まず資料タイプを判断する

| 資料タイプ                      | 推奨の出発点         | 必ず確認する内容        |
| -------------------------- | -------------- | --------------- |
| Markdown、TXT、HTML          | デフォルトで読み取る     | 見出し階層、文字コード、改行  |
| コピー可能なテキストのPDF、DOCX、PPTX   | まずはデフォルト処理を使う  | 段落順、ヘッダーとフッター、表 |
| スキャンPDF、スクリーンショット、画像形式のページ | ローカルまたはシステムOCR | 認識言語、金額、日付、番号   |
| 複数列、数式、または複雑な表のPDF         | 専用文書プロセッサ      | 読み取り順序、表構造、脚注   |

## 解析は検索チェーンの中のどこにあるか

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FlOKvTNoShRGrj0ErU2aK%2Fclipboard.png?alt=media&amp;token=d245723c-b825-4e3d-ab00-6e1d07a96fc9" alt="资料经过解析与 OCR、切分、关键词和向量检索后进入回答的知识库检索架构图"><figcaption><p>解析エラーは分割とリコールにも引き継がれます。下流モデルは、本文からすでに失われた内容を復元できません。</p></figcaption></figure>

## サンプル文書を1件設定して検証する

{% stepper %}
{% step %}

### 1. 代表的なサンプルを選ぶ

まず一括で資料をインポートしないでください。表付きのスキャンPDFや二段組みのマニュアルなど、問題を最も顕在化させる文書を1つ選びます。
{% endstep %}

{% step %}

### 2. 処理能力を設定する

【設定】→【文書処理】を開き、必要に応じて文書解析サービスとOCRを設定します。クラウドサービスでは通常、APIキーまたはサービスアドレスが必要です。ローカル機能では、先にモデルのダウンロードが必要な場合があります。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FfxxfAX439W0gARCyS0md%2Fclipboard.png?alt=media&amp;token=315f05e6-fc9d-422e-9127-ef61e895ea97" alt="文档处理设置中的文件解析与 OCR 服务配置"><figcaption><p>使うサービスをまず利用可能な状態に設定してから、ナレッジベースに戻ってプロセッサを選びます。</p></figcaption></figure>
{% endstep %}

{% step %}

### 3. インポートして準備完了を待つ

サンプル文書をナレッジベースに追加します。処理完了後、本文を開いて、見出し、段落、ページ番号、表、OCRテキストを確認します。
{% endstep %}

{% step %}

### 4. チャンクを確認する

重要な条件と結論が分断されないことを確認します。ヘッダー、フッター、目次がチャンクを大量に占めないようにします。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2FSuW1LQlcdqCWxhLJEEQe%2Fclipboard.png?alt=media&amp;token=6ea5de2d-e4a1-40e2-b31c-d9ca31779eed" alt="知识库高级设置中的智能分段、分隔符、分段大小和重叠大小"><figcaption><p>本文が正しくなってから分割を確認します。解析エラーは、チャンクを大きくしても修復できません。</p></figcaption></figure>
{% endstep %}

{% step %}

### 5. 実際の問題で再テストする

【リコールテスト】で、この文書内に答えがある質問を入力します。結果には、正しい出典、完全な条件、重要な数値が含まれているはずです。
{% endstep %}

{% step %}

### 6. 方案を固定してから一括インポートする

サンプルが合格したら、同じ種類の資料を分けてインポートします。プロセッサ、OCR、または分割設定を変更した後は、古い資料に対して【再インデックス】を実行し、テストを繰り返します。
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
プロセッサやOCRを切り替えても、すでにインデックスされた古い資料は自動では修復されません。新旧の結果を比較するには、関連項目を再インデックスする必要があります。
{% endhint %}

## プロセッサとOCRの選び方

| 選択                  | 適用ケース             | 利点                 | 注意事項                           |
| ------------------- | ----------------- | ------------------ | ------------------------------ |
| デフォルトで読み取る          | テキスト主体の一般的な形式     | 設定が少なく、速度が速い       | 複雑なレイアウトやスキャンページでは内容が失われる場合がある |
| システムOCR             | システムが対応しており、画像が鮮明 | 追加のAPIキーが不要で、速度が速い | 精度はOS、言語、画像品質に左右される            |
| ローカルPaddleOCR       | オフライン認識が必要        | 文書が端末外に出ない         | 初回使用前にローカルモデルのダウンロードが必要        |
| クラウドまたはセルフホストのプロセッサ | 二段組み、複雑な表、数式が多い   | レイアウト解析能力が通常より強い   | クラウド方式では、処理のために文書内容が送信される      |

{% hint style="danger" %}
機密資料にクラウド文書プロセッサを使う前に、まずサービス利用規約、データ保持ポリシー、アカウント権限を確認してください。完全オフラインにするには、解析、OCR、埋め込み、再ランキング、チャットの各段階でローカル機能を使う必要があります。
{% endhint %}

## 典型的な問題の切り分け方

| 症状               | まず確認する          | 対応方針                                 |
| ---------------- | --------------- | ------------------------------------ |
| 本文が空、または非常に短い    | ファイルがスキャン文書かどうか | OCRを有効にするか、プロセッサを変更する                |
| 二段組みの文字が交錯する     | 本文の読み取り順序       | レイアウト解析に強いプロセッサを使う                   |
| 表が断片的な文字になる      | 表の見出し、行列関係      | プロセッサを変更するか、重要なルールをMarkdownメモとして整理する |
| ヘッダーとフッターが繰り返し出る | チャンク内の重複ノイズ     | 元ファイルを整理するか解析器を変え、Top Kを上げるだけにしない    |
| OCRで数字が誤る        | 金額、日付、番号        | 画像をより鮮明にし、リスクの高い項目は手動で確認する           |

## 設定説明

| 設定項目            | 推奨の出発点                       | いつ調整するか                       | 調整後の動作                  |
| --------------- | ---------------------------- | ----------------------------- | ----------------------- |
| 文書プロセッサ         | まずはデフォルト処理を使う                | 本文の順序が乱れる、表が失われる、スキャンページが空になる | サンプル文書を再インデックスする        |
| OCR             | 鮮明なスキャン文書はローカルまたはシステム機能を優先する | 画像形式のページに文字がない、または誤字が多い       | 再インデックスして重要項目を確認する      |
| チャンクサイズとオーバーラップ | まずはナレッジベースのデフォルト設定を維持する      | 条件と結論が分断される                   | 1回につき1項目だけ変更し、再インデックスする |
| 検証問題            | 3～5個の実際の質問                   | プロセッサ、OCR、または分割を変更した後         | 同じ問題セットで比較する            |

## ユーザー事例

小林さんは二段組みの出張規程PDFをインポートしました。状態はすでに準備完了でしたが、本文で左右の2カラムが交錯しており、リコール結果の承認条件も不完全でした。彼はまずTop Kを上げるのではなく、レイアウト解析により適したプロセッサに切り替え、同じファイルを再インデックスしてから、本文とチャンクを確認しました。

合格基準は、承認条件が原文の順序どおりに読めること、金額と日付が正しいこと、固定問題で完全な条件を含むチャンクをリコールできることです。

## よくある質問

<details>

<summary>本文が正しくても、チャンクも見る必要がありますか？</summary>

必要です。本文が正しいのは解析が合格したことを示すだけです。条件と結論は、分割時にまだ分かれてしまう可能性があります。

</details>

<details>

<summary>Top Kを増やせば解析問題は修復できますか？</summary>

できません。Top Kは返すチャンク数を制御するだけで、本文ですでに失われたり順序が乱れたりした内容は復元できません。

</details>

<details>

<summary>プロセッサを変更しても結果が変わらないのはなぜですか？</summary>

古い資料はまだ元のインデックスを使っています。関連項目に【再インデックス】を実行してから、同じ問題で再テストしてください。

</details>

## 続きを読む

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>資料を追加・整理する</strong></td><td>ソースを選び、処理状態を確認する。</td><td><a href="/docs/jp/knowledge-base/sources.md">資料の追加と整理</a></td></tr><tr><td><strong>資料とリコールを確認する</strong></td><td>固定した問題で解析と分割を検証する。</td><td><a href="/docs/jp/knowledge-base/recall-test.md">資料と検索結果を確認</a></td></tr><tr><td><strong>データ、プライバシー、保守</strong></td><td>ローカルとクラウドのデータ境界を確認する。</td><td><a href="/docs/jp/knowledge-base/data.md">データ、プライバシーとメンテナンス</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/jp/knowledge-base/document-preprocessing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.