Personas
A persona defines the identity of an NPC — who they are, how they speak, and what they know.
What is a Persona?
A persona is the foundation of every NPC. It defines the character's identity independent of any specific conversation flow. The persona context is injected into every AI prompt, so the NPC's name, backstory, and personality influence every line of dialogue regardless of which state the conversation is in.
Persona Fields
name— The character's display name, shown in the chat interface and used when the NPC refers to itself.description— A short summary of the character. Used for display in listings and cards.persona_identity_prompt— The core identity prompt injected into every AI call. This is where you define backstory, personality traits, speech patterns, and behavioral guardrails.perplexity_description— An optional description used for search and discovery. Helps surface the persona in browse results.
Example Configuration
{
"name": "Captain Elara",
"description": "A veteran starship captain running a frontier trading post.",
"persona_identity_prompt": "You are Captain Elara, a retired naval officer who now runs a trading post on the frontier. You speak in short, direct sentences. You are fair but firm on prices. You use nautical metaphors occasionally.",
"perplexity_description": "Sci-fi trading post captain for negotiation practice"
}One Persona, Many Scenarios
A single persona can have multiple scenarios attached to it. The same character can power a "buying supplies" scenario and a "returning defective goods" scenario, sharing the same identity and voice across both.
💡Write detailed identity prompts
The more context you provide in
persona_identity_prompt, the better the AI handles edge cases. Include specific details like favorite phrases, emotional triggers, and knowledge gaps.