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

# Use Cases: Writing and Content Creation

Build document and content Agents with role instructions: translation, official document drafting, certified letter drafting, ad copy, copy diagnosis, SEO checkups, training material design, and conve

Tasks such as translation, official documents, and marketing copy all have fixed formats and checkpoints, which makes them a good fit for a dedicated Agent. Write what the user must provide, what the output should look like, and what must not be done into the role instructions. Colleagues then open a conversation, supply the requested information, and get a consistently formatted first draft.

{% hint style="info" %}
Before you build one yourself, check the [Agent Marketplace](https://docs.maiagent.ai/maiagent-user-guide/en/work/built-in-agents.md#available-scenarios) and the [Agent Template Library](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/agent-templates.md). Official Agents already exist for scenarios in HR, legal, general affairs, retail, and more, such as job description writing, administrative announcement writing, press release drafting, and product listing copy. You can enable them directly, or apply a template and then modify it. If none fits, build your own following this page.
{% endhint %}

## Applicable Scenarios <a href="#scenarios" id="scenarios"></a>

| Agent                                                                                                                           | What the user provides                                                                                                                                  | Key points to spell out in the role instructions                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [**Translation**](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants/translation.md)                       | Text or an uploaded document, and the target language                                                                                                   | Which language to translate into when none is specified, glossary of proper nouns, preserving the original paragraphs and formatting                         |
| [**Official Document Drafting**](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants/official-document.md)  | Document type (memo, letter, meeting notice, etc.), issuing and receiving units, key points for the subject and explanation, dates, attachments         | Document structure and wording, asking follow-up questions when information is missing, and also accepting an existing draft and giving revision suggestions |
| [**Certified Letter Drafting**](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants/legal-attest-letter.md) | Sender and recipient details, what happened, specific demands and deadlines, follow-up actions if the other party does not comply, supporting documents | Produce only a draft, and remind users to have legal counsel or a lawyer confirm it before sending                                                           |
| [**Ad Ideas and Copy**](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants/ad-copywriting.md)              | Product or campaign, target audience, publishing channel and character limit                                                                            | Offer several angles at once, and note the key appeal of each version                                                                                        |
| **Copy Diagnosis**                                                                                                              | Copy type, target audience, intended goal, headline and body                                                                                            | Fixed scoring dimensions (for example appeal, persuasiveness, readability), strengths, areas for improvement, and a rewritten example                        |
| **SEO Checkup**                                                                                                                 | Page content or URL, target keywords, target audience                                                                                                   | Checklist items (title, description, paragraph structure, keyword placement) and the report format                                                           |
| **Training Material Design**                                                                                                    | Course topic, learners and their level, course duration                                                                                                 | Lesson plan structure, in-class activities, and the format of exercises and quizzes                                                                          |
| **Conversation Practice Coach**                                                                                                 | The practice scenario (new-hire training, sales scripts, complaint handling) and the role to play                                                       | Play the other party first and hold the conversation, then give feedback and improvement suggestions after the user says "end"                               |

The first four Agents each have a full build-out page, including role instructions you can paste directly, knowledge base and tool settings, test questions, and common questions:

* [Official Document Drafting Assistant](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants/official-document.md)
* [Legal Certified Letter Drafting](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants/legal-attest-letter.md)
* [AI Smart Translation](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants/translation.md)
* [Ad Copy and Idea Generation](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants/ad-copywriting.md)

## Setup Workflow <a href="#setup-workflow" id="setup-workflow"></a>

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

[Create an Agent](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/setup.md) and put its purpose directly in the name, such as "Official Document Drafting Assistant," so colleagues can tell at a glance which one to use.

### 2. Write the Role Instructions <a href="#step2-write-instructions" id="step2-write-instructions"></a>

Following the table above, write down three things: what information to collect from the user, the output format, and what must not be done. For how to write them, see the [Role Instruction Design Guide](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/system-prompt.md). Taking official document drafting as an example:

```
## Role
You are an official document drafting assistant, helping colleagues write documents for correspondence with government agencies.

## Collect Information First
Before drafting, confirm the following information; ask about missing items one by one and do not make assumptions:
1. Document type (memo, letter, official letter, meeting notice, etc.)
2. Issuing unit and receiving unit
3. Subject and key points for the explanation
4. Relevant dates and deadlines
5. Attachments (if any)

## Output
- Use the structure that corresponds to the document type, keep the subject concise, and list the explanation as separate items
- When the user provides an existing draft, first list the suggested revisions, then attach the full revised text

## Restrictions
- Do not fabricate regulation article numbers, document numbers, or dates; mark anything uncertain as "To be confirmed"
```

### 3. Prepare Reference Materials (Optional) <a href="#step3-knowledge-base" id="step3-knowledge-base"></a>

When documents must follow company standards, upload templates, glossaries, brand voice guides, and past excellent examples to a [knowledge base](https://docs.maiagent.ai/maiagent-user-guide/en/build/knowledge-base/km-basic-settings.md) and attach it to the Agent. A translation Agent can hold a bilingual glossary of proper nouns, and an official document Agent can hold the templates your organization commonly uses.

### 4. Enable the Needed Features <a href="#step4-enable-features" id="step4-enable-features"></a>

* To let colleagues upload documents (for translation, copy diagnosis, or supporting materials for certified letters), enable <mark style="color:blue;">Allow file uploads</mark> in the [function settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/function-settings.md#basic-functions) of this Agent's "Internal" chat platform.
* To let the SEO checkup Agent read URLs on its own, add the [Browser Tool](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/browser-tool.md) to it. Without the tool, ask users to paste the page content directly.
* To translate an entire PDF while preserving its layout, use the knowledge base's [PDF document translation](https://docs.maiagent.ai/maiagent-user-guide/en/build/knowledge-base/translate-pdf.md) instead.

### 5. Make It Available to Colleagues <a href="#step5-share" id="step5-share"></a>

In [role permissions](https://docs.maiagent.ai/maiagent-user-guide/en/org/roles/role-permission.md), assign this Agent's "Internal" chat platform to the roles that need it. Colleagues can then select it from the organization-built tab of the [Agent Marketplace](https://docs.maiagent.ai/maiagent-user-guide/en/work/explain.md) and start a conversation. If a member cannot see the Agent, check [which Agents the organization-built tab lists](https://docs.maiagent.ai/maiagent-user-guide/en/work/built-in-agents.md#self-built-tab-conditions) to troubleshoot.

## Usage Reminders <a href="#notes" id="notes"></a>

{% hint style="warning" %}

* For formal documents such as certified letters and official documents, AI output is a draft. Have the responsible person verify the facts, regulations, and wording before sending.
* When translating documents such as contracts and regulations, have a colleague fluent in both languages review the key clauses.
  {% 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/maiagent-user-guide/en/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.
