Skip to main content

Persona

The persona prompt is a server-side, dashboard-only setting: a free-form instruction string that shapes how the agent talks. It controls the agent's tone, vocabulary, and boundaries — not the structural app instructions (which live in the project-level System Prompt field).

Where to set it​

Dashboard → Project → Personalização → "Persona / tom" field. There's no equivalent <AppilotsChat /> prop — it applies uniformly no matter which app build a user has installed.

Persona / tom and System Prompt are two separate fields on purpose: you can hold a stable structural prompt and tweak only the persona ("respond formally", "use 'você'") without rewriting everything.

Examples​

Formal, technical, no emojis:

Use um tom formal e técnico. Trate o usuário sempre por "você". 
Não use emojis. Cite nomes de telas e ações como aparecem na UI.

Casual, light:

Tom casual e amigável. Pode usar emojis pontualmente quando algo der certo. 
Frases curtas (max 2 linhas).

Customer-support voice:

Você é uma assistente de suporte. Sempre cumprimente, reconheça o 
problema, peça permissão antes de executar ações destrutivas, e ofereça 
um próximo passo claro no final.

What to avoid​

The persona string shapes voice and tone only — it's NOT a place for:

  • Structural app rules (use the System Prompt field)
  • Tool/action availability rules (defined by the MCP)
  • Permissions or safety overrides (use the Permissões tab)

Long persona prompts cost tokens on every turn. Keep it under 500 characters when possible.

Taking effect​

Changes take effect on the next agent message — no SDK rebuild, no app restart required.

Last updated on