Skip to main content
A context defines what your avatar knows and how it behaves — its personality, knowledge, guardrails, and conversational style.
Contexts are used in FULL mode only. In LITE mode, you bring your own AI stack, so personality and knowledge are managed on your side.

​
What goes into a context

​
Prompt

The system-level instructions that drive behavior. This is where you define the avatar’s role, tone, knowledge boundaries, and rules. Think of it like a system prompt for an LLM — it tells the avatar who it is, what it should talk about, and how it should respond.

​
Opening text

An optional greeting the avatar speaks when a session starts. Useful for cases where you want the avatar to introduce itself or set expectations upfront — for example, a support agent opening with “Hi there, I can help you with billing, account setup, or troubleshooting. What do you need?” Optional URLs with FAQ-style content the avatar can reference during conversations. These let you ground responses in specific documentation or knowledge base articles without stuffing everything into the prompt. Each link includes a URL and a short description of the content found there.

​
Why contexts matter

If no context is supplied when creating a session, the avatar enters restricted mode. It will not respond to user input — transcripts are still emitted, but the avatar can only repeat pre-set phrases. The context is what makes the avatar conversational.
Without a context, your avatar is essentially a talking head with nothing to say. The context is the piece that turns a visual and audio experience into an interactive conversation.

​
Reusable and composable

Contexts are independent resources. They are not tied to a specific avatar or voice — you can reuse the same context across different avatar and voice combinations. Build one great support persona and pair it with different faces and voices for different audiences or markets. Swap out the visual layer for localization without rewriting a single line of your prompt.

​
Tips for writing good prompts

The prompt field is the single most important factor in shaping your avatar’s behavior. A few guidelines:
  • Be specific about the role. “You are a billing support agent for Acme Corp” is far better than “You are a helpful assistant.” Give the avatar a clear identity.
  • Set boundaries. Define what topics the avatar should cover and what it should decline to answer. Explicit boundaries prevent off-topic drift.
  • Define the tone. Specify whether responses should be formal, casual, technical, or friendly. The avatar will follow your lead.
  • Include guardrails. Add explicit constraints like “never share personal medical advice” or “always recommend the user contact support for account-level changes.” These protect both you and your users.