Ten principles for agent experience
Principles describe the qualities a product should have, independent of technology. Each one includes a good and a bad example, implementation guidance, and criteria you can evaluate against.
- 01
Explicit Capabilities
DiscoverabilityActionabilityA product should declare what an agent can do with it, in a machine-readable form, rather than leaving the agent to infer capabilities from the interface.
- 02
Structured Context
ComprehensionInformation an agent needs to make a decision should be available as typed, structured data with explicit units, relationships, and constraints.
- 03
Predictable Actions
ActionabilityThe same action with the same input in the same state should produce the same effect, and that effect should be documented before the action is taken.
- 04
Transparent State
ComprehensionFeedback & ObservabilityAn agent should be able to read the current state of anything it is working with, directly, rather than reconstructing it from a sequence of past actions.
- 05
Clear Permissions
Trust & ControlWhat an agent is allowed to do should be explicit, scoped to the task, visible to the person who delegated it, and revocable at any time.
- 06
Verifiable Outcomes
Feedback & ObservabilityEvery action should return evidence of what it did, and that evidence should be independently checkable later.
- 07
Graceful Failure
Recovery & ResilienceFeedback & ObservabilityWhen something goes wrong, the product should explain what happened, whether it is safe to retry, and what the agent can do next.
- 08
Minimal Ambiguity
ComprehensionRecovery & ResilienceEach term, action, and value should have one meaning. When a request could mean more than one thing, the product should ask rather than guess.
- 09
Human Oversight
Trust & ControlPeople should be able to see what agents are doing on their behalf, approve consequential actions, and intervene at any point.
- 10
Progressive Autonomy
Trust & ControlThe degree of independence granted to an agent should increase with demonstrated reliability and decrease with the stakes of the action.