What design rules improve AI agent usability in practice?
Salesforce's product team distilled five concrete guidelines from building its own Agentforce platform, covering naming, error handling, disclosure, and branding. These rules address real usability failures encountered during internal use.
Matthew Phillips, writing on Salesforce's blog, reports that Salesforce's internal product and UX teams codified lessons from building the company's own Agentforce platform — used internally as "customer zero" before being sold to customers — into an internal framework called the Agentic Interface Guidelines. The post lists five "actionable insights" from that framework: limit agent names to under 10 characters using a "Name + Agent" convention; use three heuristics — consistency, error tolerance, and teachability — to catch usability problems early; give every agent conversation a five-part structure (a welcome message, a disclosure statement, a list of example questions, clear scope boundaries, and a path to give feedback or escalate); always include AI disclosure language; and standardize visual branding, including voice and tone and agent avatars, so that "a consistent look signals to users: 'You're talking to an AI agent and here's what to expect.'"
The framework draws on existing resources rather than inventing fresh guidance — it borrows from Salesforce Lightning Design System 2's Agentic Experience Patterns, Salesforce's own branding and marketing style guides, and materials from Slack — and each tip is tied to a concrete failure the team hit while building Agentforce. Long or vague agent names, the post says, "broke layouts, cluttered dropdowns, and confused users," which produced the naming convention. Agents that "looked good on paper but confused real users" prompted the heuristic checks. And "a blank input field is intimidating" motivated the welcome-message-plus-example-questions structure. Phillips frames the disclosure requirement as a trust move rather than a compliance one: "AI isn't perfect, and users know it. But we still need to say it."
Set against How should AI systems be designed across different interaction phases?, Salesforce's framework covers similar ground — onboarding expectations, error recovery, consistency — but is narrower and more concrete, and it is validated only by Salesforce's own internal dogfooding rather than by the practitioner study behind Amershi's guidelines. It also overlaps with What UX principles do workplace users want in AI agents?: Salesforce's scope-boundary and disclosure tips read as a concrete implementation of that framework's context-awareness and safety principles for workplace-facing agents. And it offers a thinner version of the expectation-setting half of How can users verify what an AI agent actually plans to do? — a welcome message, scope boundaries, and example questions tell a user what an agent is supposed to do, but the framework as described stops at setting expectations up front and does not address verifying what the agent actually did.
The post is vendor content from Salesforce's own blog about its own Agentforce product, written by a member of its design team who writes "we" throughout; it reports no user study, no metrics, and no outside validation of the five tips beyond the anecdote that a reimagined Salesforce Help agent experience "launched it in five days" after one observed failure. The 10-character naming limit and the three named heuristics are stated as internal design conventions, not tested thresholds, so the specific figures should be read as Salesforce's own design-system defaults rather than general findings about agent usability.
Inquiring lines that read this note 1
This note is a source for these research framings, grouped by the broader line of inquiry each explores. Scan the bold lines of inquiry; follow any specific question forward.
How does interface design shape effectiveness in human-AI collaboration?Related concepts in this collection 3
This note in its neighbourhood — explore the map, then jump to a related concept in the list below.
Click a node to walk · click center to open · click Open in graph to see this note in the full knowledge graph
-
How can users verify what an AI agent actually plans to do?
Stating goals to an AI agent isn't enough for mutual understanding. What mechanisms would let users check both the agent's proposed plan and whether it truly grasps the user's goals and constraints?
Salesforce's welcome message/scope-boundary tips set expectations but stop short of the plan-verification this note calls for
-
How should AI systems be designed across different interaction phases?
Can a small set of general guidelines help practitioners design better AI-infused products across different moments—initial setup, active use, error handling, and long-term adaptation?
a narrower, internally-dogfooded counterpart to Amershi's academically validated guideline set
-
What UX principles do workplace users want in AI agents?
A multi-method study asked business users what design principles matter most for human-AI collaboration at work. The findings prioritize oversight and reliability over convenience.
Salesforce's disclosure and scope tips are a concrete instance of that framework's context-awareness and safety principles
Related papers in this collection 8
Papers most semantically related to this note, ranked by cosine similarity in the embedding space.
- Get 5 Insider Design Tips for Building Your AI Agents
- Design for agents
- A Framework of User Experience Principles for Human-AI Agent Interaction in the Workplace
- Design Principles for Human-Agent Interaction
- 2025 in Review: Design Gives AI Meaning
- Designing For Agentic AI: Practical UX Patterns For Control, Consent, And Accountability
- Mapping the Design Space of User Experience for Computer Use Agents
- Holistic Agent Leaderboard: The Missing Infrastructure for AI Agent Evaluation
Original note title
Salesforce's Agentic Interface Guidelines distill dogfooding into five tips on naming, heuristics, structure, disclosure, and branding