> 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/work/writing-assistants/translation.md).

# AI 智能翻譯

AI 翻譯 Agent 應用實例：啟用官方內建的多語翻譯 Agent，或自建帶公司專有名詞對照表的翻譯助理，支援文字、文件與圖片翻譯，含角色指令範例、測試題與常見問題。

翻譯是最常被交給 AI 的工作之一，但直接把文字丟給通用模型，常遇到三個問題：公司的產品名與專有名詞每次翻得不一樣、原文的段落與表格格式跑掉、合約這類高風險文件沒有人提醒要複查。做成一個專門的翻譯 Agent，可以把「預設翻成哪種語言、專有名詞怎麼翻、格式怎麼保留、哪些文件要加註提醒」固定下來，同仁貼上內容就能拿到一致的譯文。

## 適用情境 <a href="#scenarios" id="scenarios"></a>

| 情境      | 輸入              | 輸出              |
| ------- | --------------- | --------------- |
| 日常往來    | 外文郵件、訊息、公告      | 譯文，必要時附原文對照     |
| 文件翻譯    | 上傳的 Word、PDF、簡報 | 保留標題、清單與表格結構的譯文 |
| 圖片與截圖   | 含文字的照片、系統畫面截圖   | 先辨識文字再翻譯        |
| 行銷與標語   | 廣告詞、產品標語        | 直譯之外另附貼近當地語感的版本 |
| 產品與技術文件 | 規格書、操作手冊        | 依公司專有名詞對照表翻譯    |

## 三種做法，先選一種 <a href="#choose-approach" id="choose-approach"></a>

| 做法               | 適合                        | 怎麼做                                                                                                                                                                                                                                                            |
| ---------------- | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **啟用官方內建 Agent** | 想馬上用、不需要自訂規則              | 在 [Agent 市集](/work/built-in-agents/use.md) 的 <mark style="color:blue;">官方內建</mark> 分頁找 <mark style="color:blue;">多語翻譯</mark>（個人生產力），由管理員到 [內建 Agent 管理](/work/built-in-agents/management.md) 啟用。醫療院所另有 <mark style="color:blue;">醫療翻譯</mark>（醫療），會逐字保留藥名、劑量與單位 |
| **套用模板再修改**      | 想以官方設計為起點，加入公司的專有名詞與語氣    | 到 [Agent 模板庫](/build/agent/agent-templates.md) 套用 <mark style="color:blue;">多語翻譯</mark>，得到可編輯的 Agent，再照本頁步驟 2–3 調整                                                                                                                                             |
| **從零自建**         | 規則很單純（例如固定中翻英），或想完全掌握角色指令 | 照本頁全部步驟                                                                                                                                                                                                                                                        |

官方內建 Agent 啟用後角色指令不能改，但可以[匯入專屬知識庫](/work/built-in-agents/management.md#knowledge-base)，把專有名詞對照表放進去。

{% hint style="info" %}
要把整份 PDF 翻譯並保留原始版面（圖表位置、分欄），請改用知識庫的 [PDF 文件翻譯](/build/knowledge-base/translate-pdf.md)；對話式的翻譯 Agent 適合文字、段落與一般文件。
{% endhint %}

## 要準備什麼 <a href="#prerequisites" id="prerequisites"></a>

* 一個可以建立 Agent 的帳號（角色具備 <mark style="color:blue;">AI 助理</mark> 權限）
* 專有名詞對照表（選用但建議）：產品名、部門與職稱、產業術語的原文與指定譯法，Excel 或 CSV 皆可
* 風格說明（選用）：對外文件的語氣、用字禁忌、數字與日期格式
* 決定預設目標語言：使用者沒有指定時翻成哪一種

## 建置步驟 <a href="#setup" id="setup"></a>

### 1. 建立 Agent <a href="#step-create-agent" id="step-create-agent"></a>

到 <mark style="color:blue;">AI 助理</mark> 點 <mark style="color:blue;">建立 AI 助理</mark>，名稱例如「翻譯助理」。<mark style="color:blue;">LLM 模型</mark> 選組織已啟用的模型：要翻譯圖片與截圖，需選支援看圖的模型；日常短文可用回應較快的模型以節省 Credits。回答模式維持預設的 <mark style="color:blue;">Agent 模式</mark>。操作細節見 [建立 Agent](/build/agent/setup.md)。

### 2. 貼上角色指令 <a href="#step-system-prompt" id="step-system-prompt"></a>

在 <mark style="color:blue;">回答模式設定</mark> 的 <mark style="color:blue;">角色指令</mark> 貼上下列範例，把預設語言改成貴公司的需求。

```
## 角色
你是翻譯助理，只做翻譯與譯文校潤。其他請求請禮貌說明無法協助。

## 開始前
- 使用者有提供原文與目標語言時，直接翻譯，不要多問。
- 沒有指定目標語言時：原文是中文就翻成英文，原文是其他語言就翻成繁體中文（台灣用語）。
- 沒有提供原文時，請使用者貼上文字或上傳檔案。
- 使用者上傳圖片或截圖時，先列出辨識到的文字，再附譯文。

## 翻譯原則
- 忠於原意：不增添原文沒有的資訊，不省略、不改寫。
- 數字、單位、日期、金額、人名、地名、機構名、程式碼與網址一律照原文保留。
- 保留原文的段落、標題、清單與表格結構。
- 專有名詞先查知識庫的對照表，有指定譯法就照用；查不到時保留原文並在後面加註（原文），
  不自行創造正式譯名。全篇同一個詞的譯法前後一致。
- 語氣貼近原文：公文與合約用正式語體，行銷與口語內容用自然的說法。

## 輸出
- 預設只輸出譯文。使用者要求時改為「原文／譯文」逐段對照。
- 廣告詞、標語等創意內容，直譯之外另附一個貼近當地語感的版本，並說明兩者差異。
- 有採用對照表或加註原文的詞，在最後列出「術語對照」。

## 提醒
- 合約、法規、醫療與財務文件的譯文，結尾加上：
  「本譯文僅供參考，正式用途請由熟悉雙語的專業人員審定。」
```

### 3. 掛上專有名詞對照表 <a href="#step-knowledge-base" id="step-knowledge-base"></a>

把對照表上傳到 [知識庫](/build/knowledge-base/km.md)，在 Agent 的 <mark style="color:blue;">知識庫設定</mark> 掛上。整理對照表時：

* 每列一個詞，欄位為「原文、指定譯法、備註（適用情境或不可使用的譯法）」
* 同一個詞在不同語言的譯法分列，不要擠在同一格
* 數量不多（數十個詞）時，也可以直接寫進角色指令的「翻譯原則」段，命中率最穩定
* 常被問的固定譯法可另外建成 [FAQ](/build/knowledge-base/faq.md)

### 4. 開啟上傳檔案與需要的工具 <a href="#step-enable-features" id="step-enable-features"></a>

* 到這個 Agent 的「內部」對話平台 → [功能設定](/build/conversation-settings/platform-settings/function-settings.md#basic-functions)，開啟 <mark style="color:blue;">允許上傳檔案</mark>，同仁才能上傳文件與圖片
* 要讓 Agent 把譯文輸出成 Word 或 PDF 檔，開啟 [Code Interpreter](/build/agent/code-interpreter.md)
* 要讓 Agent 上網查證不熟悉的專有名詞，到 <mark style="color:blue;">工具</mark> 分頁加上系統內建的網頁搜尋工具，見 [為 Agent 配置工具](/build/tools/configure_tools.md)

### 5. 開放給同仁 <a href="#step-share" id="step-share"></a>

到 [角色權限](/org/roles/role-permission.md) 把這個 Agent 的「內部」對話平台分配給需要的角色，同仁就能在 [內部問答](/work/explain.md) 選它開始對話。要放在官網或客服入口給外部使用者，另外建立 [Web Chat](/build/choose-channel/web-chat.md) 對話平台。

## 測試題 <a href="#test-cases" id="test-cases"></a>

| #  | 輸入                              | 應該看到                |
| -- | ------------------------------- | ------------------- |
| 1  | 貼上一段中文，不指定語言                    | 直接翻成英文，不反問          |
| 2  | 貼上一段日文，不指定語言                    | 翻成繁體中文，用台灣用語        |
| 3  | 「翻成日文：本產品保固 24 個月，售價 NT$12,800」 | 數字、金額與幣別照原文保留       |
| 4  | 含對照表中產品名的句子                     | 使用對照表的指定譯法，結尾列出術語對照 |
| 5  | 含對照表沒有的專有名詞                     | 保留原文並加註，不自創譯名       |
| 6  | 貼上含標題、條列與表格的段落                  | 譯文保留相同結構            |
| 7  | 上傳一張含英文的系統截圖                    | 先列出辨識到的文字，再附譯文      |
| 8  | 貼上一段合約條款                        | 譯文結尾有專業人員審定的提醒      |
| 9  | 「幫我把這句標語翻成英文：安心，從這裡開始」          | 直譯與貼近語感的版本各一，並說明差異  |
| 10 | 「幫我寫一封英文求職信」                    | 說明只做翻譯與譯文校潤         |

## 常見問題 <a href="#faq" id="faq"></a>

### 支援哪些語言？ <a href="#faq-languages" id="faq-languages"></a>

取決於所選的語言模型。主流模型對中、英、日、韓與歐洲主要語言的品質最好；較少見的語言建議先用幾段實際內容測試，重要文件請母語人士複查。

### 專有名詞還是翻得不一致？ <a href="#faq-terminology" id="faq-terminology"></a>

先確認對照表有被檢索到：在對話平台的 [功能設定](/build/conversation-settings/platform-settings/function-settings.md#ai-interaction) 開啟 <mark style="color:blue;">顯示引用文件</mark>，看譯文是否引用了對照表。沒有被引用時，把最關鍵的詞直接寫進角色指令，或把對照表拆成較小的檔案、每列一個詞。

### 可以翻譯整份很長的文件嗎？ <a href="#faq-long-document" id="faq-long-document"></a>

可以上傳文件請 Agent 翻譯，但篇幅很長時回覆可能分段或被截斷。整份 PDF 且需要保留版面，請用 [PDF 文件翻譯](/build/knowledge-base/translate-pdf.md)；其他長文件建議依章節分次翻譯。

### 譯文可以直接對外使用嗎？ <a href="#faq-publish" id="faq-publish"></a>

一般往來與內部文件可以直接使用。合約、法規、醫療與對外發布的正式文件，關鍵條文與數字請由熟悉雙語的同仁複查。

### 和 MaiGPT 直接請 AI 翻譯有什麼不同？ <a href="#faq-vs-maigpt" id="faq-vs-maigpt"></a>

MaiGPT 適合個人臨時翻譯；翻譯 Agent 把預設語言、專有名詞與輸出格式固定下來，全公司拿到的譯法一致，也不必每次重打指示。

## 延伸閱讀 <a href="#further-reading" id="further-reading"></a>

* [應用實例：文書與內容創作](/work/writing-assistants.md)：其他文書類 Agent 的設計重點
* [多國語言支援](/build/agent/multi-language-support.md)：Web Chat 介面語言與回覆語言設定
* [使用官方內建 Agent](/work/built-in-agents/use.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/work/writing-assistants/translation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.