Documentation

Personas, Scenarios & Runs

Create AI-powered synthetic personas and scenario scripts, launch batch runs across all combinations, and analyze results in the run matrix and analytics dashboard.

Inside a project, click NovaSynth in the sidebar. The sub-tabs are:

Overview · Agent Config · Agent Connections · Personas · Scenarios · Runs · Analytics

Personas

A persona describes the synthetic caller — their identity, goal, language, and behavioral traits. The NovaSynth LLM impersonates this persona during every session.

Creating a persona manually

Navigate to NovaSynth → Personas and click + Create Persona.

Create Persona dialog showing Name, Goal, Description, Interruptions slider, Speed of Talking slider, Background Noise, Tone Preference, Gender, Age, and Occupation fields

Persona fields

FieldDescription
NameDisplay name shown in the run matrix (e.g., Impatient Customer, Rajesh Kumar)
GoalWhat the synthetic caller is trying to achieve in the conversation
DescriptionBrief internal summary of this persona
InterruptionsHow often the persona interrupts the agent — slider from 0 (never) to 1 (frequently), default 0.50
Speed of TalkingSpeech rate multiplier — slider from 0.7× to 1.2×, default 1.0×
Background NoiseOptional ambient noise type (e.g., office, cafe, street)
Background Noise LevelNoise volume — slider from 5 to 90, default 25
Tone PreferenceOverall communication tone (e.g., neutral, polite, assertive)
GenderOptional demographic context
AgeOptional (e.g., 35)
OccupationOptional (e.g., Software Engineer)

★ Required fields.

Fill in at minimum: Name and Goal.
Set the Interruptions and Speed of Talking sliders to match the persona's communication style.
Add optional demographic fields (age, occupation, gender) and a Background Noise type for realistic call conditions.
Click Create Persona.

Generating personas with AI

The Generate with AI button (Sparkles icon, top right of the Personas tab) creates multiple realistic personas in one shot from a plain-text description.

Click Generate with AI on the Personas tab.
Enter instructions describing the kinds of callers you want — be specific about goal, demographics, and behavior (e.g., "Drivers interested in renting CNG vehicles in Mumbai who are cost-conscious and want to understand pricing before committing").
Set the number of personas to generate (e.g., 5).
Click Generate. The AI creates the full persona set — name, goal, traits, language, tags — and adds them directly to your personas list.
Review, edit, or delete individual personas as needed.

Browse Library

From the Overview tab, click Browse Library to access a shared collection of pre-built personas and scenarios. You can copy items from the library directly into your project.


Scenarios

A scenario is a scripted conversation flow that guides what the synthetic caller does during the session.

Creating a scenario manually

Navigate to NovaSynth → Scenarios and click + Create Scenario.

Create Scenario dialog showing Name, Description, Interruptions slider, Conversation Steps section with Add Step button, and Tags

Scenario fields

FieldDescription
NameDisplay name shown in the run matrix (e.g., Billing Dispute, Qualified Mumbai Candidate)
DescriptionWhat happens in this scenario
InterruptionsPer-scenario interruption override — slider from 0 to 1, default 0.50
Conversation StepsOrdered steps the synthetic caller follows — click + Add Step to add each one
TagsLabels for filtering (type a tag and press Enter)

★ Required field.

Conversation Steps

Click + Add Step to define the conversation flow. Each step has:

PropertyDescription
ActionWhat the synthetic caller says or does (e.g., "Ask about the security deposit amount")
ConditionOptional: only run this step if a condition is met — creates natural conversation branches
FixedIf toggled on, this step always executes regardless of conversation state

The scenarios list shows total step count and how many are fixed (e.g., "5 steps, 3 fixed").

Generating scenarios with AI

Click Generate with AI on the Scenarios tab.
Enter instructions describing the scenarios to generate (e.g., "Scenarios for a car rental agent: happy path, objection handling for security deposit, disqualified city, out-of-scope bike rental").
Set the count and click Generate. The AI creates complete scenarios with steps.
Review each scenario — edit steps, toggle fixed/conditional, reorder as needed.

Running tests

How batch runs work

A batch run pairs selected scenarios with selected personas and runs every combination in parallel:

Scenarios selected: 3
Personas selected:  4
─────────────────────
Total sessions:    12  (one per combination)

Launching a batch run

Batch runs are launched from the Scenarios tab.

Go to NovaSynth → Scenarios.
Check the scenarios you want to include using the row checkboxes.
Click the Run button that appears when scenarios are selected.
Fill in the run dialog (see fields below) and click Run. You are redirected to the batch run detail page as sessions begin.

The run dialog accepts:

FieldDescription
NameAn identifier for this batch (e.g., ef-fourth-test)
Provider connectionWhich Agent Connection endpoint to use
PersonasSelect which personas to pair with the chosen scenarios
Modevoice (real-time audio) or text
MetricsOptionally choose which scorers to run (or leave empty to use project defaults)

Batch run detail

NovaSynth batch run detail showing progress bar, scorer breakdown panel, run matrix of persona × scenario combinations, and all runs table

Summary bar

FieldDescription
ProgressCompleted / total runs (e.g., 9 / 9 runs) with dual progress bars (green = completed, red = failed)
Pass Rate% of sessions where ALL success metrics passed
70% Threshold% of sessions where ≥ 70% of success metrics passed (e.g., 83% (5/6 runs))
StatusCompleted, Partial Failure (some runs failed), or Failed

A "Download Report" button is available in the top-right when the run is complete.

Scorer Breakdown (right panel)

Shows how each scorer performed across all sessions:

ColumnDescription
Scorer namee.g., instruction_adherence
Category badgeTELEPHONY · AUDIO · RAG · SAFETY · LATENCY
Pass counte.g., 0/6 (sessions that passed this scorer)
Pass %e.g., 0% (red) or 83% (green)

Click Show all scorers to expand the full list.

Run Matrix

A grid where rows = personas and columns = scenarios. Each cell shows:

Cell stateMeaning
Completed (green) + N/M scoreRun completed; N = criteria met out of M total
Failed (red)Run failed or all criteria failed
This persona × scenario combination was not included in the batch

The matrix instantly shows which specific combinations are failing. If every cell in one column is red, that scenario is the problem. If one row is consistently failing, that persona is exposing an issue.

All Runs table

Below the matrix, a flat list of every individual session with columns:

Persona · Scenario · Status · Turns · Duration · Result · Actions

Click View run to open the individual session detail.


Run detail (individual session)

NovaSynth individual run detail for Arjun Reddy × Disqualification Due to No License showing waveform player, Score 7.77, 13/16 Criteria Met, Evaluation Results with 20 scorers, and transcript

The individual run page title shows "PersonaName × ScenarioName" along with:

  • Completed status badge (green)
  • N/M Criteria Met badge — how many scorer thresholds were met (e.g., 13/16 Criteria Met)
  • Run metadata: mode (Voice / Text), turn count, call duration, endpoint name

Audio player

For voice and phone sessions:

  • Waveform / Simple audio toggle
  • Color-coded speaker segments: ● Assistant (green) · ● Caller (blue) · ● Silence (gray)
  • Audio stats beneath the player: CALL DURATION · VOLUME · AVG PITCH
  • Playback controls with seek bar (click any point to jump)

Aggregate score

Score: X.XX (0–10 scale) shown prominently below the player — the aggregate across all scored criteria.

Evaluation Results

  • Summary: N scorers · M passed · P failed
  • Filter tabs: All · Failed (N) · Passed (M) · Scorer type dropdown
  • Sort: Score Low → High
  • Expand All / Collapse All buttons

Each scorer card shows the scorer name, category badge, score (e.g., 7.80/10), and a green progress bar for passing scorers. A "Scorer error" badge (orange ⚠) appears when the scorer encountered a technical error — the score may still be shown but reliability is reduced.

Transcript

The right panel shows the full turn-by-turn conversation:

  • Assistant turns on the left
  • User (synthetic persona) turns on the right
  • All turns in the original language the agent and persona spoke

Analytics

NovaSynth analytics showing Call Duration by Persona horizontal bars and Top Failing Scorers bar chart with scorer failure rates

The Analytics tab gives aggregated insights across all runs.

Call Duration by Persona — horizontal bar chart showing average and max duration per persona, with run count.

Top Failing Scorers — bar chart ranking scorers by failure rate across all runs. Use this to identify which quality dimensions are consistently problematic (e.g., if assistant_average_pitch and drop_off_node are always near 100% failure, those are your biggest issues to fix).

ChartWhat it shows
Pass rate over timeDaily pass rate trend — spot regressions after prompt changes
Runs by ScenarioPie chart of run distribution — identify which scenarios are run most
Call Duration by PersonaAverage and max call duration per persona
Top Failing ScorersRanked list of scorers by failure rate

Filter by 7 days, 30 days, or 90 days. Export raw data as CSV with Export CSV.


Scorers used in NovaSynth

NovaSynth sessions are scored with these categories (configurable per project via the batch run dialog):

CategoryScorers
Audio Qualitymos, tone_clarity, pronunciation_audio, gibberish, audio_breakage, mispronunciation, speaking_over_user, word_accuracy, assistant_average_pitch_hz, assistant_volume_rms
Latencyassistant_latency, llm_ttft, stt_latency, tts_latency, tts_ttfb, e2e_latency, end_of_turn_delay
Conversation Qualityinstruction_adherence, sentiment_csat, drop_off_node, conversation_context_coherence, appropriate_call_termination
Accuracy & RAGanswer_relevancy, hallucination_detection, claim_verification, factual_accuracy
Safetyanswer_refusal, content_moderation, content_safety_violation, is_harmful_advice, toxicity
Summaryitem_summary

All scores display as X.XX/10 in the dashboard. See Scorers Reference for field requirements and descriptions.


Next steps

  • Setup — configure provider connections before running
  • Scorers Reference — understand what each scorer measures
  • Datasets — NovaSynth sessions automatically populate a dataset
  • NovaPilot — AI recommendations based on NovaSynth results
Exclusive Early Access

Get Early Access to Noveum.ai Platform

Be the first one to get notified when we open Noveum Platform to more users. All users get access to Observability suite for free, early users get free eval jobs and premium support for the first year.

Sign up now. We send access to new batch every week.

Early access members receive premium onboarding support and influence our product roadmap. Limited spots available.

Personas, Scenarios & Runs | Documentation | Noveum.ai