> 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.md).

# 應用實例：文書與內容創作

用角色指令打造文書與內容 Agent：翻譯、公文撰寫、存證信函草擬、廣告文案、文案診斷、SEO 健檢、教材設計與對話練習，給同仁在內部問答使用。

翻譯、公文、行銷文案這類工作都有固定的格式與檢查重點，很適合交給一個專門的 Agent：把「要使用者提供什麼、輸出長什麼樣子、哪些事不能做」寫進角色指令，同仁開啟對話照著提供資料，就能拿到格式一致的初稿。

{% hint style="info" %}
動手建置前，先看 [Agent 市集](/work/built-in-agents.md#available-scenarios) 與 [Agent 模板庫](/build/agent/agent-templates.md)：人資、法務、總務、零售等場景已有官方 Agent，例如職務說明撰寫、行政公告撰寫、新聞稿草擬、商品上架文案，可以直接啟用，或套用模板後再修改。找不到合用的，再照本頁自建。
{% endhint %}

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

| Agent                                                         | 使用者提供什麼                                 | 角色指令要寫清楚的重點                         |
| ------------------------------------------------------------- | --------------------------------------- | ----------------------------------- |
| [**翻譯**](/work/writing-assistants/translation.md)             | 文字或上傳的文件、目標語言                           | 沒指定語言時翻成哪一種、專有名詞對照、保留原文段落與格式        |
| [**公文撰寫**](/work/writing-assistants/official-document.md)     | 公文類別（簽、函、開會通知單等）、發文與受文單位、主旨與說明要點、日期、附件  | 公文結構與用語、資料不足時先追問、也接受既有文稿並給修改建議      |
| [**存證信函草擬**](/work/writing-assistants/legal-attest-letter.md) | 寄件人與收件人資料、事件經過、具體訴求與期限、對方未履行時的後續處理、佐證文件 | 只產出草稿，並提醒寄出前交由法務或律師確認               |
| [**廣告靈感與文案**](/work/writing-assistants/ad-copywriting.md)     | 產品或活動、目標受眾、刊登管道與字數限制                    | 一次提出多個切入角度，標註每個版本的訴求重點              |
| **文案診斷**                                                      | 文案類型、目標受眾、預期目標、標題與內文                    | 固定的評分面向（例如吸引力、說服力、可讀性）、優點、待改進處與改寫範例 |
| **SEO 健檢**                                                    | 網頁內容或網址、目標關鍵字、目標受眾                      | 檢查項目（標題、描述、段落結構、關鍵字配置）與報告格式         |
| **教材設計**                                                      | 課程主題、學習對象與程度、課程時數                       | 教案結構、課堂活動、練習題與測驗的形式                 |
| **對話練習教練**                                                    | 練習情境（新人訓練、銷售話術、客訴處理）與要扮演的角色             | 先扮演對方進行對話，使用者說「結束」後再給回饋與改進建議        |

前四種 Agent 各有一頁完整的建置實例，含可直接貼上的角色指令、知識庫與工具設定、測試題與常見問題：

* [公文撰寫助理](/work/writing-assistants/official-document.md)
* [法律存證信函草擬](/work/writing-assistants/legal-attest-letter.md)
* [AI 智能翻譯](/work/writing-assistants/translation.md)
* [廣告文案與靈感發想](/work/writing-assistants/ad-copywriting.md)

## 建置流程 <a href="#setup-workflow" id="setup-workflow"></a>

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

[建立 Agent](/build/agent/setup.md)，名稱直接寫出用途，例如「公文撰寫助理」，讓同仁一看就知道要找哪一個。

### 2. 撰寫角色指令 <a href="#step2-write-instructions" id="step2-write-instructions"></a>

依上表寫下三件事：要向使用者收集哪些資料、輸出的格式、不能做的事。寫法可參考 [角色指令設計指南](/build/agent/system-prompt.md)。以公文撰寫為例：

```
## 角色
你是公文撰寫助理，協助同仁撰寫與政府機關往來的公文。

## 先收集資料
開始撰寫前，確認以下資訊；缺少的項目請逐一詢問，不要自行假設：
1. 公文類別（簽、函、書函、開會通知單等）
2. 發文單位與受文單位
3. 主旨與說明要點
4. 相關日期與期限
5. 附件（如有）

## 輸出
- 依公文類別使用對應的結構，主旨簡明，說明分項條列
- 使用者提供既有文稿時，先列出建議修改處，再附上修改後全文

## 限制
- 不編造法規條號、文號與日期；不確定時標示「待確認」
```

### 3. 準備參考資料（選用） <a href="#step3-knowledge-base" id="step3-knowledge-base"></a>

需要依公司規範撰寫時，把範本、用語對照表、品牌語氣指南、過去的優良範例上傳到 [知識庫](/build/knowledge-base/km-basic-settings.md) 並掛到 Agent。翻譯 Agent 可以放專有名詞中英對照表，公文 Agent 可以放單位慣用的範本。

### 4. 開啟需要的功能 <a href="#step4-enable-features" id="step4-enable-features"></a>

* 要讓同仁上傳文件（翻譯、文案診斷、存證信函的佐證資料），在這個 Agent 的「內部」對話平台 [功能設定](/build/conversation-settings/platform-settings/function-settings.md#basic-functions) 開啟 <mark style="color:blue;">允許上傳檔案</mark>。
* 要讓 SEO 健檢 Agent 自己讀取網址，為它加上 [Browser Tool](/build/agent/browser-tool.md)；沒有加工具時，請使用者直接貼上網頁內容。
* 要整份翻譯 PDF 並保留版面，改用知識庫的 [PDF 文件翻譯](/build/knowledge-base/translate-pdf.md)。

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

在 [角色權限](/org/roles/role-permission.md) 把這個 Agent 的「內部」對話平台分配給需要的角色，同仁就能在 [Agent 市集](/work/explain.md) 的組織自建分頁選擇它開始對話。成員看不到 Agent 時，對照 [組織自建分頁會列出哪些 Agent](/work/built-in-agents.md#self-built-tab-conditions) 排查。

## 使用提醒 <a href="#notes" id="notes"></a>

{% hint style="warning" %}

* 存證信函、公文等正式文件，AI 產出的是草稿，寄出前請由權責人員核對事實、法規與用語。
* 翻譯合約、規章等文件時，關鍵條文請由熟悉雙語的同仁複查。
  {% endhint %}


---

# 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.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.