diff --git a/src/pages/docs/simulation/concepts/personas.mdx b/src/pages/docs/simulation/concepts/personas.mdx
index 0a0346fa..8ecee8e4 100644
--- a/src/pages/docs/simulation/concepts/personas.mdx
+++ b/src/pages/docs/simulation/concepts/personas.mdx
@@ -1,120 +1,51 @@
---
-title: "Personas: Simulated Customer Profiles in Future AGI"
-description: "Personas in Future AGI represent the customers or users your AI agent interacts with in simulation. Define them to create realistic test conversations."
+title: "Personas"
+description: "Give your test customer a personality, a voice, and a way of talking"
---
-## About
-A **persona** defines who the simulated customer is during a test — their demographics, personality, and communication style. The simulator uses these traits to play the "customer" side of the conversation, making interactions feel realistic rather than scripted. You can use one of **18 pre-built personas** or create your own. Personas are typed as **voice** or **chat**, each with settings specific to that channel.
+## What a persona is
-
+A **persona** is the simulated user in a simulation: its demographics, personality, and communication style. The simulator plays the persona as the customer side of the conversation, so a run feels like a real interaction instead of a fixed script. You reach for one of the built-in personas or define your own. A "Price-sensitive caller", for example, is a voice persona with an Indian accent, fast speech, and a high tendency to interrupt, plus a custom `objection_pattern` your [scenario](/docs/simulation/concepts/scenarios) can read.
-## Voice vs Chat
+name, age, location"] --> P["Persona"]
+ BH["Behaviour
personality, style"] --> P
+ CH["Channel traits
voice or chat"] --> P
+ P --> SA["Simulator agent
plays the persona"]
+ style P fill:#2f2f2f,stroke:#ffffff,stroke-width:2px
+`} />
-When creating a custom persona, you select whether it is for **voice** or **chat** simulations.
-- **Voice**: Used in phone or voice-channel tests. You can set speech-related options: **accent**, **conversation speed**, **background noise**, and **interrupt sensitivity** (how easily the persona can be interrupted or can interrupt). Behavioural and basic-information settings apply to both.
-- **Chat**: Used in text-based tests. You can set text-related options: **tone**, **verbosity**, **punctuation style**, **emoji usage**, **slang**, **typos frequency**, and **regional mix**. Basic information and behavioural settings apply to both.
+## What you can customize
-The same persona is not shared across voice and chat; create separate personas if you need both for the same “type” of customer.
+A persona is typed as **voice** or **chat**, and it's customizable across a wide surface, from who the customer is to exactly how they sound. Set as much or as little as you need, and every field falls back to a sensible default:
-## Creating a custom persona
+- **Basic info**: name, description, and demographics, meaning gender, age range, and location
+- **Behaviour**: personality traits and communication style
+- **Voice traits**, on a voice persona: accent, conversation speed, background noise, and turn-taking, split into interrupt sensitivity and finished-speaking sensitivity
+- **Chat traits**, on a chat persona: tone, verbosity, punctuation style, emoji usage, slang, typo frequency, and regional mix
+- **Custom properties**: any attribute your scenario reads per row, like `objection_pattern` or `insurance_type`
+- **Instructions**: free-form guidance the simulator always follows, like "ask for a supervisor after the first objection"
-From the Personas page, click **Create your own persona**. Choose **Voice** or **Chat** depending on whether the persona will be used in voice or chat simulations; the form then shows the relevant settings for that type. Follow the steps in the tab that matches your choice.
-
+That is a deep surface, so most fields have sensible defaults and you only set the ones that matter for the test. Every field and its allowed values lives in the Persona settings reference.
-
-
- Use this flow when creating a persona for **voice** (phone or voice-channel) simulations.
+## Built-in and custom personas
-
-
- Enter the core details the simulator uses to identify this persona. Same fields as chat; all optional except name and description if required by the UI.
+Future AGI ships 18 built-in personas you can drop into a run as-is. When none fit, you create a custom persona in your workspace, shape it across the layers above, and reuse it across every run.
- 
+## The simulator agent
- | Property | Description |
- | -------- | ----------- |
- | Persona name | Name you give this persona (e.g. "Price-sensitive caller"). |
- | Description | Short description, e.g. "An angry customer who is not happy with the service." |
- | Gender (optional) | One or more: Male, Female. |
- | Age (optional) | One or more ranges: 18–25, 25–32, 32–40, 40–50, 50–60, 60+. |
- | Location (optional) | One or more: United States, Canada, United Kingdom, Australia, India. |
-
-
- Set **personality traits** and **communication style**. For voice, also set **accent** (e.g. American, Australian, Indian, Neutral). This controls how the persona responds and speaks during the call.
+The persona describes who the user is; the **simulator agent** is the actor that plays it. It is the model that generates the persona's side of the conversation, along with the voice it speaks in and the pacing it keeps, like how fast it talks and how long a call can run. Choosing a capable simulator agent is what makes the persona hold its character across a long conversation.
- 
-
-
- Control how the voice conversation runs: **conversation speed** (e.g. very slow, slow, moderate, fast, very fast), how the simulator responds, and **background noise** (on/off) for realism. You can also set **interrupt sensitivity** and **finished-speaking sensitivity** so the persona behaves naturally with turn-taking and interruptions.
-
- 
-
-
- Add any extra attributes not covered by the predefined fields (e.g. "insurance_type", "objection_pattern") so scenarios can reference them.
-
- 
- 
-
-
- Add free-form instructions (e.g. "Always ask for a supervisor after the first objection.").
-
- 
-
-
- Click **Add** (or **Save**). The persona appears in your list and can be used in voice scenarios and run tests.
-
-
-
-
- Use this flow when creating a persona for **chat** simulations.
-
-
-
- Enter the core details the simulator uses to identify this persona. Same fields as voice; all optional except name and description if required by the UI.
-
- 
-
- | Property | Description |
- | -------- | ----------- |
- | Persona name | Name you give this persona (e.g. "Price-sensitive buyer"). |
- | Description | Short description, e.g. "An angry customer who is not happy with the service." |
- | Gender (optional) | One or more: Male, Female. |
- | Age (optional) | One or more ranges: 18–25, 25–32, 32–40, 40–50, 50–60, 60+. |
- | Location (optional) | One or more: United States, Canada, United Kingdom, Australia, India. |
-
-
- Set **personality traits** and **communication style**. These define how the persona types and responds in chat.
-
- 
-
-
- Control how the chat persona writes: **tone** (formal, casual, neutral), **verbosity** (brief, balanced, detailed), **punctuation style** (clean, minimal, expressive, erratic), **emoji usage** (never, light, regular, heavy), **slang usage**, **typos frequency**, and **regional mix**. These make the text feel realistic for the persona.
-
- 
-
-
- Add any extra attributes not covered by the predefined fields (e.g. "insurance_type", "objection_pattern") so scenarios can reference them.
-
- 
- 
-
-
- Add free-form instructions (e.g. "Always ask for a supervisor after the first objection.").
-
- 
-
-
- Click **Add** (or **Save**). The persona appears in your list and can be used in chat scenarios and run tests.
-
-
-
-
-
-## Next Steps
+## Keep exploring
-
- Tie your agent and scenario to a run test, attach evals, and run the simulation.
+
+ The agent your persona talks to
+
+
+ Turn a real call into a persona-driven test