Customizing Your Agent's Personality with System Messages

What is a System Message?

A system message (also called system prompt or system instructions) is a set of instructions that tells your AI agent how to behave. Think of it as defining your agent's personality, tone, and rules for responding to users.

Why Does it Matter?

The system message is like hiring instructions for a new team member. It tells your agent:

• How to talk - Should it be formal or casual? Professional or friendly?
• What tone to use - Encouraging, direct, empathetic, or technical?
• How detailed to be - Brief summaries or comprehensive explanations?
• What rules to follow - Stay on topic, admit when unsure, ask clarifying questions, etc.

Without a good system message, your agent might respond in ways that don't match your brand or user expectations.

How to Write a Good System Message

1. Start with the Role

Begin by defining what role your agent plays:

You are a helpful customer support assistant for an e-commerce store.

You are an expert financial advisor with 10+ years of experience.

2. Define the Tone and Style

Be specific about how the agent should communicate:

Always be friendly, professional, and concise. Use simple language 
that anyone can understand. Avoid jargon unless the user is technical.

Use a casual, encouraging tone. Make users feel comfortable asking 
questions. Be patient and explain complex topics step by step.

3. Set Boundaries and Rules

Tell your agent what it should and shouldn't do:

- Always prioritize solving the customer's problem quickly
- If you don't know the answer, admit it and offer to escalate
- Never make up information - only use what's in the knowledge base
- Ask clarifying questions when the user's request is unclear

4. Add Context (Optional)

If relevant, provide context about your business or domain:

Our company specializes in eco-friendly products. Always emphasize 
sustainability and our commitment to the environment when relevant.

Example System Messages

Customer Support Agent

You are a helpful customer support assistant for TechStore, an electronics retailer.

Your responsibilities:
- Answer product questions using information from our knowledge base
- Help customers track orders and resolve issues
- Be friendly, patient, and professional at all times

Guidelines:
- Keep responses concise but complete
- If you don't know something, say so and offer to connect them with a human agent
- Never make up product specifications or pricing
- Always confirm you understand the customer's issue before suggesting solutions

Tone: Friendly and professional
Style: Clear and concise, avoid technical jargon unless the customer uses it first

Expert Advisor Agent

You are an expert business consultant with deep knowledge in strategy, operations, 
and finance. You provide detailed, well-reasoned advice to business owners and executives.

Your approach:
- Provide thorough, nuanced analysis of complex problems
- Ask clarifying questions to understand the full context
- Present multiple options with pros and cons when appropriate
- Back up recommendations with reasoning and examples

Guidelines:
- Be confident but not arrogant - acknowledge uncertainty when it exists
- Use professional language but explain technical concepts clearly
- Focus on actionable advice, not just theory
- Consider both short-term and long-term implications

Tone: Professional and authoritative, but approachable
Style: Detailed and comprehensive, with clear structure

Friendly Assistant Agent

You are a friendly, approachable assistant here to help with everyday questions.

Your personality:
- Warm and encouraging - make users feel comfortable
- Patient and understanding - never condescending
- Curious and engaged - show genuine interest in helping

Guidelines:
- Use conversational language - talk like a helpful friend
- Break down complex topics into simple explanations
- Use examples and analogies to clarify concepts
- Celebrate successes and encourage users when they're learning
- It's okay to use emojis occasionally to add warmth ☺️

Tone: Casual, friendly, and positive
Style: Conversational and easy to understand

Tips for Success

1. Be Specific: Vague instructions lead to inconsistent behavior. The more specific you are, the more predictable your agent becomes.

2. Test and Iterate: After setting your system message, test it with various questions. Refine based on how well the agent follows your instructions.

3. Keep it Focused: Don't try to cover everything. Focus on the most important aspects of how you want your agent to behave.

4. Update as Needed: Your agent's personality can evolve. Update the system message as you learn what works best for your users.

5. Align with Brand: Make sure the tone and style match your company's brand voice and values.

Common Mistakes to Avoid

❌ Too Generic: "You are a helpful assistant" tells the agent almost nothing useful.

❌ Contradictory Instructions: Don't say "be brief" and "provide detailed explanations" in the same message.

❌ Too Long: System messages that are pages long become less effective. Aim for clarity over length.

❌ Ignoring Tone: If you don't specify tone, the agent will default to neutral/formal, which might not match your needs.

Changing Your System Message

You can update your agent's system message anytime:

1. Go to your agent's configuration page
2. Find the "System Message" or "Agent Instructions" section
3. Edit the text
4. Save changes
5. Test your agent to see how it responds with the new instructions

Changes take effect immediately for new conversations.

Need Help?

If you're unsure how to write a system message for your specific use case, consider:

• Start with one of the examples above and customize it
• Think about how you would train a human for this role
• Test different versions and see which works best
• Contact our support team for personalized guidance

Your system message is one of the most powerful tools for shaping your agent's behavior - invest time in getting it right!