Create Persona
Required scope: agent_eval:create.
Tips for designing a useful persona:
- Lead the
identity_promptwith the persona’s role and what brought them to the call. - Put behaviour knobs (patience, cooperation, verbosity) in
behavior_traits, not in the prompt — that way you can reuse one identity across friendly + adversarial variants. - Keep the prompt under ~120 words. Long prompts make the persona LLM rigid.
Designing the prompt
Lead with the persona’s role and what brought them to the call:patience, verbosity, cooperation) in behavior_traits, not the prompt — that way one identity becomes many variants.
Common behavior_traits keys
Authorizations
Your Yappr API key (e.g. ypr_live_...). Generate one in the dashboard under Settings → API Keys.
Body
Response
Persona created
Reusable caller archetype consumed by eval cases. The identity_prompt plus behavior_traits shape how the persona LLM responds; the same persona can be reused across many cases.
"Frustrated tenant"
System prompt fragment defining who the persona is. Written second-person ("You are…").
"You are a 38-year-old tenant calling about a leaking pipe in your kitchen. You're frustrated because this is the third time you've reported it."
he, en Free-form JSON. Common keys: patience (low|medium|high), verbosity (terse|chatty), cooperation (cooperative|adversarial), interruption_tendency (none|occasional|frequent), accent / dialect hints, goal (what the persona is trying to achieve in the call).
Forward-compat for v2 voice-mode (TTS/STT loopback). Ignored in text mode.