Bỏ qua tới nội dung chính
ASOLUTION®
[ CONSULT AI ↗ ]

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
SYSTEM MAP / WRK-003
AI CONSULTANT
SIGNALS
RISK RULES
PLANNER
RETRIEVAL
LLM CALL
VALIDATOR
BRIEF & HANDOFF

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

  1. MESSAGE
  2. SIGNAL EXTRACTION
  3. RISK RULES
  4. QUESTION PLANNING
  5. KNOWLEDGE SEARCH
  6. LLM CALL (STRICT JSON)
  7. OUTPUT VALIDATION
  8. BRIEF MERGE

03 / Business Challenges

Những vấn đề hệ thống hướng đến giải quyết.

  1. 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
  2. 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ứ
  3. 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
  4. 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
  5. 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.

05 / Solution Approach

Hướng tiếp cận giải pháp.

  1. 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.

  2. 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.

  3. P-03

    One model call

    Thường chỉ một lần gọi model mỗi lượt với output JSON strict.

  4. 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.

SOLUTION FLOW
  1. MESSAGE
  2. SIGNAL EXTRACTION
  3. RISK RULES
  4. QUESTION PLANNING
  5. KNOWLEDGE SEARCH
  6. LLM CALL (STRICT JSON)
  7. OUTPUT VALIDATION
  8. 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

    1. SESSION
    2. TURN
    3. 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-001

Structured 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-002

Validate 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-003

Rules 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-004

Privacy 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-005

Hard 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.

STACK DIAGRAM
CHAT UI · BLADE / JAVASCRIPT

LARAVEL APPLICATION · AI CONSULTANT MODULE

  • CONTROLLER
  • RULES
  • CONSULT SERVICE
  • MODELS
MYSQL · OPENAI API

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

    API phiên, lượt chat, chuyển giao.

    EVIDENCE / ai-consultant/routes/api.php

    IMPLEMENTED
  • Rules Engine

    Tín hiệu, rủi ro, câu hỏi.

    EVIDENCE / ai-consultant/src/Rules/

    IMPLEMENTED
  • Output Validator

    Kiểm tra câu trả lời.

    EVIDENCE / ai-consultant/src/Chat/OutputValidator.php

    IMPLEMENTED
  • Database Schema

    3 bảng sessions, turns, handoffs.

    EVIDENCE / ai-consultant/database/migrations/

    IMPLEMENTED
  • Automated Tests

    Unit + Feature test với OpenAI giả lập.

    EVIDENCE / ai-consultant/tests/

    IMPLEMENTED
  • Production Operation

    Vận hành với khách hàng thật.

    IN SCOPE

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.

Module quan tâm (tùy chọn)

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.