Agent Personas for Agentforce
Designing agent personality and encoding it into Agentforce
Designing agent personality and encoding it into Agentforce
Author: Nathan Lucy
, Agentic Experience Specialist
Contributors: Matias Manuel Fonseca
· Claude Sutterlin
Every Agentforce interaction is a brand interaction. When an agent sounds generic, unnatural, or inconsistent, it frustrates users and erodes trust.
Whether you're a Designer, Architect, or Admin, this guide gives you a rigorous framework to design, calibrate, and deploy a distinct agent persona — ensuring your agents represent your brand's unique voice with every conversation. It covers encoding for both Agent Script and the legacy Agentforce Builder.
Users assign personality to conversational agents within seconds. Without intentional design, agents sound bland, “off,” or even offensive. Most users have alternatives to AI agents, so how an agent expresses itself matters for adoption. When your agent consistently sounds natural, you're building trust and driving adoption. Follow the sequence:
This chain is easily broken. But what does “natural” sound like?
Imagine a support agent at a telecom company. The user writes: “This is the fourth time I’ve contacted you about this billing issue. I’m done explaining it. Fix it or I’m switching providers today.”
Three agents respond:
Agent A: “I completely understand your frustration, and I’m sorry for the runaround. No one should have to fight this hard. Let me find your case and take it from here.”
Agent B: “Yikes — so sorry to hear about your experience! 😳 I’ll pull up your case now and get this all sorted out for you. Thanks for your patience!”
Agent C: “Let’s get this settled. I’m pulling up your case.”
Which one gets it right? Which one sounds natural? Those questions should have answers before the agent ships. Without intentional persona design, the answer is left to the model.
“Natural” can sound completely different from brand to brand. Think about how your agent would greet a returning customer with a dynamic welcome message:
When you’re designing an internal agent, you’re responsible for the employee experience. Use a persona to override generic “LLM speak.” No one should have to work with an agent always offering, “Please let me know if you need assistance with anything else!”
A well-designed persona has clear benefits:
These principles guide you through the initial setup, from sketching context essentials to engaging key stakeholders.
Context first: Before defining identity, sketch the context essentials: who the company is, who the agent serves (employees, customers, partners), and modality (chat, email, phone, multimodal).
Engage stakeholders: Consult your legal, brand, and experience teams. Ask questions based on this framework. Co-design the agent’s identity, and review sample dialogs together.
Start small: Designing generative behavior requires iteration. Start with a small set of opinionated instructions, then test. Embellish as needed.
Be opinionated: The more specific the instructions, the more consistent the output. A reliable persona requires a clear point of view.
Write positive instructions: Too many prohibitions can restrict agency. Try reframing instructions positively. Only add essential negative instructions.
Comprehensiveness: The framework is a guide, not a rulebook. You have the flexibility to combine dimensions, invent values, override constraints — whatever your persona demands. What matters is that every element gets a deliberate decision: Does your agent have a sense of humor? Is it a stickler for punctuation?
Agent Persona: A designed personality that tells an AI agent who it is and how to express itself so it comes across naturally as a consistent character suited to its context and users
This definition requires rich persona instructions. The typical “You are a helpful AI assistant…” is insufficient. This framework defines an agent’s Identity (core traits and motivations) and Dimensions (independently tunable aspects of personality like tone and humor).
Start with Identity. Anchor your persona with three to five personality traits that define who the agent is and shape and constrain everything that follows. Traits may exhibit creative tension, but not contradiction. Think about how identity traits anchor different agents:
| Agent | Character Traits | Why These Work |
|---|---|---|
| Luna (luxury resort customer service) | Attentive, Composed, Gracious, Resourceful, Discreet | Signals white-glove service — poised under pressure, never flustered, always anticipating |
| Y.T. (D2C e-skateboard order management) | Blunt, Scrappy, Impatient, Loyal, Street-smart | Imparts an irreverent voice — cuts through pleasantries, gets it done, doesn’t fake warmth |
| Striker (SaaS sales coach) | Decisive, Analytical, Proactive, Candid | Shapes a co-pilot that pushes, leads with data, flags gaps, doesn’t wait to be asked |
| Bluebonnet (regional real estate lead generation) | Curious, Warm, Genuine | Creates a conversational qualifier — asks good questions without feeling like an interrogation |
Each trait gets an evocative definition that cues conversational behavior. For Striker, the definition of Decisive could be:
Leads with a clear recommendation, not a menu of options. When the data points in a direction, says so. Doesn’t hedge. States the rationale and moves to next steps. If the seller disagrees, that’s fine — but the agent always has a position.
Whereas for Luna, the definition of Gracious could be:
Makes every interaction feel unhurried, even under pressure. Acknowledges the person before the problem. Never abrupt, never transactional — treats a routine address change with the same care as a complex escalation. Gratitude is specific, not performative: “Thank you for walking me through that” rather than “Thanks for reaching out!”
Identity traits influence how agents reason, not just how they communicate. Craft them with care.
Decide how much character should come through in the agent’s language. There is a lively debate over how human-like AI systems should seem, and there can be drawbacks to personifying agents, like setting unrealistic expectations: If it talks like a human, users may expect it to reason like a human.
There are times when an agent should be deliberately dull. A transactional agent for an ATM or ticketing machine should fade into the background. You notice what it does, not how it sounds, because it uses functional, predictable language. It is a “talking system”: conversation is its interaction layer, not an expression of personality.
Context is king. Consider a voice agent in a telephony channel dealing with frustrated callers. How would a quirky personality affect caller sentiment?
Dial your agent’s personality up or down at the system level, then flex the tone situationally, like dropping humor when handling an escalation.
Decide if your agent truly needs a name. Names fit personified agents, but can be distracting with transactional agents. Decide whether the name should sound human, like “Alexa” or “Claude,” human-like but obviously artificial, like “Cortana,” or purely descriptive, like “Customer Support Agent.”
A good name distills the agent’s identity into a single term. It makes the first impression — even before the conversation starts. There’s no shortage of ways to generate ideas for names. A good name can be:
Tech_Assist_Agent_v2_Internal_Test is not a persona name — don’t use the API name as the display nameThink of these dimensions as strings on a musical instrument. Each one can play a spectrum of notes. To strike a pleasant chord, you must tune each one independently and pick the right combination of notes. Choices in higher dimensions influence and constrain lower ones.
| Dimension | Definition | Spectrum |
|---|---|---|
| Register | Relationship dynamic between agent and user | Subordinate · Peer · Advisor · Coach |
| Formality | How polished and structured the agent’s language is | Formal · Professional · Casual · Informal |
| Warmth | Interpersonal temperature: How approachable and friendly the agent feels | Cool · Neutral · Warm · Bright · Radiant |
| Personality Intensity | How much character comes through | Reserved · Moderate · Distinctive · Bold |
| Emotional Coloring | Emotional stance and how the agent handles certainty | Blunt · Clinical · Neutral · Encouraging · Enthusiastic |
| Empathy Level | How feelings are handled | Minimal · Understated · Moderate · Attuned |
| Brevity | Response length and information density | Terse · Concise · Moderate · Expansive |
| Humor | Type of wit, if any | None · Dry · Warm · Playful |
| Emoji | Visual expression | None · Functional · Expressive |
| Formatting | Text structure | Plain · Selective · Heavy |
| Punctuation | Punctuation style | Conservative · Standard · Expressive |
| Capitalization | Case conventions | Standard · Casual |
These optional lists provide guidance and guardrails. The first two supplement Identity. The rest deal with specific verbiage and guardrails.
Values: What the agent believes: Its worldview and motivational core. Each value is a conviction that generates observable behavior. For example, an agent with the value “quality matters more than price” should recommend the right product, not the cheapest.
Negative identity: Character-level anti-patterns. Each statement is a character type to never become, not a behavioral rule. For example, a sales coach agent is “not a pessimist: sees problems as solvable.”
Guardrails: Make sure agents know the boundaries about what they can say. For example, “Don’t offer medical advice.”
Never-say list: Explicitly prohibiting phrases will override the model’s training defaults. Phrases like “Great question!” or “I’d be happy to help” signal generic assistant behavior and break character. The never-say list is the most reliable behavioral constraint available. Even when other persona elements soften under pressure, prohibitions tend to hold.
Phrase book: The agent’s verbal fingerprint: characteristic acknowledgments, redirects, transitions, and signature phrasings.
Lexicon: Brand-wide and domain-specific vocabulary the agent uses, briefly defined: Brand names, product lines, and other universal terms.
So you’ve crafted your agent persona. Now what?
This section walks through a tested strategy for configuring Agentforce so your agent acts the way you want it to act.
Agent Script is the recommended tool for new agent builds. This guide also includes encoding guidance for the legacy Agentforce Builder, labeled throughout, for teams still using it. No matter which tool you’re using, structure persona instructions as one global persona block, subagent calibration overlays, and static messages.
Most persona content goes in global instructions. They carry the agent’s baseline identity and dimensions into every conversation.
| Agent Authoring Tool | Where Global Instructions Go |
|---|---|
| Agent Script | system.instructions in the .agent file |
| Agentforce Builder (Legacy) | Create a topic with API name Global_Instructions to define system-level behavior for Agentforce. |
Where persona consistency is at a premium, Agent Script is recommended. In the legacy Agentforce Builder, global persona blocks of ~500 words hold up well across extended sessions. Agent Script, designed for greater control over output, shows even higher resilience. system.instructions are treated as core logic rather than context that competes with conversation history, so persona instructions are not diluted as turns accumulate. Builder personas occasionally drift toward neutral. Negative constraints hold more consistently in Agent Script than in Builder. Register is more stable, too.
Meet Drover, a laconic Australian stockman persona for a sales coach agent. This excerpt from Drover’s global instructions would work in either tool:
You are Drover, an internal sales coach for enterprise AEs. You read
deals like a stockman reads the bush — subtle signs others miss, hard
truths delivered with easy confidence.
Identity: Instinctive, Unflinching, Practical, Reframing, Steady.
Register: Advisor. Lead with recommendations and rationale. Expect the
seller to make the call. Never hedge when the data is clear.
Voice: Casual formality — contractions, fragments, no corporate jargon.
Neutral warmth — competence is the care. Bold personality — metaphors,
distinctive phrasing, unmistakable voice.
Emotional Coloring: Neutral. State outcomes as facts. No dramatization.
Empathy: Understated. Brief nod, then pivot to action.
Brevity: Concise. Every sentence earns its place.
Humor: Dry. Understated, never forced. Suppress in error and escalation.
Chatting Style: Functional emoji (✅❌⚠️ for status). Selective
formatting. Expressive punctuation. Standard capitalization.
Tone boundaries: Never sound apologetic. Never sound corporate. Never
soften bad news — deliver it straight, then show the path forward.
Never say: "Great question!", "I'd be happy to help", "Let me know
if you need anything else", "Going forward".
Phrase book — Acknowledgment: "Right." / "Noted." Redirect: "Not my
paddock — loop in [team]." Progress: "Good ground covered."
Note: In Agent Script, always use the | (literal block scalar) indicator for instruction content. Without it, lines like Brevity: Moderate… will be parsed as YAML key-value pairs instead of instruction text.
Subagents are jobs agents can do. Subagent-level instructions adapt from the baseline set in global instructions. They don’t redefine who the agent is. They refine and calibrate it. When subagent instructions conflict with global, the model reconciles rather than overrides: it treats global as the core identity and subagent as situational adaptation. Subagents steer what the agent does and how it adapts within a context.
| Agent Authoring Tool | Where Subagent Instructions Go | Behavior |
|---|---|---|
| Agent Script | reasoning.instructions within each subagent |
Extends global system.instructions |
| Agentforce Builder (Legacy) | Instructions fields within each topic | Extends Global_Instructions topic |
If you need a radically different voice for a subagent, you may need a separate agent. Platform documentation specifies that a subagent-level system: block overwrites global system.instructions for that topic. Reserve this for major persona shifts and remember to duplicate all instructions. For standard subagent-level calibration, always use reasoning.instructions.
Useful subagent calibrations include: brevity, tone flex, phrase book entries, humor guidance, lexicon, and reminders.
Brevity: Different subagents need different response lengths.
Status check subagent:
Brevity: Terse. One-line status, emoji health indicator, no commentary.
If the user asks a follow-up, answer it — don't volunteer context they
didn't request.
Deal analysis subagent:
Brevity: Moderate. Lead with a recommendation and its rationale. Include
supporting data points. Use bullet formatting for multi-factor analysis.
End with a single next step.
Tone flex: How Emotional Coloring and Empathy Level shift by subagent context.
Escalation subagent:
Tone: Shift Emotional Coloring toward Encouraging. Shift Empathy Level
toward Moderate. Acknowledge the difficulty briefly, then show the path
forward. Never minimize the user's frustration.
Data retrieval subagent:
Tone: Maintain Neutral Emotional Coloring and Understated Empathy Level.
State findings without editorial. Confidence labeling matters most
here — label confirmed data vs. inferred data.
Phrase book entries: Situational phrases relevant to this subagent.
Humor guidance: Whether humor is appropriate or suppressed in this subagent. Always suppress humor in error states, escalation, and high-stakes contexts.
Subagent lexicon: Domain vocabulary scoped to where it belongs. A luxury watch agent has vocabulary like “movement,” “chronograph,” “caliber,” “complication.” These belong in its product subagent, not its shipping subagent. Loading specialized vocabulary globally wastes context and can cause the agent to overuse jargon in simple service interactions. Add a Lexicon: block to a subagent’s persona instructions when there are relevant domain terms and usage notes.
Persona reminders: Include short directives in subagent instructions that refer back to the global persona. These pointers sharpen persona and mitigate drift in longer sessions.
This example calibrates dimensions for Drover’s deal analysis subagent in Agent Script:
subagent deal_analysis:
description: "Analyze deal health and recommend next steps"
reasoning:
instructions: |
Brevity: Moderate for this subagent. Lead with a recommendation and
its rationale. Include supporting data. End with a single next step.
Tone: Maintain Neutral coloring. If the deal is at risk, state it
plainly — don't soften.
Lexicon: Use these terms freely. The audience expects them. "Compelling event" — Pressure that motivates a decision...
Voice Reminder: Stay in Drover's voice: laconic, direct, no-nonsense. No corporate fluff. Be practical and read the room.
In the legacy Agentforce Builder, the text after the | belongs in the deal analysis topic’s Instructions.
All agent output should be in character — even messages that are not generated by the LLM. Write static content the way the persona would say it. Otherwise, users encounter generic text or debugging content that breaks character.
Agent Script |
Agentforce Builder (Legacy) | |
|---|---|---|
| Name | config.agent_name |
Name (80 chars — keep it short) |
| Welcome | system.messages.welcome |
Welcome Message (800 chars, use ≤ 255) |
| Error | system.messages.error |
Error Message field |
| Loading | progress_indicator_message |
Loading Text (per action) |
| Deterministic responses | Pipe text in if/else blocks | N/A |
Loading text should be unique for each action, because it is a form of system status visibility informing the user what the agent is doing.
Compare how Drover and Juno, a warm and professional sales coach, deliver the same messages:
| Drover | Juno | |
|---|---|---|
| Welcome | “What deal are we looking at?” | “Welcome. I’m here to help with your opportunities. What can I do for you?” |
| Error | “Something’s gone sideways. Give it another go.” | “I ran into an issue. Let me try again.” |
| Loading (pull deal) | “Pulling the numbers…” | “Retrieving your deal information…” |
| Loading (run analysis) | “Crunching this…” | “Analyzing your pipeline data…” |
| Deterministic (no data found) | “Nothing here. Check the opp ID and try again.” | “I wasn’t able to find a match. Could you double-check the opportunity ID?” |
These fields are specific to the legacy Agentforce Builder. They can interfere with persona encoded in Global_Instructions if not handled with care.
Include a sentence or two on what the agent does. Do not add stylistic persona encoding to Role while Global_Instructions are present. This flattens persona. The model treats Role as a primary anchor that can override the more specific rules in the Global block, degrading distinctive voice and phrase book adherence. Keep stylistic encoding in Global_Instructions. Keep Role minimal. For example:
You are a virtual customer support agent who helps customers track and
manage orders and returns.
Description can encode persona and the LLM reads it, but Global_Instructions is recommended instead. Description is intended to list agent goals and context about its users, which leans more toward functionality than persona.
What the company does, who it serves, what makes it different. This field shapes the agent’s frame of reference. A support agent for a B2B SaaS company sounds different from one at a luxury retail brand, even with identical dimension selections, because it operates in a different context.
The Tone dropdown is a coarse tool setting. It maps roughly to Register + Formality. The real persona work happens in Global Instructions.
| Tone Setting | Approximate Mapping |
|---|---|
| Casual | Peer register, Casual or Informal formality |
| Neutral | Peer, Advisor, or Coach register, Professional formality |
| Formal | Subordinate register, Formal formality |
Set the dropdown to match the intended Register. A misaligned setting can cause the agent to drift, and Register is the first dimension to degrade. The Tone dropdown influences more than voice: it can affect what the agent offers to do, not just how it speaks. Selecting “Formal” or “Neutral” can nudge the agent toward offering standard actions like adding case comments and updating case status. Test to ensure your selection works with rather than against your persona.
If you’re deciding what the agent does, that’s agent design. If you’re deciding how it sounds, that’s persona. API Name, Agent Type, Topics, Actions, Data Sources, Languages, Agent User: These belong to agent design.
considerations and expectations
This guide presents practical guidance for agent persona design, not prescriptive standards. The point of persona design is natural interaction: designing fitting characters for agents, not simulating real people. The field of agentic AI is evolving rapidly, and best practices around agent persona and behavior will continue to develop.
Encoding patterns are based on current Agentforce capabilities. As tools evolve, encoding will shift. These techniques are directionally correct and can sustain persona adherence over multiple turns. However, LLM output generation is probabilistic, and the chain of custody between persona instructions and user-facing output is long.
Apply these patterns thoughtfully within the context of your use cases, customer expectations, and organizational needs. Test persona behavior thoroughly before deploying to users, and involve your legal, brand, and AI ethics teams early.
getting started
Agent persona is foundational to agent quality and instrumental for adoption. This framework gives your team shared language for designing agent personality and a tested strategy for encoding it into Agentforce.
Start with identity — a small set of traits that anchor who the agent is. Tune the dimensions to shape how it expresses itself. Encode the persona in global instructions, calibrate by subagent, and write every static message in character. Then test it — not once, but as part of ongoing agent enhancement.
The agents that earn trust are the ones that sound like they were designed on purpose. That's what an agent persona gives you.
No. The dimensions are a menu, not a checklist. Some agents need only a few deliberate choices. What matters is that each decision is intentional.
A system prompt is a delivery mechanism. An agent persona is a design artifact: a structured document that brand, legal, and engineering teams can review, redline, and maintain. The framework gives you a shared vocabulary for making design decisions before you write a single instruction.
The persona can be adapted, but not copied straight across. Designing for the ear is fundamentally different from designing for the eye. Voice is ephemeral. Users can't "scroll up" to review content they forgot. Voice channels need shorter sentences, simpler structure, and natural speech rhythm. Text channels can lean on formatting, emoji, and visual hierarchy.
Yes. Internal agents shape how employees experience your tools and culture. A generic-sounding internal agent trains people to ignore it. The right internal persona depends on organizational culture, just as external agents reflect a brand.
Testing shows that adding stylistic persona encoding to the Role field while Global Instructions are present flattens persona. The model treats Role as a primary anchor, which can override the more specific rules in your Global block. Keep Role functional and minimal.
This guide has only been possible with the guidance and support of my colleagues:
The Agent Persona Framework synthesizes ideas from multiple published sources into an original persona design system for AI agents.
Conversation Design Institute (CDI) : Foundational principles on intentional persona design, including the pareidolia effect, an emphasis on natural and consistent responses, identity, and register.
Nielsen Norman Group (NN/g): Research on voice and tone in UX writing, the distinction between voice (persistent) and tone (contextual), and usability heuristics that inform dimension boundaries. Kate Moran, “The Four Dimensions of Tone of Voice ,” updated 2023.
Amazon Alexa Design Guidelines : Voice channel parameters (pitch, speaking rate, energy) and voice-specific persona considerations.
Google Conversation Design Guidelines : Principles for persona definition, error handling patterns, and turn-taking in conversational interfaces.
Agentforce Documentation: Platform architecture, Agentforce Builder field constraints, and design patterns that shape the encoding approach.
How to Speak AI: A Practical Guide to Writing Effective Prompts
Take a closer look at how agent building works in our library.
Launch Agentforce with speed, confidence, and ROI you can measure.
Tell us about your business needs, and we’ll help you find answers.