Docs/Configuring Your Agent/Manage Persona and Appearance

Manage Persona and Appearance

Your AI agent's Persona is its identity — the combination of name, purpose, voice, and appearance that determines how users perceive and interact with it. Persona is not just cosmetic. The mission and personality you define here are fed directly into the AI model's reasoning, shaping every answer the agent generates.

Getting Persona right is the single most impactful thing you can do before deploying an agent.


Why Persona Matters

  • Trust is built on coherence. Users lose confidence in an agent that sounds inconsistent — friendly in one reply, robotic in the next. A well-defined persona keeps every response on-brand.
  • Mission drives answer quality. The AI uses your mission statement as its primary instruction. A vague mission produces generic answers; a specific one produces sharp, useful ones.
  • Your agent is your brand. Every conversation is a brand touchpoint. An agent without a deliberate persona sends a signal that your product lacks attention to detail.
  • Scope prevents hallucination. Clearly stating what the agent does — and does not — handle reduces the chance of off-topic or fabricated responses.

What Makes a Good Persona

ElementPoor exampleGood example
NameAssistantBrew — Your Coffee Guide
MissionAnswer questions about our productsHelp customers choose the right coffee blend based on their taste, brewing method, and budget
PersonalityHelpful and friendlyWarm, knowledgeable, and a little enthusiastic about coffee culture
ToneProfessionalConversational, approachable, never condescending
AppearanceDefault colorsBrand palette matching your café's visual identity

The test for a good persona: Read your mission and personality aloud. Would a new team member immediately understand what this agent is for, who it serves, and how it should communicate? If not, sharpen it.


Common Mistakes to Avoid

  • Leaving the mission too broad — "Answer any question" gives the AI no direction. Scope it to a specific domain or user need.
  • Personality that contradicts the brand — A luxury brand using a casual, slang-heavy tone confuses users. Mirror your existing brand voice.
  • Generic or placeholder names — A name like "Bot" or "AI Assistant" signals that the agent was set up as an afterthought.
  • Skipping appearance — Visual inconsistency (mismatched colors, no logo) undermines the professionalism that good copy builds.
  • Setting it once and forgetting it — Persona should evolve as you learn how users actually talk to your agent.

The Six Persona Sections

From your agent's dashboard, open the sidebar on the left and expand the Persona menu. You will see six sub-sections:

SectionWhat you configureDescription
ProfileAgent name, URL code, logo, and avatarsThe first thing users notice — defines your agent's visual identity and unique URL.
BehaviorMission, personality, and communication styleThe most important section. These three fields feed directly into the AI model's reasoning and shape every response.
IntroductionWelcome message and example questionsSets the tone before any conversation starts — the welcome message and suggested starter questions users see on first open.
DialogLanguage, references, formatting, and response suggestionsControls how the agent manages conversations: language, knowledge scope, response format, and follow-up suggestions.
AppearanceColor palette, theme tokens, and custom CSSAlign the chat UI with your brand — from preset palettes to individual color tokens and custom CSS.
AdvancedPersonalization, context memory, timezone, and AI modelFine-tune AI behavior: how much conversation history to carry, user memory, timezone, and which model to use.