# AI Instructions (formerly Presets)

## AI Instructions (formerly Presets)

AI Instructions let you customize how Cuppa generates content—controlling everything from article type and tone to specific writing rules and formatting preferences. Think of them as reusable templates that ensure consistency across all your content.

***

### Why Use AI Instructions

Without AI Instructions, you'd need to specify your preferences every time you generate content:

* Article type
* Tone of voice
* Point of view
* Length
* FAQ inclusion
* Image settings
* And more...

AI Instructions save these preferences so you can apply them with one click.

***

### What You Can Configure

#### Article Settings

| Setting           | Options                                                            |
| ----------------- | ------------------------------------------------------------------ |
| **Article Type**  | General, Listicle, Review, How-To, Location Page                   |
| **Target Length** | Short (\~800 words), Medium (\~1,500 words), Long (\~2,500+ words) |
| **Point of View** | First person plural (we/us), Second person (you), Third person     |
| **Include FAQs**  | Yes/No — adds FAQ section at end                                   |
| **FAQ Count**     | Number of FAQs to include (3-10)                                   |

#### Tone & Style

| Setting           | Options                                                            |
| ----------------- | ------------------------------------------------------------------ |
| **Tone of Voice** | SEO Optimized, Professional, Conversational, Casual, Formal, Witty |
| **Reading Level** | Simple, Moderate, Advanced, Technical                              |
| **Emoji Usage**   | None, Minimal, Moderate                                            |

#### Image Settings

| Setting             | Options                                          |
| ------------------- | ------------------------------------------------ |
| **Generate Images** | Yes/No                                           |
| **Image Count**     | 1-5 per article                                  |
| **Image Style**     | Photographic, Illustration, Diagram, Stock-style |
| **Image Model**     | DALL-E 3, Flux, Ideogram                         |

#### Research Settings

| Setting                 | Options                                    |
| ----------------------- | ------------------------------------------ |
| **Perplexity Research** | Enable/Disable — uses AI to research topic |
| **Include Statistics**  | Yes/No — pulls relevant stats and data     |
| **Cite Sources**        | Yes/No — includes source links             |

#### Custom Instructions

The most powerful feature—add any specific instructions:

```
Always include a call-to-action linking to our product page.

Use bullet points for any list of 3+ items.

Avoid using the word "leverage" - use "use" instead.

Include a comparison table when discussing alternatives.

Start every article with a hook question, never a definition.
```

***

### Creating AI Instructions

1. Navigate to **Brand DNA → AI Instructions**
2. Click **Create Instructions**
3. Name your preset (e.g., "Blog Posts - Standard", "Product Reviews")
4. Configure your settings
5. Add any custom instructions
6. Save

#### Best Practices

**Do:**

* Create specific presets for different content types
* Name presets clearly (include use case)
* Test presets with sample generations before bulk use
* Update custom instructions based on what works

**Don't:**

* Make presets too generic (defeats the purpose)
* Add conflicting instructions
* Forget to update old presets when your strategy changes

***

### Using AI Instructions

#### In Single Article Generation

1. Start generating an article
2. In the sidebar, select your AI Instructions preset
3. Generate as normal

#### In Bulk Generation

1. Create a bulk project
2. Select AI Instructions for the entire project
3. All articles will use those settings

#### In Agentic Chat

1. Ask Cuppa Chat to generate content
2. Specify which preset to use: "Use my 'Blog Posts' preset"
3. Or configure the chat agent's default preset

#### Per-Article Override

Even with AI Instructions selected, you can override any setting for a specific article. The override applies only to that article

***

### Troubleshooting

#### "Preset not being applied"

**Check:** Make sure the preset is selected before generating. The preset dropdown should show your preset name, not "Default."

#### "Custom instructions being ignored"

**Try:** Make instructions more explicit. Instead of "be casual," write "use contractions, short sentences, and conversational language."

#### "Settings conflict with brand voice"

**Note:** AI Instructions and Brand Voice work together. Brand Voice sets the overall personality, AI Instructions set the structure and format. If they conflict, Brand Voice typically takes precedence for tone.

### Related Features

* Brand Voice — Personality and tone training
* Knowledge Sources — Custom context documents
* Single Article Generation — Apply presets to articles


---

# Agent Instructions: 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:

```
GET https://learn.cuppa.ai/brand-dna/ai-instructions-formerly-presets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
