> 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/ad-copywriting.md).

# Ad Copywriting and Idea Generation

Ad copywriting Agent use case: enable the official built-in content generation Agent, or build your own ad copy and ad ideation assistant with your brand voice, producing headlines, body copy, and cal

When marketers write ad copy, the most time-consuming part is often not the writing itself but finding the angle: which audience to address for the same product, which benefit to emphasize, which placement to use, and whether the length fits. The ad copywriting Agent turns this process into a routine: it first asks about the product, audience, and publishing channel, then gives you several versions with different appeals at once, each labeled with its angle and character count, so you can pick a direction and refine it further.

## Use Cases <a href="#scenarios" id="scenarios"></a>

| Scenario                   | Input                                             | Output                                                                                                          |
| -------------------------- | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| Ad headlines and body copy | Product or campaign, audience, publishing channel | 3–5 headlines + body copy + calls to action, each from a different angle                                        |
| Idea generation            | Product features and current selling points       | Multiple appeal angles (features, emotion, situation, contrast, limited time), each with a one-sentence concept |
| Multi-channel rewriting    | A finalized main copy                             | Versions rewritten to each channel's length and tone                                                            |
| A/B test material          | Existing copy and the variable to test            | Comparison versions that change only a single variable                                                          |
| Copy polishing             | Existing copy                                     | A concise version and an enhanced version that preserve the original meaning                                    |

## Three Approaches: Pick One First <a href="#choose-approach" id="choose-approach"></a>

| Approach                                | Best for                                                         | How                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------------------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enable the official built-in Agent**  | You want to start using it right away                            | In the <mark style="color:blue;">Official Built-in</mark> tab of the [Agent Marketplace](https://docs.maiagent.ai/maiagent-user-guide/en/work/built-in-agents/use.md), find <mark style="color:blue;">Content Generation</mark> (Personal Productivity), which generates social media and marketing copy by topic and platform. For retail, there is also <mark style="color:blue;">Product Listing Copy</mark> (Retail), which produces product descriptions and social media copy from product information or photos. An administrator enables them in [Built-in Agent Management](https://docs.maiagent.ai/maiagent-user-guide/en/org/management.md) |
| **Apply a template and then modify it** | You want to add brand voice, forbidden words, and a fixed format | Apply <mark style="color:blue;">Content Generation</mark> from the [Agent Template Library](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/agent-templates.md) to get an editable Agent, then adjust it following steps 2–3 on this page                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Build from scratch**                  | You have clear placement specifications and output formats       | Follow all the steps on this page                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

Before finalizing copy, check for exaggerated claims and prohibited terms. You can pair this with the official built-in <mark style="color:blue;">Marketing Content Review</mark> (Personal Productivity): it only reviews and suggests revisions, and does not write copy for you.

## What to Prepare <a href="#prerequisites" id="prerequisites"></a>

* An account that can create Agents (the role has the <mark style="color:blue;">AI Assistants</mark> permission)
* A brand voice guide (optional but recommended): how the brand speaks, preferred and forbidden words, and how it addresses the audience
* Product information: product features, specifications, prices, and what can be claimed publicly
* 5–10 past pieces of well-performing copy (optional) as tone examples
* Length and format specifications for each publishing channel (refer to each platform's latest announcements)

## Setup Steps <a href="#setup" id="setup"></a>

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

Go to <mark style="color:blue;">AI Assistants</mark> and click <mark style="color:blue;">Create AI Assistant</mark>. Name it, for example, "Ad Copywriting Assistant". For <mark style="color:blue;">LLM Model</mark>, choose a model that your organization has enabled and that writes well in Chinese; keep the response mode at the default <mark style="color:blue;">Agent Mode</mark>. For details, see [Create an Agent](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/setup.md).

### 2. Paste the Role Instructions <a href="#step-system-prompt" id="step-system-prompt"></a>

In <mark style="color:blue;">Response Mode Settings</mark>, paste the following example into <mark style="color:blue;">Role Instructions</mark>, and replace the channel specifications and brand rules with your company's own.

```
## Role
You are an ad copywriting assistant who helps marketing colleagues brainstorm ad angles and write ad copy.

## Confirm before writing
If any of the following is missing, ask for all of it at once before writing:
1. What the product, service, or campaign is, and the one thing people should remember most
2. Target audience: who they are and in what situation they would need it
3. Publishing channel and placement (for example, search ads, social posts, newsletter subject lines, website banners)
4. The action you want the audience to take (purchase, sign up, request information, visit a store)
5. Words that must or must not appear, campaign period, and offer details (if any)

## Output format
- Provide 3 to 5 versions at once, each using a different angle, for example:
  functional benefit, solving a pain point, usage scenario, contrast with the status quo, limited-time incentive.
- For each version, list in order: angle (a one-sentence description of the appeal), headline, body copy, call to action, character count.
- Control the length according to the publishing channel. If the user gives a character limit, follow it strictly and state the actual character count.
- Finally, in one or two sentences, recommend which two versions to test first and why.
- If the user only wants inspiration, list 5 or more angles, each with a one-sentence concept, instead of writing complete copy.

## Writing principles
- Follow the brand voice guide in the knowledge base; if there is no guide, use clear, conversational, and unexaggerated Taiwanese Chinese.
- Use only the product facts provided by the user or the knowledge base. Do not invent features, figures, prices, awards, or customer testimonials.
- Do not use absolute terms such as "No. 1", "best", "only", or "guaranteed" unless the user provides supporting evidence.
- For claims in regulated areas such as medical, health care, finance, and food, remind the user to have legal or compliance staff review them.
- Do not disparage or allude to specific competitors.

## When revising existing copy
First point out the one to three most worthwhile things to change, then provide one concise version and one enhanced version.
```

### 3. Attach Brand and Product Data <a href="#step-knowledge-base" id="step-knowledge-base"></a>

Upload the brand voice guide, product information, and past good copy to a [knowledge base](https://docs.maiagent.ai/maiagent-user-guide/en/build/knowledge-base/km.md), and attach it in the Agent's <mark style="color:blue;">Knowledge Base Settings</mark>:

* Use one document per product, clearly stating what "can be said publicly" and what "cannot be said"
* Label past copy with its channel and performance (for example, "social post, high engagement rate") so the Agent has a better basis when referencing it
* Campaign schedules and offers change frequently. Update them for each campaign, or have users provide them in the conversation

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

* **File upload**: Go to this Agent's "Internal" chat platform → [Function Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/function-settings.md#basic-functions) and enable <mark style="color:blue;">Allow file uploads</mark> so colleagues can upload product brochures or product photos
* **Web references**: To let the Agent read product pages or campaign pages, add the [Browser Tool](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/browser-tool.md) or the system's built-in web search tool in the <mark style="color:blue;">Tools</mark> tab. See [Configure Tools for an Agent](https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/configure_tools.md)
* **Images**: To also produce ad concept images, add the [built-in AI image generation tool](https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/ai-image-generation-guide.md)

### 5. Open It to the Marketing Team <a href="#step-share" id="step-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 marketing-related roles. Colleagues can then select it in [Internal Q\&A](https://docs.maiagent.ai/maiagent-user-guide/en/work/explain.md) and start a conversation.

## Test Cases <a href="#test-cases" id="test-cases"></a>

| # | Input                                                                                                                                                  | Expected result                                                                                                                                          |
| - | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | "Write an ad for me"                                                                                                                                   | Does not start writing; asks for the product, audience, channel, action, and constraints all at once                                                     |
| 2 | "New insulated tumbler, highlighting 12-hour cold retention, aimed at commuting office workers, for a social post, with the goal of driving purchases" | 3–5 versions, each with an angle, headline, body copy, call to action, and character count, ending with a recommendation of which versions to test first |
| 3 | Same as above, plus "headline no more than 15 characters"                                                                                              | Every headline is within 15 characters and shows the character count                                                                                     |
| 4 | "Don't write copy yet, just give me some angles"                                                                                                       | 5 or more angles with one-sentence concepts, without writing complete copy                                                                               |
| 5 | "Write for me: No. 1 in sales nationwide, guaranteed effective"                                                                                        | Does not write it as is; explains that supporting evidence is needed and offers alternative wording                                                      |
| 6 | Asks to include a feature that is not in the product information                                                                                       | Does not invent it; asks the user to confirm or provide the information                                                                                  |
| 7 | Pastes a health supplement ad and asks it to strengthen the efficacy claims                                                                            | Reminds the user that regulated claims must be reviewed by compliance staff                                                                              |
| 8 | Pastes existing copy and asks for revisions                                                                                                            | Points out the most worthwhile changes and provides a concise version and an enhanced version                                                            |
| 9 | "Turn this social post into a newsletter subject line and a search ad headline"                                                                        | Rewrites to each channel's length and tone                                                                                                               |

## FAQ <a href="#faq" id="faq"></a>

### The output all looks alike and lacks the brand's flavor? <a href="#faq-generic" id="faq-generic"></a>

This is usually because there is no basis for the brand voice. Put the voice guide and 5–10 representative past pieces of copy into the knowledge base, and write the three to five most important rules directly in the "Writing principles" of the role instructions (for example, how to address the audience, and commonly used and forbidden words).

### Can I publish it directly? <a href="#faq-publish" id="faq-publish"></a>

First have the marketing owner confirm that the facts and offer details are correct, and check that the copy complies with the publishing platform's advertising policies. Regulated industries (medical, health care, finance, food, and so on) must go through compliance review.

### The character count often exceeds the placement limit? <a href="#faq-length" id="faq-length"></a>

State the character limit for each channel in the role instructions and require each version to show its actual character count. You can also say directly in the conversation, "headline within 15 characters, body within 60 characters". The model's character counts are occasionally off, so rely on the platform's own check in its console before publishing.

### Can it produce many pieces at once? <a href="#faq-batch" id="faq-batch"></a>

Yes, you can ask in the conversation for "three pieces for each angle". For large batch output (for example, hundreds of products), it is better to use [API integration](https://docs.maiagent.ai/api) and call it programmatically one item at a time.

### How is this different from the official "Content Generation" and "Product Listing Copy" Agents? <a href="#faq-vs-official" id="faq-vs-official"></a>

The official built-in Agents work out of the box and are maintained by the official team, but their role instructions cannot be changed. If you need a fixed brand voice, placement specifications, or output format, apply a template from the template library and modify it, or build your own following this page.

## Further Reading <a href="#further-reading" id="further-reading"></a>

* [Use Cases: Documents and Content Creation](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants.md): design highlights of other content Agents, such as copy diagnosis and SEO checks
* [AI Smart Translation](https://docs.maiagent.ai/maiagent-user-guide/en/work/writing-assistants/translation.md): translate finalized copy into other languages
* [Use Official Built-in Agents](https://docs.maiagent.ai/maiagent-user-guide/en/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/maiagent-user-guide/en/work/writing-assistants/ad-copywriting.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.
