Smart Search AI Inline layer boundary and AI Tutor escalation policy

DEC-0086 - Smart Search AI Inline layer boundary and AI Tutor escalation policy

Context

Smart Search hiện đã có AI intents và AI Tutor entry, nhưng dễ bị hiểu nhầm rằng AI Inline và AI Tutor là cùng một lớp. Cần khóa boundary để tránh rối UX và tránh mở rộng logic sai hướng.

Decision

• AI Inline là năng lực thuộc Smart Search Layer 1:
  • nhiệm vụ chính là tóm tắt/insight nhanh + CTA hành động ngắn.
• AI Tutor là Layer 2 để đào sâu:
  • chỉ mở khi user chủ động bấm CTA từ inline hoặc từ query hỏi trực tiếp.
• AI Tutor không auto-open khi AI Inline render.
• AI Inline không biến thành giao diện chat tự do; chat tự do chỉ ở AI Tutor.
• Khi query là task rõ ràng, hero task vẫn ưu tiên trước AI inline lane.

Decision Value

• Giữ trải nghiệm Search action-first, không bị trượt sang chat-first.
• Giảm rối nhận thức giữa “xem nhanh” và “đào sâu”.
• Tạo nền ổn định để scale AI inline feature mà không phá luồng chính.

Rationale

Phân tách rõ Layer 1 và Layer 2 giúp user hiểu đúng kỳ vọng mỗi bước: nhanh để quyết định, sâu khi cần thảo luận.

Implications

• Product/UX impact:
  • mọi AI inline card cần CTA escalation rõ, nhưng không được auto-jump vào chat.
• Data/logic impact:
  • ranking composer phải giữ rule task-priority trước AI khi query là task.
• Operational impact:
  • giảm support issues do auto-open hoặc context jump khó hiểu.

Alternatives considered

• Option A: gộp AI Inline và AI Tutor vào một flow chat-first.
• Option B: tách 2 lớp rõ ràng với escalation có chủ đích (selected).

Decision quality check

Decision quality check: DEC-0086

• Score: 11/12
• Weak dimensions: Operational feasibility (1)
• Action: Promoted as confirmed with explicit fallback requirements in DEC-0087.

Open follow-ups

• Resolved by DEC-0089: mapping dùng canonical ACT_TEST + AIF_MOCK_FULL_TEST variant (không tách intent mới ở v1).