AI Interaction Patterns
Patterns for how users interact with AI-powered features in Acua.
AI Inference Display
AI-populated values must allow users to verify and modify.
States
| State | Visual | User Action |
|---|---|---|
| Unconfirmed | Violet background + Sparkles icon | User has not reviewed |
| Confirmed | Normal display | User clicked/edited field |
| Rejected | Field cleared, manual input | User deleted AI value |
| Modified | Normal display | User edited AI value |
Confirmation Behavior
- Implicit confirmation: User tabs through or clicks field
- Explicit confirmation: User clicks "Accept" button (for bulk operations)
- Batch confirmation: "Accept All AI Suggestions" action
Rationale Display
Show reasoning via Tooltip on hover/focus.
AI Extraction
Source:"Bill to" field
Confidence:95%
|
Confidence Display
| Range | Display | Color |
|---|---|---|
| 90-100% | "High confidence" or percentage | Green |
| 70-89% | "Medium confidence" or percentage | Yellow |
| Below 70% | "Low confidence - please verify" | Orange |
Processing States
Short Operations (< 3 seconds)
Analyzing invoice...
- Spinner + descriptive message
- No cancel option (too fast)
Medium Operations (3-10 seconds)
Extracting invoice data
This may take a few seconds
- Spinner + message + sub-message
- Cancel option available
Long Operations (> 10 seconds)
Processing Invoice60%
Extracting line items (3/5)
- Progress bar with percentage
- Current step indicator
- Cancel option
Streaming/Real-time Results
Vendor
ABC Corporation Ltd.
Amount
฿125,000.00
Date
2024-01-
Tax ID
Pending...
- Show results as they become available
- Typing indicator for in-progress fields
- Checkmark for completed fields
Error & Fallback States
Error Types
| Error | Message | Action |
|---|---|---|
| Extraction failed | "Could not extract data from this document" | Manual entry form |
| Low confidence | "AI confidence is low. Please verify all fields" | Highlight uncertain fields |
| Service unavailable | "AI service is temporarily unavailable" | Manual entry + retry option |
| Timeout | "Processing is taking longer than expected" | Cancel + manual entry |
Fallback Principle
- Never block the user - Always provide manual path
- Preserve partial results - If 3/5 fields extracted, show those 3
- Explain what happened - Brief, non-technical message
- Offer retry - When appropriate (not for permanent failures)