AI Tutor Platform - Smart Search Handoff Contract

Purpose

• Chuẩn hóa boundary giữa AI Inline (Layer 1) và AI Tutor (Layer 2).
• Khóa contract export-context khi user escalates từ inline sang tutor chat.

Layer Boundary

• AI Inline:
  • nhiệm vụ: insight nhanh + action ngắn.
  • không phải chat tự do.
• AI Tutor:
  • nhiệm vụ: đào sâu hội thoại và hướng dẫn học tập.
  • mở theo on-demand entry.

Escalation CTA Contract

• Label chuẩn: Hỏi sâu hơn với AI Tutor.
• Trigger từ inline card phải mở AI Tutor với context seed tương ứng.

Export Packet Contract

// Canon name: AIHandoffPayload (see AIT_Master_Product_Spec §5.2)
interface 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;
}

Open-chat Handshake

1. Validate packet.
2. Open AI Tutor chat với seed context.
3. User được chat tự do ngay lượt đầu.

Fallback Contract

Nếu packet lỗi/thiếu:

• vẫn mở AI Tutor,
• fallback seed tối thiểu gồm intentId + query + sourceModule,
• hiển thị notice nhẹ,
• tuyệt đối không block hội thoại.

Mobile Payload Compression Contract

• Handoff payload dùng tier:
  • full: context-rich cho desktop/mobile mạnh.
  • balanced: default mobile.
  • lite: low-end hoặc mạng yếu.
• Compression caps:
  • evidence[]: 3/2/0-1.
  • recommendedActions[]: 3/2/1.
  • inlineSummary: cắt theo ngưỡng tier-specific.
• Invariant:
  • required minimum fields luôn được giữ.
  • compression không được chặn open-chat handshake.

Full-test Mapping Contract

• AI Thi thu Full Test map theo canonical intent ACT_TEST.
• Dùng feature variant:
  • inlineFeatureKey = AIF_MOCK_FULL_TEST.
• Không tạo intent mới ở v1; resolver xử lý qua intent-variant policy.

Telemetry Contract

Tối thiểu cần có:

• handoff_start
• handoff_success
• handoff_fallback_open

Open Questions

• No blocker-level open questions for handoff baseline.

Dependencies

• AIT_Master_Product_Spec.md
• AIT_Smart_Search_Carryover_Notes.md
• docs/Shared/Shared Capabilities/Smart Search Platform/contracts/SSP_Implementation_Logic_Contract.md
• docs/Shared/Shared Capabilities/Smart Search Platform/contracts/SSP_Context_Pack_Adapter_Contracts.md
• docs/Shared/Shared Capabilities/Smart Search Platform/contracts/SSP_Intent_Taxonomy_Result_Contract.md

Change log

• 2026-03-01: Wave 2 update theo DEC-0088/0089: thêm payload tier compression policy và full-test intent variant mapping.
• 2026-03-01: Tạo handoff contract chi tiết theo DEC-0086/0087.