AI Inline to AI Tutor export-context and open-chat handshake

DEC-0087 - AI Inline to AI Tutor export-context and open-chat handshake

Context

User cần một bước đào sâu liền mạch từ AI Inline sang AI Tutor. Nếu không có contract export rõ, handoff dễ mất ngữ cảnh hoặc chat mở ra quá chung chung.

Decision

• CTA escalation chuẩn từ AI inline là Hỏi sâu hơn với AI Tutor.
• Khi click CTA, Smart Search phải export packet context tối thiểu gồm:
  • inlineFeatureKey,
  • intentId,
  • query,
  • inlineSummary,
  • evidence[],
  • recommendedActions[],
  • sourceModule, pageContextId,
  • freshnessAt, confidence,
  • returnTo.
• AI Tutor mở ở trạng thái chat mới với seed context từ packet; user được chat tự do ngay sau đó.
• Nếu export packet lỗi hoặc thiếu một phần dữ liệu:
  • vẫn mở AI Tutor,
  • fallback sang seed tối thiểu (intent + query + sourceModule),
  • hiển thị notice nhẹ, không chặn hội thoại.

Decision Value

• Giữ continuity giữa insight nhanh và trao đổi sâu.
• Giảm nhu cầu user nhập lại bối cảnh.
• Tăng xác suất cuộc chat đi thẳng vào vấn đề cần giải quyết.

Rationale

Handoff có cấu trúc giúp AI Tutor bắt đầu đúng ngữ cảnh ngay lượt đầu, nhưng vẫn giữ quyền kiểm soát cho user.

Implications

• Product/UX impact:
  • mọi AI inline card cần hỗ trợ CTA escalation theo cùng contract.
• Data/logic impact:
  • cần validate packet trước khi open-chat handshake.
• Operational impact:
  • telemetry phải phân biệt rõ handoff_start, handoff_success, handoff_fallback_open.

Alternatives considered

• Option A: mở AI Tutor không mang context, để user tự nhập lại.
• Option B: handoff có packet context + fallback tối thiểu khi lỗi (selected).

Decision quality check

Decision quality check: DEC-0087

• Score: 10/12
• Weak dimensions: Scale risk (1), Operational feasibility (1)
• Action: Promoted as confirmed with payload cap and fallback constraint to control complexity.

Open follow-ups

• Resolved by DEC-0088: tiered payload compression (full|balanced|lite) with required-minimum and fallback invariants.