Nuance LabsDocs

Personas

How each persona looks, and the persona_id that picks it.

A persona is the face and voice a conversation has. Pick one with personality.persona_id when your server mints the session token (API keys and session tokens):

{
  "personality": {
    "persona_id": "sonia",
    "system_prompt": "You are Sonia, the front-desk assistant at Riverside Library."
  }
}

Leave persona_id out for sam. Any other id is refused with a 400 unknown_persona whose detail lists the ids you can use (Errors). The persona sets only how it looks and sounds: who the persona is comes from your own prompt, so give it a name there that suits it.

The stills below are from live conversations, each persona reacting to good news, a joke and sad news.

sam

Sam is the default.

Sam: four stills from a live conversation, smiling, laughing and talking

sonia

Sonia: four stills from a live conversation, talking, smiling and sympathetic

mira

Mira: four stills from a live conversation, calm, laughing and surprised

On this page