Trang quản lý kho tri thức (MinIO) cho hệ thống trợ lý ảo SCADA: xem/thêm/tải/xóa tài liệu và chạy pipeline RAG (tạo embeddings) để trợ lý ảo tra cứu được tài liệu.
1. Giới thiệu
Ứng dụng có 2 phần chính:
- Quản lý tài liệu (Knowledge Bases): các tài liệu đã nạp vào hệ thống RAG, kèm trạng thái xử lý.
- Duyệt MinIO: xem trực tiếp file trong 2 kho lưu trữ:
knowledge-base (file gốc PDF/CSV/XLSX) và
images (ảnh tách từ tài liệu để hiển thị minh chứng).
Phân biệt hai khái niệm: upload (đưa file lên kho) và chạy pipeline (xử lý file để trợ lý ảo dùng được). Upload xong chưa đủ — cần chạy pipeline.
2. Đăng nhập
1
Mở https://minio-manager.visca.live. Nếu chưa đăng nhập, hệ thống hiện trang đăng nhập.
2
Nhập Tài khoản và Mật khẩu (do quản trị viên cấp), bấm Đăng nhập (hoặc nhấn Enter).
3
Đăng nhập thành công → vào trang quản lý. Phiên đăng nhập được giữ; lần sau mở lại vào thẳng.
Đăng xuất: bấm nút Đăng xuất ở góc phải trên. Nếu phiên hết hạn, hệ thống tự đưa về trang đăng nhập.
3. Quản lý tài liệu (Knowledge Bases)
Bảng liệt kê các tài liệu đã nạp, gồm:
| Cột | Nghĩa |
|---|
| Tên / Mô tả | Tên và mô tả tài liệu. |
| scope | Loại kho: chatbot (tài liệu thường) hoặc error_fix (bảng mã lỗi). |
| Trạng thái | Xem bảng bên dưới. |
| File (MinIO) | Tên file gốc trong kho MinIO. |
Ý nghĩa trạng thái:
- READY — đã xử lý xong, trợ lý ảo tra cứu được.
- IN_QUEUE / PROCESSING — đang chờ / đang xử lý.
- FAILED — xử lý lỗi, cần chạy lại pipeline.
- UPLOADED — mới upload, chưa chạy pipeline.
Nút ↻ Tải lại (góc phải khối) làm mới danh sách — dùng sau khi chạy pipeline để xem trạng thái cập nhật.
4. Thêm tài liệu mới
1
Chọn file — hỗ trợ .pdf (tài liệu), .csv / .xlsx (bảng mã lỗi).
2
Chọn scope: chatbot cho tài liệu thường; error_fix cho bảng mã lỗi.
3
Nhập tên tài liệu (bắt buộc) và mô tả (tùy chọn).
4
Bấm Upload. Sau khi xong, tài liệu xuất hiện trong bảng với trạng thái UPLOADED.
⚠️ Upload chưa đủ — phải bấm ▶ Chạy pipeline ở dòng tài liệu đó để hệ thống xử lý (tạo embeddings).
5. Chạy pipeline RAG
Pipeline RAG là bước xử lý tài liệu để trợ lý ảo tra cứu được: đọc file, tách văn bản, tách ảnh, và tạo embeddings lưu vào kho vector.
1
Ở dòng tài liệu, bấm ▶ Chạy pipeline.
2
Xác nhận. Hệ thống gửi tác vụ xử lý (trạng thái chuyển sang IN_QUEUE → PROCESSING).
3
Chờ vài phút (tùy dung lượng tài liệu), bấm ↻ Tải lại để xem trạng thái. Khi READY là hoàn tất.
Chạy lại pipeline cho tài liệu đã có sẽ xử lý lại toàn bộ (ghi đè kết quả cũ). Dùng khi tài liệu FAILED, vừa cập nhật file mới, hoặc cần làm mới embeddings.
⚠️ Với tài liệu lớn (hàng chục MB, nhiều trang), pipeline có thể mất vài phút — vui lòng không tắt trang.
6. Duyệt MinIO (xem / tải / xóa file)
Khối 🗂️ File trong MinIO cho xem trực tiếp nội dung kho lưu trữ:
1
Chọn bucket:
knowledge-base (file gốc) hoặc
images (ảnh tách ra từ tài liệu).
2
Bấm ↻ Liệt kê để hiện danh sách object (tên + kích thước).
3
Mỗi dòng có nút ⬇ Tải (tải file về) và 🗑 Xóa (xóa khỏi kho).
🗑 Xóa file là vĩnh viễn — không hoàn tác được. Ứng dụng luôn hỏi xác nhận trước khi xóa. Cân nhắc kỹ, đặc biệt với file trong knowledge-base.
7. Lưu ý & câu hỏi thường gặp
Upload rồi mà trợ lý ảo chưa trả lời được?
Do chưa chạy pipeline. Vào tài liệu đó → bấm ▶ Chạy pipeline → chờ trạng thái READY.
Xóa tài liệu ở đâu?
Có 2 cách: (1) nút 🗑 Xóa ở dòng tài liệu trong bảng tài liệu — vừa ẩn khỏi danh sách, vừa xóa file gốc; (2) nút 🗑 Xóa trong khối MinIO — chỉ xóa file trong kho (không đụng danh sách tài liệu).
Ảnh minh chứng của trợ lý ảo lấy từ đâu?
Từ bucket images — đây là ảnh được tách tự động khi chạy pipeline. Có thể xem/tải trong khối MinIO (bucket images).
Đăng nhập bằng tài khoản nào?
Tài khoản do quản trị viên cấp. Nếu quên, liên hệ quản trị hệ thống.
Phiên đăng nhập hết hạn?
Hệ thống tự đưa về trang đăng nhập. Đăng nhập lại là tiếp tục.
Phiên bản tài liệu: 2026-10-05 · Hệ thống trợ lý ảo SCADA.