> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/km/translate-pdf.md).

# PDF ファイルの翻訳

## 機能の説明 <a href="#feature-description" id="feature-description"></a>

MaiAgent は AI を活用した PDF ファイル翻訳機能を提供しており、ナレッジベース内の PDF ファイルを指定した言語に翻訳できます。翻訳が完了すると、次の 2 種類のバージョンが生成されます。

* **翻訳版**：目標言語の翻訳内容のみを含みます
* **対訳版**：原文と訳文を並べて表示し、対照しながら読みやすくなっています

対応している言語は、繁体字中国語、簡体字中国語、英語、日本語、韓国語、スペイン語、フランス語、ドイツ語、ポルトガル語、ロシア語、アラビア語、イタリア語、オランダ語、ポーランド語、トルコ語です。

{% hint style="info" %}
現在は PDF 形式のファイル翻訳のみに対応しており、PDF には抽出可能なテキスト内容が含まれている必要があります（スキャンのみ／画像型の PDF には対応していません）。
{% endhint %}

***

## PDF ファイルを翻訳する方法 <a href="#how-to-translate-pdf" id="how-to-translate-pdf"></a>

### 1. ファイル詳細ページを開く <a href="#open-document-detail" id="open-document-detail"></a>

ナレッジベースの <mark style="color:blue;">ファイル</mark> タブで、翻訳したい PDF ファイルをクリックし、ファイル詳細ページを開きます。

<figure><img src="/files/9phmLUFExDcJXMwFgTr9" alt=""><figcaption><p>PDF ファイル詳細ページ。右上に「PDF を翻訳」ボタンが表示されています</p></figcaption></figure>

### 2. 翻訳設定を開く <a href="#open-translation-settings" id="open-translation-settings"></a>

右上の <mark style="color:blue;">PDF を翻訳</mark> ボタンをクリックします。そのファイルに翻訳履歴がある場合は、まず翻訳結果のポップアップが表示されるので、<mark style="color:blue;">再翻訳</mark> をクリックすると設定を開けます。初めての翻訳の場合は、翻訳設定のポップアップが直接開きます。

<figure><img src="/files/y7foShYEFuqcdtB7fABu" alt=""><figcaption><p>翻訳設定のポップアップ</p></figcaption></figure>

### 3. 翻訳パラメータを設定する <a href="#configure-translation-params" id="configure-translation-params"></a>

| 項目               | 説明                                                              |
| ---------------- | --------------------------------------------------------------- |
| **ソース言語**        | 原文の言語。デフォルトは「自動検出」で、システムが自動的に判定します                              |
| **目標言語**         | 翻訳先の言語（必須）                                                      |
| **大規模言語モデル**     | 翻訳に使用する LLM モデルを選択します                                           |
| **カスタム用語／プロンプト** | （任意）翻訳スタイルを指定したり用語の対応を指定したりします。例：「Hermione を『ハーマイオニー』と翻訳してください」 |

{% hint style="info" %}
カスタムプロンプトは最大 5,000 文字まで入力でき、専門用語やブランド名、特定の翻訳スタイルを指定するのに適しています。
{% endhint %}

### 4. 翻訳を開始する <a href="#start-translation" id="start-translation"></a>

<mark style="color:blue;">確認</mark> をクリックすると、システムがバックグラウンドで翻訳タスクを実行します。翻訳中はステータスがリアルタイムで更新され、完了すると自動的に結果が表示されます。

***

## 翻訳結果を確認する <a href="#view-translation-result" id="view-translation-result"></a>

翻訳が完了したら、<mark style="color:blue;">PDF を翻訳</mark> ボタンをクリックすると翻訳結果のポップアップが開きます。ポップアップには次の 3 つのタブが含まれます。

### 結果プレビュー <a href="#result-preview" id="result-preview"></a>

対訳版の PDF をプレビューします。原文と訳文が並べて表示されます。

<figure><img src="/files/dBvOMjwrxwpaXmCbnhxv" alt=""><figcaption><p>翻訳結果 — 対訳版 PDF のプレビュー</p></figcaption></figure>

### ファイルのダウンロード <a href="#download-file" id="download-file"></a>

次の 3 種類のファイルダウンロードオプションがあります。

* **元のファイル**：未翻訳の元の PDF をダウンロードします
* **翻訳版**：目標言語の翻訳のみを含む PDF をダウンロードします
* **対訳版**：原文と訳文を並べた PDF をダウンロードします

<figure><img src="/files/ONmRwLif4O5YoWUgr5ND" alt=""><figcaption><p>ファイルのダウンロード — 3 種類の形式に対応</p></figcaption></figure>

### 処理の詳細 <a href="#processing-details" id="processing-details"></a>

翻訳タスクの詳細な統計情報を表示します。

* **翻訳構成**：ソース／目標言語、使用した LLM モデル
* **処理統計**：Token 消費量、LLM 呼び出し回数、処理時間の内訳
* **ファイル情報**：元のファイルと翻訳後のファイルのサイズ、文字数
* **タイムスタンプ**：作成、開始、完了の各時刻と最終ステータス

<figure><img src="/files/b4XbaUtfmiAA7PnFmByp" alt=""><figcaption><p>処理の詳細 — Token 消費と時間の統計</p></figcaption></figure>

***

## 翻訳バージョンの管理 <a href="#translation-version-management" id="translation-version-management"></a>

同じ PDF ファイルに対して複数回の翻訳を実行できます（例：異なる言語に翻訳する、異なるモデルを使用するなど）。翻訳ごとに独立したバージョンとして保存されます。

翻訳結果ポップアップの上部にある <mark style="color:blue;">翻訳バージョンを選択</mark> ドロップダウンメニューで、異なるバージョンに切り替えて結果を確認できます。バージョンの形式は次のとおりです：`日付 | ソース言語 → 目標言語 | 使用モデル`。

再度翻訳する場合は、<mark style="color:blue;">再翻訳</mark> ボタンをクリックすると新しい翻訳設定を開けます。


---

# 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.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/km/translate-pdf.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.