ASL / CASE_STUDY_003
AI SYSTEMS
HỆ THỐNG AI TƯ VẤN KHÁCH HÀNG
Conversational AI Consultation
Một agent AI có quy tắc nghiệp vụ, trạng thái có cấu trúc và kiểm tra đầu ra.
Hệ thống tư vấn nhu cầu bằng AI: đặt câu hỏi làm rõ yêu cầu, tổng hợp brief có cấu trúc, gợi ý hướng triển khai và chuyển giao cho đội ngũ kinh doanh khi khách đồng ý.
- PROJECT ID
- WRK-003
- INDUSTRY
- EVENTS & MEDIA
- CATEGORY
- AI SYSTEMS
- STATUS
- PROTOTYPE
- TECHNOLOGY
- LARAVEL 8 / PHP 7.4 / MYSQL / OPENAI API
01 / Project Overview
Tổng quan hệ thống.
Business objective
Tiếp nhận yêu cầu tư vấn trên website, làm rõ nhu cầu qua hội thoại và chuyển giao brief đủ ngữ cảnh cho người phụ trách.
Tính năng chính
- Trò chuyện tư vấn bằng ngôn ngữ tự nhiên
- Đặt câu hỏi làm rõ nhu cầu theo kịch bản nghiệp vụ
- Tổng hợp brief yêu cầu có cấu trúc
- Tra cứu tri thức nội bộ để trả lời
- Kiểm soát đầu ra và che dữ liệu cá nhân
- Chuyển giao cho nhân viên kinh doanh khi khách đồng ý
Technical foundation
- Laravel 8
- PHP 7.4
- MySQL
- OpenAI API (HTTP client)
- PHPUnit
- SYSTEM TYPE
- LARAVEL MODULE + API
- ARCHITECTURE
- SINGLE AGENT PIPELINE
- DATABASE
- RELATIONAL (SESSIONS · TURNS · HANDOFFS)
- MODEL CALLS
- USUALLY 1 PER TURN · ≤ 1 TOOL ROUND
Module PHP của hệ thống (bản chuyển thể cho tư vấn giải pháp công nghệ) có trong mã nguồn website ASolution, thư mục ai-consultant/, kèm test tự động. Chưa vận hành như sản phẩm thương mại.
CASE BRIEF / QUICK ANSWERS — HỆ THỐNG AI TƯ VẤN KHÁCH HÀNG
- Hệ thống AI tư vấn khách hàng là hệ thống gì?
- Hệ thống tư vấn nhu cầu bằng AI: đặt câu hỏi làm rõ yêu cầu, tổng hợp brief có cấu trúc, gợi ý hướng triển khai và chuyển giao cho đội ngũ kinh doanh khi khách đồng ý.
- Hệ thống giải quyết bài toán nào?
- yêu cầu ban đầu thiếu thông tin; ai có thể tự hứa giá, thời gian hoặc nhận đã làm cho khách hàng; người dùng có thể tìm cách lộ hướng dẫn hệ thống; tin nhắn có thể chứa số điện thoại, email; hội thoại dài làm tăng chi phí gọi model.
- Kiến trúc kỹ thuật ra sao?
- single agent pipeline: chat ui → ai consultant controller → consult service → brief merger → mysql, cùng các module signal extractor, risk rules, question planner, knowledge search, openai client, output validator.
- Sử dụng công nghệ gì?
- Laravel 8, PHP 7.4, MySQL, OpenAI API (HTTP client), PHPUnit.
- Hệ thống có những tính năng nào?
- Trò chuyện tư vấn bằng ngôn ngữ tự nhiên; Đặt câu hỏi làm rõ nhu cầu theo kịch bản nghiệp vụ; Tổng hợp brief yêu cầu có cấu trúc; Tra cứu tri thức nội bộ để trả lời; Kiểm soát đầu ra và che dữ liệu cá nhân; Chuyển giao cho nhân viên kinh doanh khi khách đồng ý.
- Có những module nào?
- Conversation API, Rules Engine, Knowledge Retrieval, LLM Integration, Output Safety, Brief & State, Handoff.
- Những quyết định kỹ thuật nào đáng chú ý?
- Structured brief instead of chat memory (có bằng chứng trong mã nguồn); Validate every model output (có bằng chứng trong mã nguồn); Rules before the model (có bằng chứng trong mã nguồn); Privacy by default (có bằng chứng trong mã nguồn); Hard limits (có bằng chứng trong mã nguồn).
- Trạng thái phát triển hiện tại là gì?
- PROTOTYPE. Module PHP của hệ thống (bản chuyển thể cho tư vấn giải pháp công nghệ) có trong mã nguồn website ASolution, thư mục ai-consultant/, kèm test tự động. Chưa vận hành như sản phẩm thương mại.
- ASolution có thể xây dựng hệ thống tương tự không?
- Có thể trao đổi để phân tích yêu cầu, thiết kế kiến trúc và phát triển hệ thống theo nghiệp vụ của doanh nghiệp.
02 / Business Context
Bối cảnh vận hành và nhu cầu quản trị.
Doanh nghiệp sự kiện nhận nhiều yêu cầu tư vấn ban đầu chỉ có một hai câu mô tả. Đội ngũ kinh doanh phải hỏi lại quy mô, thời gian, ngân sách trước khi có thể tư vấn.
Hệ thống do ASolution phát triển và đã được chuyển thể để tư vấn giải pháp công nghệ trên website ASolution, giữ nguyên kiến trúc và thay nghiệp vụ.
SOLUTION FLOW / OVERVIEW
- MESSAGE
- SIGNAL EXTRACTION
- RISK RULES
- QUESTION PLANNING
- KNOWLEDGE SEARCH
- LLM CALL (STRICT JSON)
- OUTPUT VALIDATION
- BRIEF MERGE
03 / Business Challenges
Những vấn đề hệ thống hướng đến giải quyết.
-
CHALLENGE_01
Incomplete Requests
Yêu cầu ban đầu thiếu thông tin.
- BUSINESS IMPACT
- Kinh doanh mất thời gian hỏi lại từ đầu.
- SYSTEM CAPABILITY
- QuestionPlanner + BriefDocument
-
CHALLENGE_02
Hallucination Risk
AI có thể tự hứa giá, thời gian hoặc nhận đã làm cho khách hàng.
- BUSINESS IMPACT
- Rủi ro cam kết sai với khách.
- SYSTEM CAPABILITY
- OutputValidator cắt câu không có căn cứ
-
CHALLENGE_03
Prompt Leakage
Người dùng có thể tìm cách lộ hướng dẫn hệ thống.
- BUSINESS IMPACT
- Lộ quy tắc nội bộ.
- SYSTEM CAPABILITY
- Canary token trong system prompt
-
CHALLENGE_04
Personal Data
Tin nhắn có thể chứa số điện thoại, email.
- BUSINESS IMPACT
- Rủi ro quyền riêng tư.
- SYSTEM CAPABILITY
- Pii masking trước khi gửi model và lưu
-
CHALLENGE_05
Cost Control
Hội thoại dài làm tăng chi phí gọi model.
- BUSINESS IMPACT
- Chi phí khó dự đoán.
- SYSTEM CAPABILITY
- Giới hạn lượt, token, rate limit
04 / Requirements Engineering
Chuyển bài toán nghiệp vụ thành yêu cầu hệ thống.
Conversation
- Session theo thiết bị
- Một lượt chat
- Quick replies
- Khôi phục transcript
Brief
- Trường brief cấu hình được
- Trạng thái và nguồn từng trường
- Hợp nhất qua nhiều lượt
Safety
- Risk rules
- Output validation
- Canary
- PII masking
Handoff
- Consent bắt buộc khi có liên hệ
- Mã hóa liên hệ
- Lệnh xem cho kỹ sư
Priority là phân loại minh họa, không phải kế hoạch dự án đã phê duyệt.
REQ-001 / CHAT
ONE QUESTION PER TURN
- DESCRIPTION
- Mỗi lượt tối đa một câu hỏi làm rõ; không hỏi cùng một điều hai lượt liền.
- BUSINESS REASON
- Hội thoại tự nhiên, không tra hỏi khách.
- RELATED DECISION
- ADR-003 · Rules before the model ↓
05 / Solution Approach
Hướng tiếp cận giải pháp.
- P-01
Rules before model
Tín hiệu, rủi ro và câu hỏi tiếp theo được xác định bằng quy tắc, không tốn token.
- P-02
Structured state
Brief và trạng thái hội thoại có cấu trúc, không phụ thuộc trí nhớ của model.
- P-03
One model call
Thường chỉ một lần gọi model mỗi lượt với output JSON strict.
- P-04
Validate output
Mọi câu trả lời đi qua bộ kiểm tra trước khi hiển thị.
Các nguyên tắc thiết kế xuyên suốt hệ thống.
- MESSAGE
- SIGNAL EXTRACTION
- RISK RULES
- QUESTION PLANNING
- KNOWLEDGE SEARCH
- LLM CALL (STRICT JSON)
- OUTPUT VALIDATION
- BRIEF MERGE
06 / System Architecture
Khám phá kiến trúc hệ thống.
Chọn một node để xem mô tả, trách nhiệm và module liên quan; các đường nối liên quan được làm nổi bật.
ARCHITECTURE / WRK-003FROM SOURCE CODE
SELECTED NODE
SIGNAL EXTRACTOR
Trích tín hiệu từ tin nhắn: hệ thống, dữ liệu, timeline, yêu cầu báo giá…
Responsibilities
- Không tốn token
Related modules
07 / System Modules
Các module nghiệp vụ trong hệ thống.
Mỗi module có trạng thái riêng; không mặc định tất cả đã triển khai hoàn chỉnh.
-
MOD-01IMPLEMENTED
Conversation API
API phiên và lượt chat, gắn phiên với thiết bị.
Responsibilities
- POST /sessions
- POST /sessions/{id}/consult
- GET /sessions/{id}
- Quick replies
Business rules
- Phiên chỉ dùng được từ thiết bị đã tạo
- Chặn khi vượt giới hạn lượt / token
Data entities
- ConsultSession
- ConsultTurn
Technical preview
- SESSION
- TURN
- RESPONSE
SOURCE / ai-consultant/src/Http/Controllers/AiConsultantController.php
Conversation API
API phiên và lượt chat, gắn phiên với thiết bị.
Responsibilities
- POST /sessions
- POST /sessions/{id}/consult
- GET /sessions/{id}
- Quick replies
Business rules
- Phiên chỉ dùng được từ thiết bị đã tạo
- Chặn khi vượt giới hạn lượt / token
Data entities
- ConsultSession
- ConsultTurn
Technical preview
- SESSION
- TURN
- RESPONSE
SOURCE / ai-consultant/src/Http/Controllers/AiConsultantController.php
08 / Engineering Decisions
Những quyết định kỹ thuật quan trọng.
- IMPLEMENTED / EVIDENCE IN CODE
- Có thể đối chiếu trong mã nguồn.
- DOCUMENTED DECISION
- Quyết định được ghi nhận trong tài liệu thiết kế hệ thống.
- DESIGN DIRECTION
- Định hướng thiết kế của hệ thống.
ADR-001Structured brief instead of chat memory
IMPLEMENTED / EVIDENCE IN CODE
- CONTEXT
- Hội thoại nhiều lượt cần nhớ thông tin khách đã cung cấp.
- PROBLEM
- Dựa vào lịch sử chat khiến model dễ quên hoặc bịa.
- DECISION
- Lưu brief theo trường với trạng thái, nguồn và lịch sử; model chỉ đề xuất cập nhật.
- RATIONALE
- Brief kiểm soát được và chuyển giao được.
- TRADE-OFFS
- Cần định nghĩa danh mục trường.
- RELATED MODULES
- EVIDENCE
- ai-consultant/config/brief-fields.php
ADR-002Validate every model output
IMPLEMENTED / EVIDENCE IN CODE
- CONTEXT
- Model có thể tạo câu không có căn cứ.
- PROBLEM
- Cam kết giá, %, hoặc nhận đã làm cho khách hàng.
- DECISION
- OutputValidator cắt câu vi phạm và yêu cầu trích dẫn cho fact.
- RATIONALE
- Giảm rủi ro cam kết sai.
- TRADE-OFFS
- Có thể cắt cả câu hợp lệ trong trường hợp biên.
- RELATED MODULES
- EVIDENCE
- ai-consultant/src/Chat/OutputValidator.php
ADR-003Rules before the model
IMPLEMENTED / EVIDENCE IN CODE
- CONTEXT
- Nhiều quyết định không cần AI.
- PROBLEM
- Gọi model cho mọi thứ tốn chi phí và khó kiểm soát.
- DECISION
- SignalExtractor, RiskRules, QuestionPlanner chạy trước, không tốn token.
- RATIONALE
- Hành vi dự đoán được, chi phí thấp hơn.
- TRADE-OFFS
- Quy tắc cần bảo trì khi đổi nghiệp vụ.
- RELATED MODULES
- EVIDENCE
- ai-consultant/src/Rules/
ADR-004Privacy by default
IMPLEMENTED / EVIDENCE IN CODE
- CONTEXT
- Tin nhắn có thể chứa dữ liệu cá nhân.
- PROBLEM
- Gửi và lưu dữ liệu cá nhân không cần thiết.
- DECISION
- Che SĐT, email trước khi gửi model và lưu; mã hóa liên hệ chuyển giao.
- RATIONALE
- Giảm dữ liệu nhạy cảm lưu trữ.
- TRADE-OFFS
- Kỹ sư cần quyền giải mã khi xem chuyển giao.
- RELATED MODULES
- EVIDENCE
- ai-consultant/src/Support/Pii.php
ADR-005Hard limits
IMPLEMENTED / EVIDENCE IN CODE
- CONTEXT
- Chi phí phụ thuộc số lượt, token.
- PROBLEM
- Lạm dụng hoặc hội thoại dài làm tăng chi phí.
- DECISION
- Giới hạn lượt, token, phiên mỗi ngày và rate limit theo IP.
- RATIONALE
- Chi phí dự đoán được.
- TRADE-OFFS
- Hội thoại dài hợp lệ có thể bị chặn.
- RELATED MODULES
- EVIDENCE
- ai-consultant/config/ai-consultant.php
09 / Technology Stack
Nền tảng công nghệ sử dụng.
Chỉ liệt kê công nghệ đã biết chắc cho dự án; hạ tầng chỉ hiển thị khi có dữ liệu xác thực.
- Backend
- Laravel 8
- PHP 7.4
- Frontend
- Blade partial
- JavaScript
- Database
- MySQL
- SQLite in-memory (test)
- AI
- OpenAI API qua HTTP client
- Strict JSON schema
- Tool calling (1 tool)
- Testing
- PHPUnit (Unit + Feature, OpenAI giả lập)
- Infrastructure
Chạy bên trong ứng dụng Laravel của website; không có service riêng.
LARAVEL APPLICATION · AI CONSULTANT MODULE
- CONTROLLER
- RULES
- CONSULT SERVICE
- MODELS
10 / Implementation Process
Quá trình phát triển hệ thống.
Các giai đoạn phát triển hệ thống.
STAGE_01
Business Analysis
Objectives
- Hiểu nghiệp vụ và mục tiêu.
Technical scope
- Phỏng vấn người dùng
- Mô tả quy trình
Deliverables
- Danh sách yêu cầu
11 / Project Status
Trạng thái phát triển và phạm vi hệ thống.
CURRENT STATUS
PROTOTYPE
Module PHP của hệ thống (bản chuyển thể cho tư vấn giải pháp công nghệ) có trong mã nguồn website ASolution, thư mục ai-consultant/, kèm test tự động. Chưa vận hành như sản phẩm thương mại.
VERIFIED RESULTS
Hiệu quả được đánh giá theo phạm vi chức năng và mục tiêu vận hành của từng giai đoạn triển khai.
- VISIBILITY
- TECHNICAL REFERENCE
- CLIENT
- Không công bố
-
Conversation API
IMPLEMENTEDAPI phiên, lượt chat, chuyển giao.
EVIDENCE / ai-consultant/routes/api.php
-
Rules Engine
IMPLEMENTEDTín hiệu, rủi ro, câu hỏi.
EVIDENCE / ai-consultant/src/Rules/
-
Output Validator
IMPLEMENTEDKiểm tra câu trả lời.
EVIDENCE / ai-consultant/src/Chat/OutputValidator.php
-
Database Schema
IMPLEMENTED3 bảng sessions, turns, handoffs.
EVIDENCE / ai-consultant/database/migrations/
-
Automated Tests
IMPLEMENTEDUnit + Feature test với OpenAI giả lập.
EVIDENCE / ai-consultant/tests/
-
Production Operation
IN SCOPEVận hành với khách hàng thật.
12 / Engineering Learnings
Những vấn đề kỹ thuật đáng chú ý.
Ghi nhận ở mức quan sát kỹ thuật, không phải bài học chính thức của đội ngũ dự án.
OBS_01
Determinism matters
Phần quyết định được bằng quy tắc nên làm bằng quy tắc; model dùng cho phần ngôn ngữ.
OBS_02
State over memory
Brief có cấu trúc đáng tin hơn việc để model tự nhớ lịch sử.
OBS_03
Guard the output
Kiểm tra đầu ra là lớp bảo vệ cần thiết khi AI nói chuyện trực tiếp với khách.
14 / PROJECT CONSULTATION
REFERENCE / WRK-003 HỆ THỐNG AI TƯ VẤN KHÁCH HÀNG
BẠN MUỐN XÂY DỰNG MỘT HỆ THỐNG TƯƠNG TỰ?
Chia sẻ nhu cầu quản trị, quy trình và hệ thống hiện tại. AI Consultant sẽ giúp bạn làm rõ yêu cầu và đề xuất hướng triển khai phù hợp.
Case study này và các module bạn chọn được gửi kèm làm ngữ cảnh. Không nhập dữ liệu cá nhân hoặc bí mật kinh doanh.
ASL / NEW_PROJECT
TỪ BÀI TOÁN NGHIỆP VỤ ĐẾN KIẾN TRÚC HỆ THỐNG.
ASolution có thể cùng bạn phân tích yêu cầu, thiết kế kiến trúc và xây dựng giải pháp công nghệ phù hợp với doanh nghiệp.
CASE REFERENCE
- PROJECT
- WRK-003
- STATUS
- PROTOTYPE
- MODULES
- 7
- DECISIONS
- 5
NEXT ACTION / CONSULT
Tóm tắt dữ liệu case study, không phải trạng thái hệ thống thời gian thực.