Patterns library
Reusable solutions to recurring agent problems
Each pattern names a problem agents commonly hit, the context in which it applies, and a recommended solution, with an interaction diagram and example implementation.
AX proposal15 patterns across 5 categories
15 of 15
Discovery
Helping agents find what a product offers.
- Capability ManifestPublish a single machine-readable document that lists what agents can do with your product.
- Action DiscoveryExpose the actions available on a resource in its current state, alongside the resource itself.
- Resource DescriptionDescribe each important resource with typed fields, stable identifiers, and explicit units.
Interaction
Structuring how agents perform work.
- Structured ActionsDefine each action as a contract with a name, typed input, preconditions, effects, and result.
- Multi-step WorkflowsModel long tasks as named workflows with explicit steps, persistent state, and resumable progress.
- State TransitionsPublish the state machine for important resources so agents know which changes are legal.
Trust
Scoping authority and keeping people in control.
- Permission RequestsLet agents request exactly the scopes a task needs, and let people grant, inspect, and revoke them.
- Human ApprovalPause consequential actions until a person confirms, with a self-contained summary of what will happen.
- Sensitive ActionsLabel actions by risk so agents and policies can treat them differently before anything happens.
Feedback
Reporting outcomes agents can verify.
Recovery
Handling failure without losing progress.