> 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/pre-basic/settings/doc-process.md).

# ドキュメント処理

簡単に言うと：**これは Cherry Studio が「PDF / 複雑なレイアウトの文書」を整ったテキストとして読み取るための中心設定です。**

表や複数カラム、スキャンページを含む PDF（学術論文、契約書、調査レポートなど）は、そのままモデルに投げると読みにくくなりがちです。文書処理ではまず専用の解析エンジンでそれらを構造の明確なテキストに変換し、その後、対話または [ナレッジベース](/docs/jp/knowledge-base/knowledge-base.md) で使用します。

{% hint style="info" %}
**文書処理 vs OCR**：この 2 つは別々のページ設定です。

* **ドキュメント処理**（本ページ）：担当 **PDF / 複雑なレイアウトの文書** の構造化解析。
* [**OCR**](/docs/jp/pre-basic/settings/ocr.md)：担当 **画像 / スキャンデータ** 内の文字認識。

通常のプレーンテキスト PDF、`.md`/`.txt`/`.docx` 内のテキスト段落はどちらも不要で、そのまま読み取ればOKです。
{% endhint %}

### 設定入口

【設定】→【文書処理】を開き、右上のドロップダウンで解析エンジンを選択します。**選択したエンジンがそのままデフォルト**。

<figure><img src="https://3776196818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Ut5BptC3t8CtSU1UWpM%2Fuploads%2Fgit-blob-ccfff6a9d37c58e6342c96d246156fddce6c0ab1%2Fdoc-process-overview.png?alt=media" alt=""><figcaption><p>文書処理設定：① 右上のドロップダウンで解析エンジンを選択（デフォルトは MinerU）；下に選択したエンジンの API キーと API アドレスを入力</p></figcaption></figure>

### 内蔵解析エンジン

文書処理には 5 つのエンジンが内蔵されており、デフォルトは **MinerU**：

| エンジン              | 説明                                                 | 接続方法                                                                                                 |
| ----------------- | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **MinerU**（デフォルト） | OpenDataLab が提供する高品質な PDF 抽出ツール                    | API キー（[mineru.net/apiManage](https://mineru.net/apiManage)）                                         |
| **PaddleOCR**     | 百度飛桨 OCR 認識システム                                    | API キーを入力（[飛桨星河コミュニティ](https://aistudio.baidu.com/paddleocr/)）；自前でデプロイする場合は API アドレスを自分のサービスに向けてください |
| **Doc2x**         | 高度なファイル復元エンジン                                      | API キー（[open.noedgeai.com](https://open.noedgeai.com/apiKeys)）                                       |
| **Mistral**       | ファイル解析および理解サービス                                    | API キー（[mistral.ai](https://mistral.ai/api-keys)）                                                    |
| **Open MinerU**   | 自前でデプロイ可能な MinerU サービスで、処理フローを自分たちで管理したいチームに適しています | 自前でデプロイした後、API アドレスを入力（必要に応じて API キーも入力）                                                             |

### MinerU の設定（デフォルト案）

{% stepper %}
{% step %}

### API キーを入力

【API キー】欄に MinerU で取得した key を入力します（右側の「キーを取得」をクリックすると申請ページに移動します。複数のキーはカンマ区切りで入力可能です）。
{% endstep %}

{% step %}

### API アドレスの確認

【API アドレス】はデフォルトのままで問題ありません。
{% endstep %}

{% step %}

### ナレッジベース / 会話で直接使用

複雑な PDF を取り込むと、この解析設定が自動で適用されます。ナレッジベースや会話に切り替える際に追加設定は不要です。
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**他のエンジンに切り替える**：ドロップダウンでそれを選び、そのエンジンの【API キー】／【API アドレス】を入力すればOKです。選択したものがデフォルトになります。なお **PaddleOCR** と **Open MinerU** 自前でデプロイ可能です。デプロイ後は【API アドレス】を自分のサービスアドレスに設定してください。
{% endhint %}

### ナレッジベースとの関係

* 文書処理は「複雑な文書 → 整ったテキスト」への変換だけを担当します。
* 変換後のテキストはそのまま [埋め込みモデル](/docs/jp/knowledge-base/emb-models-info.md) ベクトル化、格納へ進みます；
* 「ナレッジベースで有効にする」詳しい手順は [ナレッジベース文書の前処理](/docs/jp/knowledge-base/document-preprocessing.md)。

### ヒントとコツ

* MinerU は表や複数カラムのレイアウトを含む PDF で特に高い効果を発揮します。学術論文などではまず最優先で試してください；
* 認識したいのが **画像内の文字**（スクリーンショット、スキャンデータ）であって PDF の構造ではない場合は、代わりに [OCR](/docs/jp/pre-basic/settings/ocr.md)。

***

### ヘルプの取得とフィードバックの送信

設定または使用中に不明点、バグ、機能改善の提案がある場合は、 [フィードバックと提案](/docs/jp/question-contact/suggestions.md) に記載の公式チャネルをご参照ください。


---

# 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/pre-basic/settings/doc-process.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.