# Agentic AI

## Agentic AI Chat

Cuppa Chat isn't just a chatbot -it's an autonomous AI agent that can research, create, optimize, and publish content using natural language. Tell it what you want, and it executes multi-step workflows automatically.

***

### What Makes It "Agentic"

Traditional AI chat: You ask, it answers.

**Agentic AI chat:** You give it a goal, it figures out the steps, executes them, and delivers results.

#### Example

**Traditional:** "Write me an article about SEO" → AI writes generic article

**Agentic:** "Research our best-performing keywords, find a gap, write an article targeting it, optimize for our brand voice, and schedule it for next Tuesday" → AI researches GSC data → identifies opportunity → generates article → applies brand voice → adds to content planner

***

### Core Capabilities

#### Research

| Tool                    | What It Does                            |
| ----------------------- | --------------------------------------- |
| `research_keywords`     | Keyword research from seed terms        |
| `analyze_serp`          | SERP analysis with competitor breakdown |
| `get_striking_distance` | Keywords ranking 4-20 (quick wins)      |
| `cluster_keywords`      | Group keywords by intent/topic          |
| `get_analytics`         | Content performance data                |
| `get_articles`          | List your published/draft content       |
| `get_clusters`          | Retrieve existing keyword clusters      |

#### Content Generation

| Tool                      | What It Does                     |
| ------------------------- | -------------------------------- |
| `generate_article`        | Full article targeting keywords  |
| `generate_social_posts`   | Platform-specific social content |
| `generate_featured_image` | AI images for articles           |
| `generate_carousel`       | Multi-slide carousel content     |
| `compare_articles`        | Score and compare versions       |
| `import_url`              | Fetch and parse external content |

#### Content Management

| Tool                  | What It Does                        |
| --------------------- | ----------------------------------- |
| `save_to_drafts`      | Save content as draft               |
| `add_to_planner`      | Schedule in content planner         |
| `update_planner_item` | Modify scheduled items              |
| `create_cluster`      | Create new keyword cluster          |
| `update_article`      | Edit existing articles              |
| `delete_article`      | Remove articles (with confirmation) |

#### Publishing

| Tool                | What It Does                      |
| ------------------- | --------------------------------- |
| `publish_to_cms`    | Push to WordPress, Ghost, Webflow |
| `schedule_social`   | Schedule via Late.dev integration |
| `add_internal_link` | Insert links between articles     |

#### Advanced Workflows

| Tool                                | What It Does                    |
| ----------------------------------- | ------------------------------- |
| `generate_content_calendar`         | Multi-week content planning     |
| `find_linking_opportunities`        | Internal link suggestions       |
| `generate_optimization_suggestions` | SEO improvement recommendations |
| `send_slack_notification`           | Notify when tasks complete      |

***

### Using Agentic Chat

#### Starting a Conversation

1. Navigate to **Cuppa Chat**
2. Type your request naturally
3. Watch as the AI plans and executes

#### Natural Language Examples

**Research:**

> "What keywords are we ranking for but not in the top 3?"

> "Analyze the SERP for 'best project management software' and show me the top competitors"

**Content Creation:**

> "Write a how-to guide about setting up email automation, use our brand voice"

> "Create 5 social posts promoting our new feature launch for LinkedIn and Twitter"

**Content Management:**

> "Schedule my last article for next Monday and create social posts to go with it"

> "Find articles that could link to our pricing page and add the links"

**Full Workflows:**

> "Research trending topics in our niche, create a content calendar for the next month, and schedule the first article"

***

### How It Works

#### Intent Classification

When you send a message, Cuppa:

1. **Classifies intent** — Content, social, SEO, strategy, or publishing
2. **Filters relevant tools** — Only shows tools matching your intent
3. **Plans execution** — Determines which tools and in what order
4. **Executes with context** — Uses your brand data throughout

#### Brand Context

Every action is informed by your Brand DNA:

* **Brand Voice** — Writing style and tone
* **Knowledge Sources** — Custom context and facts
* **Brand Research** — Keywords, competitors, market data
* **Visual Style** — Colors and brand aesthetics for images

#### Memory System

Cuppa remembers:

| Memory Type         | What It Stores                      |
| ------------------- | ----------------------------------- |
| **Brand Memory**    | Your brand context, voice, products |
| **Session Memory**  | Current conversation context        |
| **Learning Memory** | Your preferences over time          |

***

### Approval Levels

Different actions require different approval:

| Level        | Description             | Example Actions                     |
| ------------ | ----------------------- | ----------------------------------- |
| **Auto**     | Executes immediately    | Research, fetching data             |
| **Quick**    | Brief confirmation      | Saving drafts, adding to planner    |
| **Suggest**  | Shows plan first        | Generating content, bulk operations |
| **Explicit** | Requires clear approval | Deleting content, publishing        |

You're always in control of consequential actions.

***

### Rate Limits

Usage is plan-based:

| Plan     | Iterations/Hour | Concurrent Jobs | Research Calls |
| -------- | --------------- | --------------- | -------------- |
| Hobby    | 20              | 1               | 10             |
| Power    | 50              | 3               | 25             |
| Business | 100             | 5               | 50             |
| Agency   | 200             | 10              | 100            |

**Iteration:** Each tool execution counts as one iteration.

***

### Example Workflows

#### Content Gap Analysis

```
You: Find keywords we're not ranking for but our competitors are

Cuppa:
→ Analyzing your GSC data
→ Researching competitor keywords
→ Identifying gaps
→ Here are 15 keyword opportunities with volume and difficulty...
```

#### Full Article Workflow

```
You: Write an article about "how to improve website speed" and schedule it for Friday

Cuppa:
→ Researching SERP for this topic
→ Analyzing top-ranking content
→ Generating comprehensive article
→ Applying your brand voice
→ Adding internal links
→ Scheduling for Friday
→ Done! Article scheduled. Would you like social posts to promote it?
```

#### Social Content Burst

```
You: Create a week's worth of social posts promoting our latest blog post

Cuppa:
→ Reading your latest article
→ Generating 7 unique angles
→ Creating LinkedIn posts (3)
→ Creating Twitter threads (2)
→ Creating Instagram captions (2)
→ Here are your posts. Want me to schedule them throughout the week?
```

#### Internal Linking Audit

```
You: Find articles that should link to each other but don't

Cuppa:
→ Analyzing your content library
→ Running semantic similarity
→ Identifying linking opportunities
→ Found 23 potential internal links. Here are the top 10 opportunities...
```

***

### Best Practices

#### Be Specific

```
❌ "Write something about marketing"

✅ "Write a 1,500-word guide about email marketing automation for SaaS companies, targeting the keyword 'email marketing automation tools'"
```

#### Use Context

```
❌ "Create social posts"

✅ "Create LinkedIn posts promoting our article about SEO best practices, emphasizing our unique approach to technical SEO"
```

#### Chain Actions

```
✅ "Research keywords about 'content marketing', cluster them, create a content calendar for the top 5 clusters, and draft the first article"
```

#### Review Before Publishing

```
✅ "Generate the article but don't publish yet—I want to review it first"
```

***

### Troubleshooting

#### "Agent seems stuck"

**Try:** Simplify your request. Break complex workflows into steps.

#### "Wrong brand voice"

**Check:** Brand Voice is set up and active. The agent uses whatever voice is currently active.

#### "Not using my knowledge sources"

**Try:** Explicitly mention them: "Using our product documentation, write about..."

#### "Actions not executing"

**Check:** You may have hit rate limits. Check your plan's limits and wait if needed.

#### "Results not relevant"

**Improve:** Add more context about your industry, audience, and goals.

***

### Permissions

Tool access varies by role:

| Role       | Access                       |
| ---------- | ---------------------------- |
| **Owner**  | All tools                    |
| **Admin**  | All tools except billing     |
| **Editor** | Content tools, no publishing |
| **Viewer** | Research tools only          |

***

### Coming Soon

Features in development:

* **Multi-step workflow templates** — Save and reuse complex workflows
* **Scheduled agent tasks** — "Every Monday, find trending topics and suggest articles"
* **Cross-brand coordination** — Agents managing multiple brands
* **Custom tool creation** — Add your own integrations

***

### Plan Availability

| Feature            | Hobby | Power | Business | Agency |
| ------------------ | ----- | ----- | -------- | ------ |
| Basic Chat         | ✅     | ✅     | ✅        | ✅      |
| Agentic Mode       | ❌     | ✅     | ✅        | ✅      |
| All Tools          | —     | ✅     | ✅        | ✅      |
| Memory System      | —     | ✅     | ✅        | ✅      |
| Higher Rate Limits | —     | —     | ✅        | ✅      |

***

### Related Features

* Brand Voice — Applied to all generated content
* Knowledge Sources — Custom context for accuracy
* Content Planner — Where scheduled content lands
* Content Clusters — Organize keyword research


---

# 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/cuppa-chat/agentic-ai.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.