> For the complete documentation index, see [llms.txt](https://craft-agent.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://craft-agent.gitbook.io/home/node-reference/persona-node.md).

# Persona Node

The Persona node defines **who your AI agent is** — its role, expertise, communication style, and behavioral guidelines. Think of it as hiring a specialist for a specific job.

## How It Works

When you connect a Persona node to an AI Agent, its prompt template is injected into the agent's system instructions. This shapes how the agent thinks, responds, and uses tools — without you having to write complex prompts every time.

```
[Trigger] → [Agent] ← [Persona: "Deep Researcher"]
                     ← [Tool: conduct_research]
                     ← [Tool: search_web]
                     ← [Agent Goal: "Research Bitcoin trends"]
```

## Settings

| Setting            | Description                            | Default |
| ------------------ | -------------------------------------- | ------- |
| **Select Persona** | Choose from your saved personas        | None    |
| **Custom Prompt**  | Write a one-off persona prompt instead | Empty   |

## Inputs & Outputs

| Port                         | Type | Description                                |
| ---------------------------- | ---- | ------------------------------------------ |
| **Output** → Agent (persona) | Text | The persona prompt injected into the agent |

## Selecting a Persona

When you tap a Persona node, you'll see a list of all available personas — both your own and public system personas. Tap one to select it. The persona's prompt template will be automatically applied to the connected agent.

You can also write a **custom prompt** by expanding the "Write custom prompt instead" option. This is useful for one-off tasks where you don't need a reusable persona.

***

## Choosing the Right Persona for Your Workflow

The key to effective workflows is matching the right persona to your task and tools. Here's a guide:

### Research & Analysis Workflows

| Persona                         | Best For                                                  | Pair With These Tools                                                    |
| ------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------ |
| **Deep Researcher**             | Comprehensive reports, literature reviews, fact-finding   | `conduct_research`, `search_web`, `search_news`, `read_url`, Google Docs |
| **Market & Competitor Analyst** | Competitive intelligence, market sizing, pricing analysis | `conduct_research`, `search_web`, `read_url`, Google Sheets, Google Docs |
| **News & Trend Monitor**        | Daily digests, breaking news tracking, trend alerts       | `search_news`, `read_url`, Telegram, Slack, Email                        |

**Example workflow:**

```
[Trigger: Daily 9am] → [Agent] ← [Persona: News Monitor]
                               ← [Tool: search_news]
                               ← [Tool: read_url]
                               ← [Goal: "Find top AI news"]
                      [Agent] → [Telegram: Send digest]
```

***

### Writing & Content Workflows

| Persona                            | Best For                               | Pair With These Tools                                     |
| ---------------------------------- | -------------------------------------- | --------------------------------------------------------- |
| **Content Writer & Publisher**     | Blog posts, articles, SEO content      | `conduct_research`, `search_web`, `read_url`, Google Docs |
| **Social Media Copywriter**        | Platform-specific posts, hooks, CTAs   | `search_news`, `read_url`, Telegram, Discord, Slack       |
| **Email Craftsman**                | Cold outreach, newsletters, follow-ups | `search_web`, `read_url`, `send_email`, Google Docs       |
| **Technical Documentation Writer** | API docs, guides, READMEs              | `search_web`, `read_url`, GitHub tools, Google Docs       |

**Example workflow:**

```
[Trigger] → [Agent] ← [Persona: Content Writer]
                    ← [Tool: conduct_research]
                    ← [Tool: create_google_doc]
                    ← [Tool: append_to_google_doc]
                    ← [Goal: "Write a 1500-word guide on React Server Components"]
           [Agent] → [Preview]
```

***

### Social Media & Community Workflows

| Persona                  | Best For                                     | Pair With These Tools                                                |
| ------------------------ | -------------------------------------------- | -------------------------------------------------------------------- |
| **Social Media Manager** | Content calendars, multi-platform publishing | `search_news`, `search_web`, Telegram, Discord, Slack, Google Sheets |
| **Community Manager**    | Member engagement, onboarding, moderation    | Telegram, Discord, Slack, `search_web`                               |

**Example workflow:**

```
[Trigger: Weekly] → [Agent] ← [Persona: Social Media Manager]
                            ← [Tool: search_news]
                            ← [Tool: search_web]
                            ← [Goal: "Create 5 social posts for this week"]
                   [Agent] → [Telegram: Post to channel]
```

***

### Business & Productivity Workflows

| Persona                 | Best For                                         | Pair With These Tools                                   |
| ----------------------- | ------------------------------------------------ | ------------------------------------------------------- |
| **Executive Assistant** | Email drafting, scheduling, meeting prep         | `send_email`, Google Calendar, Google Meet, Google Docs |
| **Project Tracker**     | Status updates, sprint tracking, reporting       | Google Sheets, Telegram, Slack, Email                   |
| **Meeting Assistant**   | Agendas, meeting notes, action item distribution | Google Docs, Google Calendar, `send_email`, Slack       |

**Example workflow:**

```
[Trigger: Daily 8am] → [Agent] ← [Persona: Executive Assistant]
                               ← [Tool: list_google_calendar_events]
                               ← [Tool: get_weather]
                               ← [Tool: get_current_time]
                               ← [Goal: "Create my morning briefing"]
                      [Agent] → [Telegram: Send briefing]
```

***

### Engineering & Development Workflows

| Persona                       | Best For                                  | Pair With These Tools                               |
| ----------------------------- | ----------------------------------------- | --------------------------------------------------- |
| **Senior Software Developer** | Code solutions, architecture, debugging   | `search_web`, `read_url`, GitHub tools, Google Docs |
| **DevOps & Infrastructure**   | Deployment, monitoring, incident response | `http_request`, GitHub tools, Slack, Telegram       |
| **API Architect**             | API design, endpoint specs, documentation | `search_web`, GitHub tools, Google Docs             |

**Example workflow:**

```
[Trigger: Webhook] → [Agent] ← [Persona: DevOps & Infrastructure]
                             ← [Tool: http_request]
                             ← [Tool: create_github_issue]
                             ← [Goal: "Check health of production services, create issues for any failures"]
                    [Agent] → [Slack: Alert #ops channel]
```

***

### Creative & Design Workflows

| Persona                  | Best For                                       | Pair With These Tools                                    |
| ------------------------ | ---------------------------------------------- | -------------------------------------------------------- |
| **Visual Creator**       | Social graphics, thumbnails, marketing visuals | `search_web`, `read_url`, Telegram, Discord, Google Docs |
| **UX/UI Design Advisor** | Design reviews, component specs, wireframes    | `search_web`, `read_url`, Google Docs                    |

***

### Customer & Sales Workflows

| Persona                    | Best For                                       | Pair With These Tools                                                |
| -------------------------- | ---------------------------------------------- | -------------------------------------------------------------------- |
| **Customer Support Agent** | Issue resolution, FAQ responses, escalation    | `search_web`, `read_url`, `send_email`, Telegram, Slack              |
| **Sales Researcher**       | Prospect research, outreach, pipeline tracking | `search_web`, `search_news`, `read_url`, `send_email`, Google Sheets |

**Example workflow:**

```
[Telegram Trigger] → [Agent] ← [Persona: Customer Support]
                             ← [Tool: search_web]
                             ← [Tool: read_url]
                    [Agent] → [Telegram: Reply to customer]
```

***

### Personal & Education Workflows

| Persona                      | Best For                                      | Pair With These Tools                                                          |
| ---------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------ |
| **Adaptive Tutor**           | Learning concepts, study guides, explanations | `conduct_research`, `search_web`, `read_url`, Google Docs                      |
| **Daily Personal Assistant** | Morning briefings, scheduling, quick lookups  | `get_weather`, `get_current_time`, Google Calendar, `calculator`, `send_email` |
| **Multilingual Translator**  | Translations, localization, transcreation     | `search_web`, `send_email`, Telegram, Google Docs                              |
| **Data Analyst**             | Data interpretation, reporting, calculations  | `calculator`, Google Sheets, Google Docs, `search_web`                         |

***

## Tips for Effective Persona Usage

### ✅ Do

* **Match persona to task** — a Deep Researcher for research, not for writing tweets
* **Pair the right tools** — personas mention specific tools in their prompts; connect those tools to your agent
* **Use one persona per agent** — multiple personas will conflict; pick the most relevant one
* **Customize when needed** — use "Customize" on the dashboard to tweak a template's prompt for your specific needs

### ❌ Don't

* **Don't skip the persona** — generic agents produce generic results
* **Don't use a Content Writer for research** — each persona is optimized for its domain
* **Don't override with conflicting agent goals** — your Agent Goal should complement the persona, not contradict it

### Pro Tips

> **Chain personas across agents:** For complex workflows, use multiple agents with different personas. For example: Agent 1 (Deep Researcher) → Agent 2 (Content Writer) → Agent 3 (Social Copywriter).

> **Persona + Goal = Magic:** The persona defines *who* the agent is. The Agent Goal defines *what* to do. Together they're powerful: `Persona: Sales Researcher` + `Goal: "Research Acme Corp and draft an outreach email"`.

***

## Creating Custom Personas

You can create your own personas from the workflow editor:

1. Click **Browse Templates** to start from a pre-built template
2. Click **Customize** to edit the template before saving, or **Quick Add** to create it instantly
3. Click **Create Persona** to write one from scratch

Your persona will appear in the Persona node's selection list across all your workflows.

***

## Credit Usage

The Persona node itself doesn't consume credits — it only provides context to the connected AI Agent. Credits are consumed by the agent based on the model and prompt length (including the persona prompt).

> **Tip:** Longer persona prompts increase token usage. Keep prompts focused and concise for cost efficiency — the pre-built templates are already optimized for this.