AI Tutor Platform - Conversation Modes and Output Contracts

Purpose

• Chuẩn hóa mode -> output -> action để AI Tutor trả lời nhất quán xuyên module.
• Giảm tình trạng trả lời lan man hoặc không gắn hành động học tiếp theo.

Mode Matrix

Mode	Trigger điển hình	Bắt buộc có	Không được thiếu
quick_explain	”giải thích từ này/ngữ pháp này”	định nghĩa + ví dụ	CTA học tiếp ngắn
deep_tutor_chat	follow-up nhiều vòng	context continuity	câu hỏi gợi mở tiếp
exercise_coaching	learner đang làm bài	hint ladder	chặn final answer
plan_guidance	high-attention/plan query	các bước ưu tiên now/next/optional	non-blocking wording
progress_insight	hỏi tiến độ/thống kê	metric-window context	recommendation hành động
resource_recommender	hỏi học gì tiếp	do-now + learn-more	source provenance
diagram_mindmap_ready	yêu cầu sơ đồ/mindmap	output structure nodes/edges	fallback text nếu không render

Output Artifact Contracts

Purpose-based sectioning baseline

• artifactType quyết định loại phản hồi chính, nhưng không quyết định toàn bộ layout learner-facing.
• Nếu một response có nhiều mục đích đọc khác nhau, AI nên tách thành purpose-based sections như:
  • assessment
  • actions
  • explanation
  • queue
  • readiness
  • summary
• Với learner-facing inline surfaces, UI nên ưu tiên một compact switch/segmented control để user đổi nhanh giữa các purpose mà không phải đọc một card quá dài.
• stacked cards hoặc split layout chỉ là fallback khi cần nhìn nhiều section cùng lúc; không ép một bộ tab cố định cho toàn hệ.
• Nếu artifact có guided_checklist hoặc checklist/roadmap đủ rõ, checklist đó nên được xem là lane action riêng thay vì luôn render nối tiếp dưới narrative body.

1) concise_answer

• Mục tiêu: trả lời nhanh 1 khái niệm.
• Form: Key point -> short example -> next step.

2) guided_checklist

• Mục tiêu: dẫn user làm theo từng bước.
• Form: 3-7 bước, có trạng thái gợi ý now/next.

3) mini_exercise

• Mục tiêu: learner luyện ngay trong chat.
• Form: prompt ngắn + tiêu chí tự kiểm tra + hint follow-up.

4) diagram_or_mindmap_ready

• Mục tiêu: tổ chức kiến thức dạng visual-ready.
• Form: các node/chủ đề chính + quan hệ + thứ tự học.
• Render policy:
  • visual_native khi môi trường hỗ trợ.
  • fallback structured_graph_text khi không có renderer.
  • fallback guided_checklist khi complexity/performance gate không đạt.

5) progress_insight

• Mục tiêu: giải thích tiến độ khi user yêu cầu.
• Form: window -> signal -> meaning -> next action.
• Window mặc định: today/7-day/30-day nếu dữ liệu có.

Action Continuity Contract

• Với mọi artifact trừ câu trả lời cực ngắn, hệ thống phải có ít nhất 1 action:
  • continue_chat, hoặc
  • open_exercise/open_resource/open_plan/open_progress.
• Nếu có đủ context, ưu tiên deeplink sang tài nguyên thực trên platform.
• Nếu response vừa có insight vừa có action, action không nên chìm trong cùng một paragraph; nó phải tách thành section riêng hoặc block riêng.

Provenance Contract

• Mỗi phản hồi cần đính ít nhất 1 provenance class:
  • practice, course, blog, history, general_fallback.
• Khi dùng general_fallback, bắt buộc có câu minh bạch giới hạn dữ liệu.

Provenance visibility depth

• compact:
  • source chips ngắn, ưu tiên dễ đọc.
• standard:
  • chips + danh sách nguồn tóm tắt.
• detailed:
  • metadata mở rộng (source/freshness/confidence context), mở theo on-demand action.
• Segment default:
  • new learner: compact.
  • active/course/high-attention: standard.
• Disclosure invariant:
  • nếu response có general_fallback, disclaimer luôn hiển thị ở mọi depth.

Example Mapping

1. User hỏi “em sai thì quá khứ hoàn thành mãi”:

• mode: quick_explain
• artifact: concise_answer
• action: open_exercise (related grammar drill)

2. User hỏi “vẽ mindmap cho mệnh đề quan hệ”:

• mode: diagram_mindmap_ready
• artifact: diagram_or_mindmap_ready
• action: mini_exercise follow-up hoặc open_resource

3. User hỏi “tuần này em học sao rồi”:

• mode: progress_insight
• artifact: progress_insight
• action: do now bài quan trọng nhất hôm nay

Dependencies

• AIT_Master_Product_Spec.md
• AIT_02_Exercise_Coaching_Integrity_Policy.md
• AIT_03_Smart_Search_Handoff_Contract.md

Change log

• 2026-03-01: Wave 2 update theo DEC-0090/0091: bổ sung rendering 3 tầng cho mindmap/diagram và provenance depth modes theo segment.
• 2026-03-01: Tạo mode/output contract chi tiết để chuẩn hóa behavior AI Tutor theo DEC-0082/0083/0085.