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

# Emotion handling

> Run one flow with callers who are angry, anxious, confused or rushed and find which moods your agent handles worst

export const property_0 = "emotion"

## Why this is a common failure point

People call when something has gone wrong, so a large share of callers arrive frustrated, anxious or confused. Emotional callers speak differently (faster, louder, in fragments) and behave differently: they interrupt, repeat themselves and change direction. An agent that only ever met calm test callers mishears them, keeps the same cheerful tone with an angry caller, or loses the thread when a confused caller circles back.

## How Roark tests it

Emotion handling runs the same flow with a caller in each mood you pick, with the same goal and information every time. It tells you whether any mood makes your agent misunderstand the caller or fail the call, and measures how your agent sounded in response, so you can see whether it stayed calm.

It is a **property sweep**: every value runs the same flow with everything else held the same, and the report tells you which values did worse than the rest and which differences are just chance.

***

## The values

| Value      |                    |
| :--------- | :----------------- |
| Neutral    | Suggested baseline |
| Cheerful   |                    |
| Frustrated |                    |
| Angry      |                    |
| Anxious    |                    |
| Sad        |                    |
| Skeptical  |                    |
| Confused   |                    |
| Rushed     |                    |
| Distracted |                    |

Mood changes how the caller speaks (tone, pace, pitch) and how they behave. The caller's goal and information stay the same.

***

## What it measures

The template seeds these, and your flow's own metrics run alongside them. Only checks can mark a value **Worse on**; the other measures explain why.

| Measure                           | What it tells you                                                                      |
| :-------------------------------- | :------------------------------------------------------------------------------------- |
| **Comprehension Failure (check)** | The agent misunderstood or misheard the caller. The check fails any call where it did. |
| **Dominant Emotion**              | The emotion that dominated each speaker's voice.                                       |
| **Vocal Valence**                 | How positive or negative each speaker sounded.                                         |
| **Vocal Activation**              | How calm or energised each speaker sounded.                                            |
| **Vocal Pitch Delta**             | How far apart the agent's and caller's pitch were.                                     |
| **Vocal Loudness Delta**          | How much louder or quieter the agent was than the caller.                              |
| **Vocal Pitch Variation Delta**   | How much more or less expressive the agent was than the caller.                        |
| **Speech Pace Delta**             | How much faster or slower the agent spoke than the caller.                             |
| **Call Outcome**                  | Whether the call ended where it should.                                                |

***

## What to look for

* **Mirroring.** An agent that gets louder or faster with an angry caller shows it in the loudness and pace deltas. Steady deltas across moods mean it held its tone.
* **Confused and distracted callers** repeat themselves and change direction. Comprehension failures there are the most actionable finding this sweep produces.
* **The vocal measures explain, the check decides.** Only Comprehension Failure is a check, so only it can mark a mood **Worse on**.

***

## Setting one up

Pick the flow to test, then the values to run it across. Every value starts selected; deselect the ones you don't need. Each value runs your flow again, so the values you keep are the cost of the run.

**Compared against** sets the baseline: a reference value the report pins first, such as silence for background noise. The template suggests the natural one, and you can change it or choose none. It doesn't change the verdict: whether a value did worse is always decided against every other value combined.

**Iterations** live in the sweep panel rather than in Advanced. Each value runs every attached test case once per iteration:

> **Calls per value = test cases x iterations**

Each value needs **at least 5 calls** to be compared with the others, and the Iterations field won't go below the count that reaches it. It starts at 6 calls per value, so one call [excluded after the run](/documentation/simulation-testing/running-simulations#calls-that-dont-count) doesn't drop a value out of the comparison.

More calls let the report see smaller differences. For a sweep of 10 values:

| Calls per value | A value has to be about this much worse to be flagged | Calls in total |
| :-------------- | :---------------------------------------------------- | :------------- |
| 5               | 50 percentage points                                  | 50             |
| 10              | 35 percentage points                                  | 100            |
| 20              | 25 percentage points                                  | 200            |
| 30              | 20 percentage points                                  | 300            |

<Note>
  Below 5 calls a value can never be flagged, however badly it does, which is why the minimum is enforced rather than suggested. Over the API, a sweep template defaults `iterationCount` to 6 and refuses a plan with fewer than 5 calls per value with a `400`.
</Note>

***

## How the results are decided

The sweep's table leads the run report. Its **Compared with the rest** column gives each value one result:

| Result                  | What it means                                                                                                                                                                      |
| :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Worse on** *check*    | The value failed that check more often than all the other values combined, by a gap too large to be chance.                                                                        |
| **No difference**       | Any gap is within what chance produces with this many calls. That is not proof of no effect: a small run can only see large gaps, and the report says how large when that matters. |
| **Too few calls** (*n*) | Fewer than 5 counted calls, so the value is shown but not compared.                                                                                                                |
| **Not graded**          | The value ran, but none of its calls were graded.                                                                                                                                  |

How "too large to be chance" is decided:

* Each value is compared with **all the other values combined**, one check at a time, never with a single other value. Two values that happen to land at opposite ends are not a finding on their own.
* A sweep makes many comparisons at once (every value on every check), and some will look different by luck alone. The report accounts for that: of all the values it flags in a run, **at most 1 in 10 is expected to be a fluke**.
* A value is flagged only when it does **worse**. Doing better than the rest is not a problem to fix.

**Checks passed** shows each value's pass rate with the number of calls behind it, so 100% of two calls never reads like 100% of twenty. A lower rate with **No difference** beside it means the gap is not larger than chance.

**Fails, not {property_0} specific.** A check that fails on **at least 20% of calls** with no value standing out is listed under this heading. It is a real problem, just not one {property_0} caused, so changing {property_0} won't fix it. Select the check to open its evidence.

The executive summary follows the same rules: it only blames the property for failures the table marks **Worse on**. Hover **How this works** under the table for this run's own numbers.
