Learn how AI personas work and how to customize them
brainType
parameter has been deprecated and
replaced with llmId
to support custom language models. For backwards
compatibility, you can still pass your existing brainType
value as llmId
.
See our Custom LLMs guide for more details.name
The name of your persona. This is optional but recommended for internal organization and debugging. It doesn’t affect how the persona behaves, but helps you identify different personas in logs and analytics.
avatarId
The face and expressions users see. You can choose from our gallery or create custom avatars using our one-shot avatar generator (enterprise only).
voiceId
The speech synthesis that brings your persona to life. Different voices convey different personalities and work better for different use cases. You can sample some of the available voices in our voice gallery.
llmId
and systemPrompt
The AI model and instructions that define how your persona thinks, responds, and behaves during conversations.
Configuration
Session Token Creation
Initialization
Conversation
Session End
maxSessionLengthSeconds
parameter in your persona configuration. This is useful for managing costs, ensuring security, or creating time-limited experiences.
maxSessionLengthSeconds
, the session will automatically end after the specified time limit, regardless of whether the conversation is ongoing. The countdown begins when the persona starts streaming.
maxSessionLengthSeconds
, the session will continue
until manually ended or until it reaches the maximum session length limit of
30 minutes.