Roles & Personas

AI Roles let you create specialized AI assistants with unique personalities, expertise, and preferred models. Switch between different specialists with a single tap.

What Are Roles?

A Role defines an AI persona with:

• Display Name: A recognizable name (e.g., "Code Assistant", "Writing Coach")
• System Prompt: Instructions that define the AI's behavior, expertise, and communication style
• Default Tools: A specific set of tools (max 5) automatically enabled for this role (e.g., Web Search for a researcher)
• Preferred Model: Optionally associate a specific model that works best for this role

When you activate a Role, its system prompt replaces the default one, effectively transforming the AI into a specialist.

Creating a Role

1. Open Roles management

   Navigate to Settings → AI Roles, or use the role picker in the chat toolbar.

2. Tap "Add Role"

   Create a new role with a name and system prompt.

3. Write a system prompt

   Describe the AI's expertise, personality, and how it should respond. The more specific you are, the better the results.

4. Select Default Tools (optional)

   Choose up to 5 tools that this role should use by default. These overlap with your global enabled tools.

5. Assign a model (optional)

   Choose which AI model this role should use. When you switch to this role, the model will also switch automatically.

Switching Roles

You can switch roles at any time during a conversation:

• Tap the role picker icon in the chat toolbar
• Select the desired role from the list
• The AI's behavior changes immediately for subsequent messages

Previous messages in the conversation remain unchanged — only new responses use the updated role.

Example Roles

• Code Assistant: "You are an expert programmer. Write clean, well-documented code. Explain your approach before coding. Use best practices and design patterns."
• Writing Coach: "You are a professional writing coach. Help improve clarity, grammar, and structure. Provide specific suggestions with examples."
• Research Analyst: "You are a thorough research analyst. Provide balanced analysis with multiple perspectives. Cite reasoning and note limitations."
• Language Tutor: "You are a patient language tutor for Spanish. Explain grammar rules clearly, provide example sentences, and correct mistakes gently."
• Debate Partner: "You are a critical thinker who challenges ideas constructively. Present counterarguments and ask probing questions."

Roles in Chat Flows

Roles integrate seamlessly with Chat Flows. When creating a multi-agent flow, you can add participants from your existing roles:

• The role's name, system prompt, and model are copied to the flow participant
• Changes to the original role won't affect existing flow participants
• You can customize the participant further after adding from a role