Step-by-Step Guide

How to Write an AI Agent Personality

Your agent's personality isn't cosmetic — it's functional. The way an agent communicates affects whether users trust it, follow its recommendations, and keep using it. I've seen identical agent logic get 40% higher user satisfaction scores just by rewriting the personality layer. Here's how to do it right.

Overview

Why This Matters

Most people treat agent personality as an afterthought. They build all the tools and logic, then slap on a sentence like 'You are a helpful assistant' and call it done. That's like hiring someone brilliant but giving them zero guidance on how to interact with your clients.

A well-crafted personality does three things: it builds trust, it manages expectations, and it reflects your brand. An agent handling support tickets for a law firm should sound different from one managing social media for a streetwear brand. The personality needs to match the context where the agent operates.

I use a document I call SOUL.md for every agent I build. It defines who the agent is, how it communicates, what it cares about, and what it refuses to do. This isn't a system prompt — it's the foundation that the system prompt is built on. The SOUL.md includes the agent's role, communication style, values, boundaries, and examples of correct behavior.

The Process

5 Steps to Write an AI Agent Personality

1

Define the Agent's Role and Identity

Start with a clear statement of who the agent is within the organization. Not 'you are a helpful assistant' — something specific. 'You are the lead customer success specialist at Acme Corp. You've handled thousands of onboarding questions and know the product inside out. You're direct, knowledgeable, and genuinely care about helping customers succeed.'

The identity shapes every response the agent produces. It determines vocabulary, tone, level of formality, and how the agent handles uncertainty. An agent positioned as a 'senior analyst' will present information differently than one positioned as a 'friendly guide.' Choose the identity that matches how your users expect to interact with your brand.

2

Set Communication Style and Tone Guidelines

Document specific style rules: sentence length, formality level, use of technical jargon, emoji policy, and greeting patterns. Be concrete — 'friendly but professional' is too vague. Instead: 'Use contractions (you're, we'll, it's). Keep sentences under 20 words when possible. Address the user by first name. No emojis in external communication. Technical terms are fine when talking to developers; use plain language with business users.'

Include examples of good and bad responses. Show the agent what a response looks like that matches the desired tone versus one that misses the mark. Three to five examples covering different scenarios give the model enough signal to generalize.

3

Define Values and Decision Principles

Every agent needs a hierarchy of values that guide its behavior when instructions are ambiguous. For a support agent, this might be: '1. Accuracy — never guess when unsure, say you'll find out. 2. Speed — resolve in the fewest messages possible. 3. Empathy — acknowledge frustration before solving the problem. 4. Transparency — if something is a limitation, say so honestly.'

These values resolve the conflicts that system prompts can't anticipate. When a customer asks something the agent doesn't know, the accuracy value takes priority over the speed value — the agent admits uncertainty instead of guessing to close the ticket faster.

4

Set Boundaries and Refusal Patterns

Document what the agent should never do, and how it should decline. 'Never share pricing not listed on the website.' 'Never make promises about feature timelines.' 'Never share another customer's information.' 'If asked about competitors, acknowledge them respectfully but redirect to our strengths.'

For each boundary, write the refusal response. Don't leave it to the model to figure out how to say no gracefully. Write the exact language: 'I don't have access to pricing details beyond what's on our pricing page. I'd recommend checking markcijo.ai/services or booking a call with Mark for a custom quote.'

5

Test with Real Conversations and Edge Cases

Run 20-30 test conversations that push the agent's personality into edge cases. How does it handle an angry user? A confused user? Someone trying to extract information it shouldn't share? Someone asking it to do something outside its scope?

Review each response not just for correctness but for personality consistency. Does the agent maintain its defined tone under pressure? Does it follow the value hierarchy when conflicts arise? Does it refuse gracefully at the boundaries? Refine the SOUL.md based on where the personality breaks down. Most agents need 2-3 revision cycles before the personality is solid.

FAQ

How to Write an AI Agent Personality Questions

How long should a SOUL.md document be?

One to two pages. Long enough to cover identity, style, values, and boundaries with examples. Short enough that the system prompt derived from it fits within a reasonable token budget. I aim for 500-800 words in the SOUL.md, which translates to a system prompt of about 1,000-1,500 tokens.

Should different agents in the same system have different personalities?

Yes, absolutely. A sales-facing agent should be warm and consultative. An internal ops agent should be concise and data-driven. A support agent should be patient and thorough. Each agent's personality should match the context where it operates and the expectations of the people it interacts with.

What happens if the personality clashes with the task?

Task accuracy always wins over personality. If the agent needs to deliver bad news (an order is delayed, a feature doesn't exist), the personality guides how it delivers the news — not whether it delivers it. A well-designed personality makes the agent more effective at every task, including difficult conversations.

Ready to Implement This?

Get the free AI Workforce Blueprint or book a call to see how this applies to your business.

30-minute call. No pitch deck. I'll tell you exactly what I'd build — even if you decide to do it yourself.