> ## Documentation Index
> Fetch the complete documentation index at: https://penseapp.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Scenarios

> Define what your simulated users should do in simulations

Scenarios define the specific task or goal for your [personas](/docs/core-concepts/personas) in [agent simulations](/docs/quickstart/simulations). They describe `WHAT` the simulated user should do during the conversation.

## Quickstart

### Create a new scenario

From the sidebar, click **Scenarios** to view your existing scenarios. Click **Add scenario** to create a new scenario.

<Frame>
  <img src="https://mintcdn.com/amandalmia/tjiLC2r2NWNinh9Y/core-concepts/images/scenarios-1.png?fit=max&auto=format&n=tjiLC2r2NWNinh9Y&q=85&s=66991f82bfe4ded36e41444a45214d99" alt="Scenarios" width="3024" height="988" data-path="core-concepts/images/scenarios-1.png" />
</Frame>

### Add the label and description

Give a meaningful label to the scenario (e.g. `crop insurance inquiry`) and define the task or goal clearly.

<Note>
  Avoid defining personality traits in scenarios. Use
  [**Personas**](/docs/core-concepts/personas) to define `HOW` the simulated user
  behaves
</Note>

<Frame>
  <img src="https://mintcdn.com/amandalmia/tjiLC2r2NWNinh9Y/core-concepts/images/scenarios-2.png?fit=max&auto=format&n=tjiLC2r2NWNinh9Y&q=85&s=2c08fadea73f0c7069da21ef02aff576" alt="Add label and description" width="2260" height="1702" data-path="core-concepts/images/scenarios-2.png" />
</Frame>

### Save the scenario

Click **Add scenario** to create the scenario.

## Best practices

### Writing effective scenarios

1. **Be specific**: Include concrete details (order numbers, dates, amounts)
2. **Set clear objectives**: What should the user aim to achieve?
3. **Include conversation flow hints**: What questions should they ask?
4. **Add realistic context**: Why is the user calling?

### Scenarios vs personas

| Aspect  | Scenario                              | Persona                                  |
| ------- | ------------------------------------- | ---------------------------------------- |
| Focus   | WHAT to do                            | WHO and HOW                              |
| Content | Task, goal, situation                 | Demographics, behavior                   |
| Example | "Call to get a refund for order #123" | "A busy professional who speaks quickly" |

### Scenario complexity levels

| Level       | Description                      | Example                                             |
| ----------- | -------------------------------- | --------------------------------------------------- |
| **Simple**  | Single task, straightforward     | "Check account balance"                             |
| **Medium**  | Multiple questions, some details | "Inquire about insurance and ask about eligibility" |
| **Complex** | Edge cases, negotiations         | "Dispute a charge and escalate if unsatisfied"      |

## Next steps

<CardGroup cols={2}>
  <Card title="Create Personas" icon="user" href="/docs/guides/personas">
    Define who your simulated users are and how they behave
  </Card>

  <Card title="Run Simulations" icon="comments" href="/docs/guides/simulations">
    Test your agent with combinations of personas and scenarios
  </Card>
</CardGroup>