Giao diện
🤖 Trợ lý AI Chat
TKHQ tích hợp chatbot hải quan trả lời câu hỏi quy định, gợi ý mã HS, và tạo nháp tờ khai từ chứng từ đính kèm — phản hồi dưới 3 giây, hoạt động 24/7.
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
TKHQ tích hợp trợ lý AI chuyên ngành hải quan — bạn hỏi bằng tiếng Việt thông thường, hệ thống tra cứu knowledge base nghiệp vụ và trả lời ngay trong cùng hội thoại.
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 |
| Kiểm tra trước khi nộp | Rà soát một tờ khai cụ thể, liệt kê vấn đề cần xử lý trước khi nộp |
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ừ
TKHQ cho phép đính kèm chứng từ trực tiếp vào chat — AI đọc nội dung file và trả lời câu hỏi cụ thể về hàng hóa, số lượng, giá trị ngay trong hội thoại.
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
TKHQ hỗ trợ tạo nháp tờ khai ngay từ chat — đính kèm Invoice và Packing List, gõ yêu cầu, AI trích xuất dữ liệu và điền vào form tờ khai để bạn xem lại trước khi lưu.
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 file Excel
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 Excel
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.
✅ Kiểm tra tờ khai trước khi nộp
Trợ lý có thể rà soát một tờ khai cụ thể và chỉ ra vì sao nó chưa nộp được. Hỏi trong hội thoại, ví dụ: "Vì sao tờ khai 12345 chưa nộp được?" hoặc "Kiểm tra tờ khai [số] giúp tôi". Trợ lý tìm đúng tờ khai theo số (hoặc mã) rồi trả về danh sách các vấn đề — cảnh báo và điểm chặn — cần xử lý trước khi nộp.
Chỉ rà soát tờ khai bạn được xem
Trợ lý chỉ kiểm tra tờ khai trong phạm vi bạn được phép xem. Nếu số tờ khai không thuộc phạm vi của bạn, trợ lý báo "Không tìm thấy tờ khai" — giống hệt khi tờ khai không tồn tại, không lộ thông tin ngoài phạm vi.
🔗 Hỏi AI theo ngữ cảnh
Trên trang chi tiết tờ khai, booking và lô hàng có nút "Hỏi AI". Bấm nút → trợ lý mở ra kèm một thẻ ngữ cảnh ghim phía trên ô soạn tin (không phải điền sẵn vào ô nhập) — AI biết bạn đang hỏi về đối tượng nào xuyên suốt nhiều lượt hỏi đáp trong cùng hội thoại, không cần nhắc lại. Muốn đổi chủ đề, bấm dấu x trên thẻ để gỡ ngữ cảnh.
Số container bấm được
Khi câu trả lời của AI có nhắc số container (dạng chuẩn ISO, ví dụ ABCU1234567), số đó tự động trở thành link — bấm vào để mở trang tìm kiếm đúng container.
Thẻ lô hàng / booking do AI nhắc tới
Ở một số workspace, khi trợ lý chủ động tra cứu dữ liệu (ví dụ tự tìm lô hàng/booking liên quan trong lúc trả lời), câu trả lời có thể kèm thẻ đối tượng bấm được để mở thẳng trang chi tiết. Tính năng này đang triển khai/bật dần theo workspace — nếu chưa thấy thẻ trong câu trả lời, trợ lý vẫn hoạt động bình thường ở chế độ hỏi đáp thông thường.