Cộng thêm một khả năng mà tra cứu thông thường gộp làm một: hệ thống phân biệt được văn bản không có trong kho · có tên nhưng chưa có nội dung · có nội dung nhưng đã hết hiệu lực — ba tình huống đòi ba cách trả lời khác nhau.

Giải pháp kỹ thuật

Kho tri thức: 19.577 văn bản pháp luật · 94.927 điều khoản đã nhúng vector 100%, cộng 2.046 quan hệ vòng đời giữa các văn bản (844 thay thế · 673 sửa đổi · 467 bãi bỏ · 62 bổ sung). (Đếm trực tiếp trên Neo4j ngày 01/09/2026. Kho còn 4.450 node dạng stub — chỉ có số hiệu, chưa có nội dung — đã tách khỏi con số trên; tổng node Document là 24.027.)

Ba đường truy xuất chạy song song rồi hợp nhất:

• BM25 (bm25s) — bắt câu hỏi nêu từ khoá cụ thể.
• Vector — BAAI/bge-m3, 1024 chiều, cosine. Chỉ mục vector nằm trên chính node Neo4j, không tách ra một vector DB riêng, nên một truy vấn Cypher lấy được cả điều khoản gần nghĩa lẫn vị trí của nó trong chuỗi vòng đời văn bản. Đây là điểm kiến trúc khó sao chép nhất, không phải mô hình AI.
• Knowledge graph — quan hệ vòng đời (REPLACED_BY, AMENDED_BY, ABOLISHED_BY, SUPPLEMENTED_BY) và dẫn chiếu điều khoản.

Ba kết quả hợp nhất bằng RRF (k = 60) cộng recency boost α = 0,15, khử trùng theo provision_id, cắt theo ngân sách 8.000 token, TOP_K_FINAL = 10.

Trên đó là agent LangGraph chạy vòng công cụ ReAct với hai công cụ được nối vào vòng (search_tax_hybrid, search_document_history), tối đa 6 bước; hụt bước thì lùi về đường tra cứu một lượt thay vì treo. Trong src/agents/tools/ còn 4 hàm @tool khác dùng ở các đường gọi trực tiếp, không nằm trong vòng ReAct.

Cuối cùng là cổng an toàn fail-closed (src/api/safety.py) — bất biến được khoá bằng test: mọi kết luận thuế phải có ít nhất một trích dẫn còn hiệu lực; văn bản đã hết hiệu lực chỉ được xuất hiện trong warnings, không bao giờ nâng điểm tin cậy và không bao giờ trở thành căn cứ; dưới ngưỡng tin cậy thì trả insufficient_evidence; lỗi tầng dưới thì trả lỗi HTTP, không bao giờ trả một câu trả lời giả.

Stack: FastAPI + Python 3.11 · PostgreSQL 16 (state giao dịch) · Neo4j 5 (graph và vector) · Next.js 16 + React 19 với server proxy giữ JWT trong cookie httpOnly · Docker multi-stage + GitHub Actions · gemma-4 tự host trên GPU L40S, có provider dự phòng.

Tính khả thi — đã đo, đã tái lập được

Truy xuất — eval/results/summary.md, 27/08/2026, commit 0917632, chế độ hybrid, một lệnh cho cả năm bộ:

⚠️ Bộ VLQA cố ý nằm ngoài miền thuế. Nó đo năng lực truy xuất và trích dẫn, và không kết luận được chất lượng tư vấn thuế. Chúng tôi dùng nó vì nó do người ngoài soạn và có trước hệ thống này — nên nó không thể vô tình chấm điểm cho chính bộ đề của chúng tôi. Đó là lựa chọn phương pháp luận, không phải một con số về thuế.

Độ bền — 57 câu, đo hệ thống có biết lúc nào KHÔNG nên trả lời không:

Hành vi — BASELINE_hanh_vi.md, 25/08/2026 (mẫu số ghi rõ từng dòng):

Kỹ thuật: 100 pull request đã merge · 3.939 test tự động. (Lượt chạy đầy đủ gần nhất 01/09/2026: 3.814 pass · 120 skip · 3 fail — hai fail là phép kiểm môi trường của lane phát triển, một đã sửa trong cùng ngày.)

Sản phẩm đang chạy công khai tại p-185.drakefamtax.id.vn, có đăng nhập Google.

Giới hạn đã biết

Ghi ra để người đọc không phải tự phát hiện:

• Quan hệ thay thế giữa Luật Quản lý thuế 2019 và 2025 chưa được dựng trong graph. Phát hiện ngày 01/09/2026: 38/2019/QH14 vẫn mang trạng thái Còn hiệu lực và không có cạnh REPLACED_BY nào tới 108/2025/QH15, dù câu văn chứng minh điều đó nằm sẵn trong Điều 52 của luật mới. Đây đúng lớp lỗi mà sản phẩm này tồn tại để chữa, và nó cho thấy vì sao hiệu lực phải là một quan hệ suy ra được, không phải một trường do nguồn tự khai. Đang sửa.
• Nhóm câu hỏi tình huống (case_study, 7 câu) đạt R@5 = 0,000, và "đúng văn bản" chỉ 0,286 — tức chưa tìm ra đúng văn bản, chứ không phải tìm đúng văn bản mà sai điều khoản. Đây là gap thật của tầng truy xuất.
• Bộ câu hỏi vàng do chính nhóm soạn và tự duyệt, chưa có chuyên gia thuế xác nhận đáp án. Đây là cổng nghiệm thu duy nhất không thể đóng bằng mã — và là điều chúng tôi đang tìm người giúp.
• 4.450 văn bản trong kho ở dạng stub — có số hiệu, chưa có nội dung. Chúng không được dùng làm căn cứ, nhưng chúng có mặt trong đồ thị quan hệ.
• Số hiệu văn bản không còn là khoá duy nhất: 2.225 số hiệu bị nhiều văn bản dùng chung (chủ yếu là văn bản của các địa phương khác nhau). Mọi phép đối chiếu theo số hiệu đều phải kèm ngữ cảnh.
• Tầng kế toán (tính nghĩa vụ thuế kèm công thức và điều khoản làm căn cứ) đang khoá ở trạng thái "sắp ra mắt"; escalation lên chuyên gia còn kích hoạt thủ công.
• Hệ thống không thay thế ý kiến tư vấn pháp lý chính thức, không tự kê khai hay nộp thuế thay người dùng, và không tư vấn cách lách thuế.

Hướng phát triển

1. Đóng cổng nghiệm thu bằng người — mời một chuyên gia thuế rà và ký tên vào bộ câu hỏi chuẩn. Đây là việc chặn mọi con số phía sau, và là việc duy nhất trong danh sách này không làm được bằng mã.
2. Suy quan hệ vòng đời từ chính câu văn điều khoản thi hành, thay vì chỉ đọc trường trạng thái do nguồn tự khai — trường đó có thể sai, và chúng tôi đã đo được nó sai.
3. Đo người quay lại — tỉ lệ quay lại 30 ngày, và số lượt tra mỗi kỳ khai thuế của một tài khoản. Luận điểm của chúng tôi là nhu cầu lặp theo lịch (hạn nộp tờ khai tháng là ngày thứ 20 của tháng sau — 252/2026/NĐ-CP Điều 10), nên con số thứ hai phải nhảy quanh ngày 20 hằng tháng. Nếu nó không nhảy, luận điểm của chúng tôi sai.
4. Máy tính thuế — mở tầng kế toán: kết quả kèm công thức và điều khoản làm căn cứ, không phải một phép nhân trong trình duyệt.
5. Định tuyến theo miền — dữ liệu đã chỉ rõ vì sao cần: knowledge graph thắng khi câu hỏi nêu số hiệu (0,500 trên bộ external) nhưng gần vô dụng với câu hỏi tự nhiên (0,047 trên VLQA); BM25 thì ngược lại (0,643 trên VLQA).
6. Thương mại hoá — 859.048 doanh nghiệp đang hoạt động (cuối 2025) và khoảng 5,3 triệu cơ sở kinh doanh cá thể, tất cả tra cứu cùng một hệ thống văn bản đang thay đổi. Mô hình: 500.000đ/ghế/tháng cho phòng kế toán và đại lý thuế — giá trị đo bằng rủi ro truy thu tránh được, và một lần tránh được bằng khoảng 25 năm thuê bao. Giai đoạn 2 có bản on-premise cho khách hàng có yêu cầu bảo mật.

3 · Nguồn của từng con số