Giao diện
🤖 Trợ lý AI Chat
Trợ lý AI 24/7 — hỏi về quy định hải quan, tra cứu mã HS, điền form, tạo tờ khai từ chứng từ đính kèm. Route: /chat.
💡 Tổng quan
Trợ lý AI TKHQ là chatbot chuyên ngành hải quan và logistics — hiểu ngữ cảnh tiếng Việt, tra cứu biểu thuế, giải thích quy định, hỗ trợ điền tờ khai.
Khả năng:
| Tính năng | Mô tả |
|---|---|
| Hỏi đáp quy định | Tra cứu quy định hải quan, thuế suất, chính sách |
| Tra cứu mã HS | Gợi ý mã HS từ mô tả hàng hóa |
| Điền form | Hỗ trợ điền từng trường tờ khai |
| Phân tích chứng từ | Đọc file đính kèm, trả lời câu hỏi về nội dung |
| Tạo tờ khai | Từ chứng từ đính kèm → điền tự động tờ khai |
Luồng hội thoại:
Người dùng nhắn tin → AI hiểu ngữ cảnh → Tra cứu knowledge base → Trả lời + gợi ý action
Chi phí token
Chat AI tiêu thụ ~200 token/lượt hỏi đáp đơn giản. Câu hỏi phức tạp hoặc có file đính kèm có thể tốn hơn. Xem số dư token ở thanh trên cùng màn hình.
💬 Quản lý hội thoại
Mỗi cuộc hội thoại được lưu trong sidebar trái của trang /chat.
Thao tác:
- Hội thoại mới — click
+để bắt đầu chat mới (context độc lập) - Đổi tên — double-click tên hội thoại để đổi tên
- Xóa — hover → icon thùng rác → xác nhận xóa
- Tìm kiếm — ô tìm kiếm trên sidebar chat để tìm hội thoại cũ
Lịch sử hội thoại:
| Trường | Mô tả |
|---|---|
| Tiêu đề | Auto-generate từ câu hỏi đầu tiên |
| Ngày tạo | Timestamp tạo hội thoại |
| Số token dùng | Tổng token tiêu thụ trong hội thoại |
| Trạng thái | Active / Archived |
Context liên tục
AI nhớ toàn bộ lịch sử trong cùng một hội thoại. Nếu muốn bắt đầu chủ đề mới độc lập, tạo hội thoại mới thay vì tiếp tục hội thoại cũ.
📎 Đính kèm chứng từ
Upload file trực tiếp vào chat — AI đọc và trả lời câu hỏi về nội dung.
Định dạng hỗ trợ: PDF, JPEG, PNG, TIFF (tối đa 20MB/file, 5 file/lượt)
Cách dùng:
- Click icon đính kèm (paperclip) hoặc kéo thả file vào khung chat
- File upload và AI bắt đầu đọc
- Hỏi câu hỏi về nội dung file: "Tổng giá trị Invoice này là bao nhiêu?", "Mô tả hàng hóa trong Packing List?"
Chi phí OCR
Trích xuất file đính kèm tốn ~1.500 token/trang PDF hoặc ảnh phức tạp. File text thuần (PDF có text layer) tốn ít hơn.
📋 Tạo tờ khai từ chat
AI có thể tạo nháp tờ khai trực tiếp từ chứng từ đính kèm trong chat.
Các bước:
- Đính kèm Invoice + Packing List (hoặc B/L) vào chat
- Gõ: "Tạo tờ khai nhập khẩu từ chứng từ này"
- AI phân tích và điền vào form tờ khai
- Xem lại nháp → click Mở tờ khai để chỉnh sửa thêm
- Lưu và xuất XML
Luồng tạo tờ khai từ chat:
Đính kèm chứng từ → Yêu cầu tạo tờ khai → AI extract data → Điền form → Xem lại → Lưu nháp → Xuất XML
Kiểm tra lại bắt buộc
AI điền dựa trên dữ liệu trích xuất — có thể sai ở trị giá hải quan, đơn vị tính, mã HS phức tạp. Luôn review trước khi submit lên cổng HQ.
