Smart Search Platform - Intent Taxonomy and Result Contract

SharedShared Capabilities890 words4 min read

activebyDOL Product Design

Purpose

Chuẩn hóa ngôn ngữ intent và cấu trúc kết quả để các module mở rộng mà không phá consistency.

Unified Intent Taxonomy (v1)

A. Learning Actions

ACT_ASSIGNMENT
ACT_TEST
ACT_EXERCISE
ACT_DICTATION
ACT_VOCAB
ACT_GRAMMAR
ACT_MENTAL_MODEL

B. Operations Actions

ACT_SCHEDULE
ACT_BOOKING
ACT_ABSENCE
ACT_ATTENDANCE
ACT_EVENTS

C. Progress Actions

ACT_RESULT
ACT_FEEDBACK
ACT_LEADERBOARD
ACT_CERTIFICATE

D. AI Insight Actions

ACT_AI_STATS
ACT_AI_PRACTICE_PROCESS
ACT_AI_SCHEDULE_PREP
ACT_AI_SESSION_SUMMARY
ACT_AI_ERROR_BANK
ACT_AI_VOCAB_CONNECT
ACT_AI_EXPLAIN
ACT_AI_TUTOR

Intent Governance Rules

Mỗi intent phải có:
- id
- category
- verbs[]
- objects[]
- actionPhrases[]
- priority
- supportedDepth[]
Cấm tạo intent mới nếu có thể mở rộng từ intent hiện hữu bằng context hoặc variant.
Synonym song ngữ (VI/EN) là bắt buộc cho intent dùng chung.

Intent Variant Policy (v1)

AI Thi thu Full Test không tạo intent mới.
Canonical mapping:
- intentId = ACT_TEST
- variant.inlineFeatureKey = AIF_MOCK_FULL_TEST
- variant.renderMode = AI_inline_builder
Nếu thiếu context tạo test (program/form):
- fallback về luồng test chuẩn ACT_TEST với disambiguation ngắn.

Intent Bundle Registry (Msearch umbrella queries)

Bundle dùng cho query tổng quát, không thay thế intent taxonomy chính.
Bundle mặc định:
- BUNDLE_AI_FEATURES:
  - trigger: ai, tính năng ai, ai có gì, trợ lý ai.
  - mở rộng ra toàn bộ ACT_AI_* hợp lệ theo area policy.
- BUNDLE_PRACTICE_ACTIONS:
  - trigger: làm bài, làm bài tập, luyện tập, practice.
  - mở rộng ra ACT_EXERCISE, ACT_ASSIGNMENT, ACT_TEST, ACT_DICTATION, ACT_VOCAB + AI hỗ trợ làm bài.
Governance:
- bundle mới cần review giống intent mới.
- không tạo bundle nếu có thể giải bằng synonym đơn intent.

Content Facet Tagging (Msearch metadata layer)

Mỗi search feature/result phải có lớp tag nội dung để match theo “loại nội dung”, không chỉ theo tên feature.
Facet groups chuẩn:
- featureFamily: ai | practice | schedule | result | vocabulary | course_ops | discovery.
- contentType: insight | task | plan | material | review | catalog | guide.
- contentFormat: widget | list | card | popup | tab | report | checklist.
- keywordAliases[]: synonym tự nhiên theo domain (VI/EN).
Ví dụ:
- AI Weekly Pulse:
  - featureFamily=ai, contentType=insight, contentFormat=report,
  - aliases: thống kê tuần, báo cáo tuần, weekly stats.
- Bài test chưa làm:
  - featureFamily=practice, contentType=task, contentFormat=list,
  - aliases: làm test, bài chưa làm, unattempted test.

Result Contract (Shared)

interface SmartSearchResult {
  id: string;
  intentId: string;
  depth: 'PAGE' | 'STEP' | 'AI' | 'EXEC';
  type: 'nav' | 'activity' | 'ai' | 'info' | 'completion';
  title: string;
  subtitle?: string;
  ctaLabel: string;
  route?: string;
  actionKey?: string;
  badges?: string[];
  contextTags?: string[];
  facetTags?: {
    featureFamily?: 'ai' | 'practice' | 'schedule' | 'result' | 'vocabulary' | 'course_ops' | 'discovery';
    contentType?: 'insight' | 'task' | 'plan' | 'material' | 'review' | 'catalog' | 'guide';
    contentFormat?: 'widget' | 'list' | 'card' | 'popup' | 'tab' | 'report' | 'checklist';
    keywordAliases?: string[];
  };
  sourceModule: 'home' | 'course' | 'learning' | 'practice' | 'vocabulary' | 'shared';
  freshnessAt?: string;
  confidence?: number;
}

Ranking Contract (Shared)

finalScore = intentPriority + urgencyBoost + contextBoost + recencyBoost + confidenceBoost
Quy tắc ưu tiên:
- Urgency (due, upcoming, overdue)
- Momentum (in-progress, resume)
- Local Context Bias (đang đứng ở module nào)
- Cross-module Continuity (vừa hoàn thành flow nào)

Display Contract (Shared)

Prefix suggestions: tối đa 3.
Mỗi category group: tối đa 3 kết quả.
Chỉ có 1 Hero Action cho mỗi query state.
Query ngắn ưu tiên completion; query rõ nghĩa ưu tiên contextual results.
AI không lấn át kết quả tác vụ trừ khi user gọi intent AI hoặc không có kết quả phù hợp.
Exception cho umbrella query:
- nếu match bundle trigger (AI, làm bài, làm bài tập…), chuyển sang bundle mode và bỏ giới hạn prefix max 3.
- bundle mode phải render theo nhóm tính năng và cho phép liệt kê đầy đủ danh sách khả dụng trong context hiện tại.
Exception cho facet query:
- nếu query match contentType/contentFormat/featureFamily, hệ thống phải trả đầy đủ feature cùng facet trước khi fallback sang match theo title.
- ví dụ query widget, báo cáo, checklist, popup, task phải trả nhóm tính năng tương ứng dù user không nhớ tên feature.

References

Change log

2026-02-28: title: “Smart Search Platform - Intent Taxonomy and Result Contract”
2026-03-01: Add intent-variant governance for AI Thi thu Full Test (ACT_TEST + AIF_MOCK_FULL_TEST) to avoid taxonomy sprawl.