Agentic Design

Patterns
🎓

Onboarding and Education Patterns(OEP)

User education and onboarding patterns for introducing agent capabilities, building appropriate mental models, and fostering trust

Complexity: mediumUI/UX & Human-AI Interaction

🎯 30-Second Overview

Pattern: User education and onboarding patterns for building appropriate mental models and trust in AI agents

Why: Users need proper introduction to agent capabilities to develop appropriate expectations and effective usage patterns

Key Insight: Build trust through progressive capability disclosure, hands-on practice, and transparent limitation communication

⚡ Quick Implementation

1Mental Model Building:Establish clear agent capabilities and limitations early
2Progressive Disclosure:Layer complexity from basic to advanced features
3Interactive Tutorials:Hands-on practice with real agent interactions
4Trust Calibration:Demonstrate reliability and failure scenarios
5Contextual Help:Just-in-time assistance and feature discovery
Example: intro_capabilities → guided_interaction → trust_demo → practice_scenarios → ongoing_support

📋 Do's & Don'ts

✅Start with clear capability boundaries and limitations
✅Use progressive disclosure to prevent cognitive overload
✅Provide hands-on practice with immediate feedback
✅Build trust gradually through transparency and reliability
✅Offer contextual help and feature discovery prompts
❌Overwhelm users with all features at once
❌Promise capabilities the agent cannot deliver
❌Use lengthy text-heavy tutorials without interaction
❌Hide important limitations or failure modes
❌Force users through rigid linear onboarding flows

🚦 When to Use

Use When

  • • Introducing novel AI agent capabilities
  • • Complex systems requiring mental model building
  • • Consumer-facing AI applications
  • • Systems where trust and reliability are critical

Avoid When

  • • Expert users already familiar with similar agents
  • • Simple, single-purpose agent tools
  • • Internal tools with extensive training programs
  • • Temporary or experimental prototypes

📊 Key Metrics

Onboarding Completion
% of users completing initial training flow
Feature Adoption
Rate of advanced feature discovery and usage
Trust Calibration
Appropriate reliance on agent recommendations
Time to Productivity
Duration from first use to effective task completion
User Retention
% of users returning after initial onboarding
Support Reduction
Decrease in help requests post-onboarding

💡 Top Use Cases

AI Assistant Introduction: Progressive capability reveal with trust-building scenarios
Professional Tool Onboarding: Expert feature education with workflow integration
Consumer AI Products: Mental model building for everyday users
Enterprise Agent Deployment: Role-based training with compliance education
Educational AI Tutors: Learning methodology explanation and interaction patterns

References & Further Reading

Deepen your understanding with these curated resources

Learning Theory & Cognitive Science

Cognitive Load Theory in Instructional Design (Sweller, 2011)

Progressive Disclosure in Learning Systems (Nielsen, 2006)

Mental Models in Human-Computer Interaction (Norman, 2013)

Scaffolding Theory in Educational Technology (Wood, Bruner & Ross, 1976)

Zone of Proximal Development in Interface Design (Vygotsky, 1978)

Trust & Mental Models in AI

Trust in Human-AI Collaboration (Lee & See, 2004)

Calibrating Trust in AI Systems (Parasuraman & Riley, 1997)

Mental Models of AI Capabilities (Keil & Wilson, 2000)

Trust Repair in Automated Systems (Madhavan & Wiegmann, 2007)

AI Transparency and User Understanding (Ribeiro et al., 2016)

User Onboarding Research

User Onboarding Design Patterns (Krug, 2014)

First-Time User Experience Design (Hoober & Berkman, 2011)

Onboarding Effectiveness Studies (Pulizzi & Barrett, 2009)

CHI 2023: AI Onboarding Patterns

Progressive Web App Onboarding (Google, 2021)

Industry Best Practices

Apple Human Interface Guidelines - Onboarding

Google Material Design - Onboarding

Microsoft Fluent Design - First Run Experience

Salesforce Lightning Design - Welcome Mats

Atlassian Design - Onboarding Patterns

Interactive Tutorial Design

Interactive Tutorial Effectiveness (Carroll & Rosson, 1987)

Guided Tour vs. Contextual Help (Grossman et al., 2009)

Microlearning in Software Training (Hug, 2005)

Just-in-Time Learning Systems (Ackerman & Malone, 1990)

Adaptive Help Systems (Brusilovsky, 2001)

Implementation Frameworks

React Onboarding Libraries (Reactour)

Vue.js Tour Components

Intro.js Step-by-Step Guide

Shepherd.js Guided Tours

Driver.js Onboarding Framework

Measurement & Analytics

Onboarding Funnel Analysis (Mixpanel, 2022)

User Engagement Metrics (Amplitude, 2021)

Product Analytics for Onboarding (Segment, 2020)

A/B Testing Onboarding Flows (Optimizely, 2019)

Retention Analysis Post-Onboarding (Clevertap, 2021)

Contribute to this collection

Know a great resource? Submit a pull request to add it.

Contribute

Patterns

closed

Loading...