Làm theo trình tự dưới đây trong Workspace. Khi gặp thuật ngữ hoặc metric, mở Documentation để tra cứu.
Đăng nhập, chọn hoặc tạo Workspace, rồi mở các khu vực Dataset, Profile Run, phân tích, Compare và Reports. Dataset là nguồn dữ liệu; Profile Run là một phiên profiling gắn với dataset và là context trung tâm cho chart, Agent, compare và report.
Trong luồng Dataset mới, nếu provider yêu cầu, chọn Kết nối Google Drive. Cho phép OAuth trong tab Google mới rồi quay lại tab upload; kết nối được scope theo Workspace và chỉ cần thực hiện một lần. Nếu popup bị chặn hoặc Workspace chưa bật provider, hãy cho phép popup/liên hệ quản trị viên. Drive là lớp lưu trữ/kết nối của luồng upload hiện có, không phải một màn hình query Google Drive riêng.
Từ Dataset mới, chọn MongoDB Atlas và tạo connection. Dán URI dạng mongodb+srv://… (dùng placeholder, không chia sẻ secret), nhập đúng database rồi bấm Kiểm tra kết nối. Sau khi kiểm tra thành công, chọn collection từ danh sách; nếu cần, nhập Filter JSON (mặc định {}) rồi kết nối. Credential được giữ ở backend; đặt tên dataset và tiếp tục profiling. Lỗi thường gặp là URI sai, IP allowlist, quyền database hoặc collection không tồn tại.
Chọn File từ máy, kéo thả một hoặc nhiều file (hoặc thư mục) có đuôi CSV, TSV, Parquet hoặc JSON. Upload xong, nhập tên dataset. File không được hỗ trợ sẽ bị bỏ qua và UI báo rõ; không có bước làm sạch dữ liệu tự động trong luồng này.
Chọn scan full hoặc sample (sample được đánh dấu approximate/uncertainty), sau đó bấm profiling. Hệ thống tạo Dataset → Profile Run → profiling job; job chạy bất đồng bộ qua worker. Job status có thể là queued, running, succeeded hoặc failed; Profile Run status có thể là created, pending_review, resuming, completed, failed hoặc cancelled. Mở Profile Run để theo dõi kết quả.
Proposal là gợi ý metadata (candidate key, semantic type hoặc PII) do pipeline phát hiện. Khi có proposal pending, chọn Xác nhận, Từ chối hoặc Chỉnh sửa phân loại; chỉnh sửa cần giá trị chính thức và lý do. Mỗi proposal phải có quyết định, sau đó chọn Lưu quyết định & tiếp tục. Một số run không có proposal; khi đó UI báo không còn gì cần review và pipeline có thể hoàn tất.
Mở preview của Profile Run đã completed, kiểm tra tóm tắt Agent rồi đi tới không gian phân tích. Nhập câu hỏi phân tích và tạo/chọn plan. Chạy Preview để xem bảng/biểu đồ và limitations; preview là exploratory, không phải evidence bền vững. Kiểm tra cột, aggregation, filter, time grain và phạm vi rồi Promote kết quả phù hợp thành Official Evidence. Official được engine chạy lại, lưu context/result hash và có thể dùng cho Agent/report.
Chọn đúng Profile Run trước khi hỏi. Agent dùng context và Official Evidence được cấp trong run; nó không đọc raw rows và không tự tính lại số liệu. Hãy hỏi cụ thể: “Biến nào liên quan nhất đến X?”, “Có khác biệt đáng kể giữa X và Y không?”, “Nhóm nào đóng góp nhiều nhất vào metric này?”, hoặc “Phân phối thay đổi thế nào so với Profile Run khác?”. Hãy xem insight như diễn giải cần Analyst review; correlation không chứng minh causation.
Vào Compare, cần ít nhất hai Profile Run đã completed. Chọn Baseline (mốc đối chiếu) và Current (phiên cần kiểm tra), rồi chạy so sánh. Kết quả là aggregate evidence theo cột, có signal và severity major/minor. Điều tra thay đổi về dữ liệu, scan mode và chất lượng trước khi kết luận; contract hiện tại không hiển thị raw rows hay phân phối bins chi tiết.
Từ Official Evidence hoặc insight đã review, chọn Ghim vào Báo cáo. Trong report, sắp xếp item, sửa tiêu đề, thêm note và kiểm tra context/limitations. Draft còn chỉnh sửa được; khi nội dung ổn, chọn Hoàn tất & Cập nhật để tạo Snapshot bất biến.
Preview cho thấy report draft/snapshot sẽ được trình bày thế nào. Snapshot là trạng thái đóng băng ưu tiên cho chia sẻ và export; nếu chưa snapshot, UI có thể hiển thị draft theo quy định hiện tại. Tại trang report, chọn Xuất báo cáo PDF để tải file cuối. Kiểm tra tiêu đề, evidence, insight và limitations trước khi tải.
