AI Tutor Platform - Carryover Notes from Smart Search

SharedShared Capabilities658 words3 min read

activebyDOL Product Design

Mục đích

Chốt các rule AI Tutor đang nằm trong Smart Search để tái sử dụng an toàn.
Khóa boundary Layer 1 vs Layer 2 trước khi mở rộng feature AI Tutor.

Những gì đã có và cần giữ

ACT_AI_TUTOR tồn tại trong intent taxonomy.
AI Tutor là Layer 2 để đào sâu sau bước action/search ban đầu.
Rule on-demand only (không auto-open AI Tutor).
no-result flow có CTA fallback sang AI Tutor.
Umbrella AI có liệt kê ACT_AI_TUTOR theo area policy.
Search -> Tutor handoff phải giữ context bắt buộc.

Boundary update (DEC-0086)

AI Inline là Smart Search Layer 1 (xem nhanh + action nhanh).
AI Tutor là Layer 2 (đào sâu hội thoại).
AI Inline không biến thành chat tự do.
AI Tutor chỉ mở khi user chủ động gọi (direct hoặc escalation CTA).
Query task rõ vẫn ưu tiên hero task trước AI inline lane.

Handoff payload contracts

1) Baseline handoff (legacy-compatible)

interface AIHandoffPayload {
  intentId: string;
  query: string;
  summary: string;
  entities?: string[];
  sourceModule: 'home' | 'course' | 'learning' | 'practice' | 'vocabulary' | 'program';
  contextTags?: string[];
}

2) AI Inline escalation packet (DEC-0087)

// ⚠️ SUPERSEDED: canonical name is AIHandoffPayload (AIT_Master_Product_Spec §5.2, AIChatPanel.tsx)
// This interface preserved for historical context only.
interface AIInlineTutorHandoffPayload /* → AIHandoffPayload */ {
  inlineFeatureKey: string;
  intentId: string;
  query: string;
  inlineSummary: string;
  evidence?: string[];
  provenanceHints?: Array<{
    sourceClass: 'practice' | 'course' | 'blog' | 'history';
    sourceId?: string;
  }>;
  recommendedActions?: string[];
  sourceModule: 'home' | 'course' | 'learning' | 'practice' | 'vocabulary' | 'program';
  pageContextId?: string;
  freshnessAt?: string;
  confidence?: 'high' | 'medium' | 'low';
  payloadTier?: 'full' | 'balanced' | 'lite';
  returnTo: string;
}

3) Fallback open-chat seed

interface AITFallbackSeed {
  intentId: string;
  query: string;
  sourceModule: 'home' | 'course' | 'learning' | 'practice' | 'vocabulary' | 'program' | 'search';
}

Escalation handshake rule

CTA chuẩn: Hỏi sâu hơn với AI Tutor.
Flow:
1. validate packet,
2. open AI Tutor với seed context,
3. user chat tự do ngay sau đó.
Nếu packet lỗi/thiếu:
- vẫn mở AI Tutor,
- dùng fallback seed tối thiểu,
- hiển thị notice nhẹ,
- không block user.

Wave 2 carryover updates

Mobile payload compression:
- dùng tier full|balanced|lite với caps thống nhất.
- luôn giữ required minimum + fallback-open invariant.
AI Thi thu Full Test mapping:
- canonical intent giữ ACT_TEST,
- AI variant dùng AIF_MOCK_FULL_TEST,
- không tách intent mới ở v1.

Smart Search rules liên quan AI Tutor phải giữ

Search Layer-1 -> AI Tutor Layer-2 phải giữ context.
AI Tutor không auto-open ở mọi area.
Tie-break AI results:
- chỉ ưu tiên ACT_AI_TUTOR khi user có ý định hỏi trực tiếp.
Query task rõ:
- AI card không được vượt hero action tác vụ.

Map tham chiếu nhanh trong Smart Search

Core architecture + layer:
- ../Smart Search Platform/SSP_Master_Product_Spec.md
- ../Smart Search Platform/SSP_Smart_Search_Logic_Explainer.md
Runtime contracts:
AI mapping + payload:
- ../Smart Search Platform/ux-patterns/SSP_AI_Keyword_Widget_Map.md

Gợi ý migration theo pha

Pha 1: giữ AIHandoffPayload cũ + thêm AIInlineTutorHandoffPayload cho escalation path.
Pha 2: chuẩn hóa telemetry handoff_start|handoff_success|handoff_fallback_open.
Pha 3: đã khóa payload compression theo tier full|balanced|lite; rollout bằng telemetry tuning.

Change log

2026-03-01: Bổ sung Wave 2 contracts theo DEC-0088/0089 (mobile payload tiering + full-test intent variant mapping).
2026-03-01: Bổ sung boundary Layer1/Layer2 và export-context handshake theo DEC-0086/0087.
2026-02-28: Tổng hợp các rule AI Tutor đã có trong Smart Search để làm input gốc cho AI Tutor Platform.