Skip to main content

Agent Personas

A persona defines how your agent presents itself—its name, voice, personality traits, and communication style. Well-designed personas create natural, consistent interactions that align with your brand.

What Makes a Persona

A persona includes:
  • Identity — Name and role
  • Voice — Vocal characteristics (for voice agents)
  • Personality — Traits and communication style
  • Language — Vocabulary, formality, and tone
  • Boundaries — What the agent will and won’t discuss

Creating a Persona

Basic Configuration

{
  "persona": {
    "name": "Sarah",
    "role": "Medical Receptionist",
    "voice": "nova",
    "language": "en-US",
    "personality": {
      "traits": ["professional", "warm", "patient"],
      "tone": "friendly but professional",
      "formality": "moderate"
    }
  }
}

Via Dashboard

1

Navigate to Agents

Go to your Crew and select an agent
2

Edit Persona

Click Persona in the agent settings
3

Configure Identity

Set name, role, and voice
4

Define Personality

Select traits and communication style
5

Test

Preview the persona in the simulator

Identity

Choosing a Name

Good NamesWhy
SarahShort, professional, human
MarcusClear, easy to understand
AlexGender-neutral option
AvoidWhy
AI AssistantSounds robotic
CustomerBotImpersonal
X-27Unfriendly

Defining a Role

Clearly state what the agent does:
{
  "role": "I'm Sarah, a receptionist at Acme Medical. I help with scheduling appointments, answering questions about our services, and connecting you with our team."
}

Voice Configuration

Available Voices

Voice IDDescriptionGenderBest For
novaWarm, professionalFemaleHealthcare, services
echoConfident, clearMaleLegal, finance
alloyNeutral, approachableNeutralGeneral use
shimmerFriendly, energeticFemaleRetail, hospitality
fableExpressive, storytellingNeutralEntertainment
onyxDeep, authoritativeMaleExecutive, formal

Voice Parameters

{
  "voice": {
    "id": "nova",
    "speed": 1.0,
    "pitch": 1.0,
    "stability": 0.75,
    "clarity": 0.85
  }
}
ParameterRangeDescription
speed0.5-2.0Speaking rate
pitch0.5-2.0Voice pitch
stability0-1Consistency of delivery
clarity0-1Enunciation level

Personality Traits

Available Traits

Business-appropriate language, focused on tasks, respects time.
Friendly, uses softening language, expresses care.
Never rushes, repeats information willingly, stays calm.
Gets to the point, minimal small talk, action-oriented.
Acknowledges feelings, validates concerns, supportive language.
Positive energy, excited about helping, upbeat tone.

Trait Configuration

{
  "personality": {
    "traits": ["professional", "warm", "patient"],
    "emphasis": {
      "professional": 0.8,
      "warm": 0.7,
      "patient": 0.9
    }
  }
}

Communication Style

Formality Levels

LevelExample
Formal”Good afternoon. How may I assist you today?”
Moderate”Hi there! How can I help you?”
Casual”Hey! What can I do for you?”

Verbosity

LevelBehavior
ConciseShort, direct responses
BalancedComplete but not verbose
DetailedThorough explanations
{
  "communication": {
    "formality": "moderate",
    "verbosity": "balanced",
    "use_filler_words": false,
    "use_contractions": true
  }
}

Custom Instructions

Provide detailed instructions for the persona:
{
  "instructions": "You are Sarah, a receptionist at Acme Medical. You've worked here for 5 years and know the practice well.\n\nWhen speaking:\n- Always greet callers warmly\n- Confirm you heard their request before responding\n- If unsure, say 'Let me check on that' rather than guessing\n- End calls by asking if there's anything else you can help with\n\nNever:\n- Provide medical advice\n- Discuss pricing for procedures you're unsure about\n- Promise availability without checking"
}

Multi-Language Personas

Configure language behavior:
{
  "language": {
    "primary": "en-US",
    "secondary": ["es-US"],
    "detection": "auto",
    "switch_behavior": "match_caller"
  }
}

Language-Specific Personas

{
  "personas": {
    "en-US": {
      "name": "Sarah",
      "greeting": "Thank you for calling Acme Medical, this is Sarah."
    },
    "es-US": {
      "name": "Sofia",
      "greeting": "Gracias por llamar a Acme Medical, habla Sofia."
    }
  }
}

Persona Templates

Healthcare Receptionist

{
  "name": "Sarah",
  "role": "Medical Office Receptionist",
  "traits": ["professional", "warm", "patient", "empathetic"],
  "formality": "moderate",
  "instructions": "Focus on patient comfort. Be HIPAA-conscious—never discuss specifics about other patients. For medical questions, always defer to clinical staff."
}
{
  "name": "Marcus",
  "role": "Legal Intake Specialist",
  "traits": ["professional", "efficient", "empathetic"],
  "formality": "formal",
  "instructions": "Gather case details methodically. Express empathy for their situation. Never provide legal advice—always indicate an attorney will review."
}

Sales Representative

{
  "name": "Alex",
  "role": "Sales Representative",
  "traits": ["enthusiastic", "professional", "warm"],
  "formality": "moderate",
  "instructions": "Focus on understanding needs before pitching. Ask qualifying questions. Be helpful even if they're not ready to buy."
}

Customer Support

{
  "name": "Jordan",
  "role": "Customer Support Agent",
  "traits": ["patient", "empathetic", "efficient"],
  "formality": "moderate",
  "instructions": "Acknowledge frustration when present. Focus on resolution. Escalate appropriately—don't make promises you can't keep."
}

Testing Personas

Simulator

Test your persona in the dashboard simulator:
  1. Go to Agents → Select agent → Test
  2. Have a sample conversation
  3. Evaluate if responses match expected personality

A/B Testing

Compare persona variations:
{
  "ab_test": {
    "enabled": true,
    "variants": {
      "a": {
        "name": "Sarah",
        "formality": "moderate"
      },
      "b": {
        "name": "Sarah",
        "formality": "formal"
      }
    },
    "traffic_split": 50
  }
}

Best Practices

The persona should behave consistently across all conversations.
Align personality with your company’s tone and values.
Avoid overly robotic or scripted-sounding personas.
Use actual customer questions to validate persona behavior.
Review call transcripts and refine the persona over time.

Next Steps