Skip to content

About

A practitioner framework for designing trustworthy conversational AI with 23 design patterns, research grounding, and working prototypes.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

29 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Conversational AI Patterns

A practitioner's framework for designing trustworthy conversational AI, built from real prototypes, grounded in research, and written from experience leading AI product design in regulated and high-stakes domains.

This is not a theoretical guide. Every pattern here was applied in a working prototype. The research citations are here to back up the design decisions, not to lead them.


Neville Ko: AI Product Manager, Designer & Builder
Portfolio · LinkedIn


Disclaimer: Company and employer names and branding used in the demo prototypes are for design demonstration purposes only. These are unsolicited concept explorations, not official products of or affiliated with the named companies.


Why this exists

Most conversational AI fails not because the model is wrong, but because the interaction design is. Agents that don't express uncertainty. Handoffs between agents that feel like dropped calls. Actions taken without asking. Escalations that arrive too late, or never.

These patterns address the design layer: how conversational AI should behave, communicate, and hand off control in ways that users can trust. The principle behind all of them: AI augments workflow for human judgment. It does not replace it.


The Patterns

# Pattern Core question Seen in
01 Proactive alerts How does the agent surface issues before the user asks? Payroll Intelligence · Travel Disruption
02 Context awareness How does the agent demonstrate it already knows the situation? Payroll Intelligence · Travel Disruption
03 Action-first framing How does the agent lead with what it can do, not what it knows? Travel Disruption
04 Trust calibration How does the agent express confidence, including when it's uncertain? Payroll Intelligence
05 Progressive disclosure How does the agent reveal complexity in layers, not all at once? Payroll Intelligence
06 Multi-agent handoff How do agents transfer context without losing the user? Payroll Intelligence
07 Capability boundaries How does an agent signal what it cannot or should not do? Payroll Intelligence
08 Human-in-the-loop How does the agent require human approval before consequential actions? Payroll Intelligence
09 Autonomous chaining How does the agent complete multi-step tasks without interrupting the user? Travel Disruption
10 Resolution confirmation How does the agent signal that a problem is fully closed? Payroll Intelligence · Travel Disruption
11 Knowledge grounding How does the agent answer from verified sources, not model memory? Travel Disruption
12 Digression handling How does the agent maintain context when the user goes off-topic mid-flow? Travel Disruption
13 Testing and evaluation How does the team validate agent behavior before it reaches production? Travel Disruption
14 Conversation summarization How does the agent capture what happened for handoffs, audit, and context reload? Payroll Intelligence
15 Knowledge assist for human agents How does the system surface relevant knowledge to human agents during live conversations? Payroll Intelligence
16 Conversation repair How does the agent recover when a user says something it cannot understand? Travel Disruption
17 Outcome measurement How does the team know whether the agent actually resolved what the user needed? Payroll Intelligence
18 Auditable AI output When AI outputs must withstand legal or regulatory review, how does the interface make evidence traceable? Regulated Evidence Review (coming soon)
19 Scale triage with audit trail When AI filters large evidence sets, how does the system preserve an audit trail of what was excluded and why? Regulated Evidence Review (coming soon)
21 Adversarial output design When AI methodology will be challenged, how does the interface expose the reasoning chain so it can be reproduced and defended? Regulated Evidence Review (coming soon)
22 HITL handoff design When the agent escalates to a human, what does the handoff contain so the human can make a real decision? Payroll Intelligence
23 Source traceability How does the interface make AI outputs traceable to their source data, not just to a document list? Travel Disruption
24 Sycophancy mitigation How does the interface counteract the model's structural tendency to agree with the user? Payroll Intelligence · Travel Disruption

The Demos

Three working prototypes demonstrate these patterns in context. Screenshots throughout this repo are taken from the first two.

Payroll Intelligence

Context: Global HR and payroll, proactive anomaly detection, cross-border compliance, multi-agent escalation
Patterns: Trust calibration, progressive disclosure, multi-agent handoff, capability boundaries, HITL, inline page update

Payroll Intelligence prototype

View demo details

Travel Disruption

Context: Agentic travel resolution, flight disruption, CFAR refunds, loyalty upgrades
Patterns: Proactive alerts, context awareness, action-first framing, autonomous chaining, resolution confirmation, knowledge grounding

Travel Disruption prototype

View demo details

Personal Creative Assistant (coming soon)

Context: Privacy-first local AI, minimalist conversational UI, GDPR-aligned, no cloud dependency
View demo details

Regulated Evidence Review (coming soon)

Context: AI-assisted review of large evidence sets in regulated and legal contexts; scale triage, chain of custody, adversarial defensibility
Patterns: Auditable AI output, scale triage with audit trail, adversarial output design, HITL handoff design


Video walkthroughs of each prototype are available at fromus.ca (coming soon). To see a live demo, reach out on LinkedIn.


Research Foundation

These patterns are grounded in published research across industry, academia, and governance. Key sources:

  • Google PAIR Guidebook: proactive design, mental models, user control
  • Microsoft HAX Toolkit + Amershi et al. (CHI 2019): 18 guidelines for human-AI interaction, 1,360+ citations
  • Anthropic: Building Effective Agents: agentic workflow patterns, multi-agent orchestration
  • OpenAI: Governing Agentic AI Systems: minimal footprint, reversibility, HITL gates
  • NIST AI RMF 1.0: trustworthy AI attributes, risk management
  • EU AI Act: transparency, human oversight, and record-keeping requirements
  • ACPO Good Practice Guide for Digital Evidence: audit trail and reproducibility requirements for digital evidence
  • Alam & Altiparmak, XAI-CF (2024/2026): explainable AI in cyber forensics; interpretability as a legal admissibility requirement
  • Reedy / Interpol Digital Evidence Review (2026): AI triage admissibility and chain of custody documentation
  • Sharma et al. (2023): empirical characterization of sycophancy in instruction-following models
  • Lewis et al. (2020): retrieval-augmented generation as the architectural foundation for source traceability

Full bibliography: references.md


Related Work

These prototypes share a technical foundation with production-grade AI workflows:

About

A practitioner framework for designing trustworthy conversational AI with 23 design patterns, research grounding, and working prototypes.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors