Onboarding and Capability Discovery Framework - forming accurate mental models of agent capability
Back to Practice

Framework 11 of 12 · Entry Phase · Mental model formation

Onboarding & Capability Discovery Framework

Teaching humans how to delegate, not how to navigate

Commerce Application: Agent capability calibration·Domains: All Domains · Consumer

Overview

Traditional product onboarding teaches users how to navigate. Agentic onboarding must teach something fundamentally different: how to delegate. Users must form accurate mental models of agent capability, understand what kinds of goals the agent can pursue, and calibrate expectations before experiencing disappointment or misplaced trust.


Core Principles

Onboarding & Capability: Core Principles

01

Agentic Onboarding Is Fundamentally Different

Traditional product onboarding teaches users how to navigate an interface. Agentic onboarding must teach something fundamentally different: how to delegate. The user needs to understand what the agent can do, what it cannot do, and how to specify intent effectively. This is not a tutorial - it is the formation of a working relationship.


02

Mental Models Must Be Accurate

Users form mental models of agent capability from their first interactions. If those models are too optimistic, users will delegate tasks the agent cannot handle, leading to failure and trust erosion. If too pessimistic, users will under-delegate, missing the value proposition. Onboarding must form accurate mental models.


03

Capability Disclosure Must Be Honest

The agent must honestly communicate what it can and cannot do. Overpromising capability to drive adoption creates a trust debt that compounds with every failure. Honest capability disclosure - including explicit limitations - builds the foundation for calibrated trust.


04

First Delegation Is a Critical Moment

The first time a user delegates a real task to the agent is the most consequential moment in the relationship. The outcome of that first delegation sets the trust trajectory for everything that follows. Onboarding must prepare the user for a successful first delegation.


05

Expectations Must Be Set Before Experience

Users should understand what to expect from the agent before they experience it. This includes expected performance levels, typical response times, common limitations, and how to get help when things go wrong. Setting expectations before experience prevents the disappointment that comes from unmet assumptions.


Traditional onboarding teaches users how to use a product. Agentic onboarding teaches users how to trust a partner. The skills are fundamentally different: not clicking and navigating, but specifying, delegating, and evaluating.

Design Patterns

Onboarding & Capability: Implementation Patterns

Capability Disclosure Design

Structured patterns for communicating what the agent can do, what it does well, what it struggles with, and what it cannot do at all. Includes capability maps, limitation disclosures, and confidence-level indicators for different task types.

When to use: During initial onboarding and whenever the agent's capabilities change.

Progressive Delegation Introduction

Staged onboarding that starts with low-consequence, high-confidence tasks and gradually introduces more complex delegations. Each stage builds on demonstrated success, expanding the user's comfort with delegation while maintaining accurate capability expectations.

When to use: During the first days and weeks of a new user's relationship with the agent.

Expectation-Setting Contracts

Explicit agreements between user and agent about expected performance levels, response times, and quality standards. These contracts are not legal documents - they are designed communication artefacts that align expectations before the first delegation.

When to use: During onboarding, before the first delegation occurs.

First-Delegation Experience Design

Specialised design patterns for the user's first real delegation: guided intent specification, enhanced plan preview, real-time progress visibility, and detailed outcome review. The first delegation is over-instrumented to build confidence and calibrate expectations.

When to use: For the user's first delegation in each major task category.

Competence Signal Design

Patterns for demonstrating agent competence through early interactions: showing relevant knowledge, demonstrating understanding of the user's context, and handling edge cases gracefully. Competence signals build trust faster than capability claims.

When to use: Throughout onboarding and early interactions.

Mental Model Validation Tests

Interactive exercises that test whether the user has formed an accurate mental model of agent capability. Includes scenario-based questions, capability boundary explorations, and misconception corrections. Ensures the user understands what they are delegating to.

When to use: At key checkpoints during onboarding, before the user graduates to unsupervised delegation.


Commerce Applications

Onboarding & Capability: Commerce Applications

Agent Capability Calibration

In agentic commerce, the consumer needs to understand what the shopping agent can handle: which product categories, which retailers, what price ranges, what negotiation capabilities. Onboarding calibrates these expectations so the consumer delegates tasks the agent can actually fulfil.


First Purchase Guidance

The first agentic purchase is heavily guided: the agent walks the consumer through intent specification, shows its search process, explains its selection criteria, and presents the purchase decision for explicit approval. This over-transparency builds the foundation for future autonomous operation.


Preference Learning Introduction

During onboarding, the agent explains how it will learn the consumer's preferences over time: what data it will collect, how it will use it, and how the consumer can inspect and correct its understanding. This transparency about the learning process builds trust in the personalisation system.


Limitation Honesty in Commerce

The agent honestly communicates what it cannot do: categories it does not cover, retailers it cannot access, negotiations it cannot perform, and price guarantees it cannot make. This honesty prevents the disappointment that comes from discovering limitations through failure.


The most expensive onboarding failure is not a user who churns. It is a user who stays but never delegates beyond the simplest tasks because their first experience set the wrong expectations.

Implementation

Onboarding & Capability: Guidance for Teams

Start With

  • -Map your agent's actual capabilities and limitations honestly
  • -Design a first-delegation experience with enhanced guidance and transparency
  • -Create capability disclosure materials that include explicit limitations
  • -Build a progressive delegation pathway from simple to complex tasks

Build Toward

  • -Adaptive onboarding that adjusts to user learning speed and delegation comfort
  • -Personalised capability recommendations based on user profile and goals
  • -Ongoing capability education as the agent's abilities expand
  • -Community-driven best practices for effective delegation

Measure By

  • -Mental model accuracy - do users understand what the agent can and cannot do?
  • -First-delegation success rate - does the first real delegation produce a satisfactory outcome?
  • -Time to productive delegation - how quickly do users reach confident, unsupervised delegation?
  • -Capability utilisation - are users leveraging the full range of agent capabilities?


Continue

Onboarding & Capability: What Comes Next

Onboarding teaches humans how to delegate. The final framework - Ethical Constraint & Value Alignment - defines what the agent must never do, regardless of what it is asked.


All Frameworks

Onboarding & Capability: The Framework Ecosystem

Navigate the complete lifecycle of Agentic Experience Design. Each framework addresses a distinct phase of the human-agent relationship.