ABOUT / PRODUCT TRUTH

VDaAgent biến profiling
thành nền tảng phân tích.

Đây là workspace dành cho Analyst muốn biết dữ liệu có gì, kết quả đến từ đâu và insight được hỗ trợ bởi bằng chứng nào.

CAPABILITIES

Một workspace,
nhiều lớp kiểm chứng.

Các nhóm dưới đây phản ánh những gì sản phẩm hiện hỗ trợ.

01

Dataset & nguồn dữ liệu

Tải CSV, TSV, Parquet hoặc JSON; kết nối MongoDB Atlas qua datasource đã kiểm tra. Khi Workspace dùng Google Drive làm storage provider, nút OAuth kết nối xuất hiện trước khi upload và file được lưu ở Drive.

02

Profiling

Profile Run tính schema, kiểu dữ liệu, số dòng/cột, null rate, cardinality, uniqueness, top values, thống kê mô tả, outlier, duplicate rows, correlation và cảnh báo chất lượng.

03

Review proposal

Candidate key, semantic type và PII là các proposal có thể cần Analyst xác nhận. Chọn xác nhận, từ chối hoặc chỉnh sửa (kèm lý do khi chỉnh sửa) trước khi pipeline tiếp tục.

04

Command Center

Đặt câu hỏi phân tích, tạo plan, chạy Preview bounded, xem visualization và Promote thành Official Evidence sau khi kiểm tra kết quả và limitations.

05

Insight Agent

Hỏi đáp trong phạm vi Profile Run đã chọn. Agent diễn giải evidence được cấp; engine deterministic mới là nơi tính số liệu, không phải LLM.

06

Compare

Chọn hai Profile Run đã completed làm Baseline và Current để xem aggregate signal về thay đổi phân phối, chất lượng hoặc cấu trúc; kết quả hiển thị severity theo cột.

07

Report

Ghim Official Evidence hoặc reviewed insight vào Report Draft, sắp xếp và thêm ghi chú, tạo Snapshot bất biến, xem Preview và xuất PDF. Draft là bản chỉnh sửa; Snapshot là phiên bản cố định để chia sẻ và export.

08

Workspace & audit

Dataset, Profile Run, evidence, report và hoạt động được scope theo Workspace. Thành viên, invitation và quyền truy cập được backend kiểm tra.

ARCHITECTURE

Luồng kỹ thuật
theo từng lớp.

Frontend gọi API; API xác thực Workspace và điều phối engine, worker, persistence và LLM ở đúng ranh giới.

FrontendNext.js · React · TypeScript
APIFastAPI · Pydantic · SQLAlchemy
Compute / workerProfiling worker · DuckDB · pandas · NumPy · SciPy · statsmodels · scikit-learn
PersistencePostgreSQL / Supabase · Storage
LLM layer, khi phù hợp

LangGraph / LangChain hỗ trợ planner và Agent runtime. Chỉ metadata đã được giới hạn được đưa vào lớp này; không có arbitrary code, raw-row explorer hay arbitrary SQL trong UI.

DESIGN PRINCIPLES

Vì sao workflow
được tách lớp?

Deterministic compute ≠ LLM

Engine thực hiện metric và phân tích bounded. LLM hỗ trợ lập kế hoạch, diễn giải và hỏi đáp; nó không thay thế phép tính.

Preview → Official Evidence

Preview là kết quả exploratory có thể hết hạn hoặc approximate. Promote sẽ revalidate và lưu result hash, context và provenance.

Traceability

Kết quả gắn với Dataset, Profile Run, QuerySpec/context và Workspace để Analyst biết nguồn và phạm vi của kết luận.

Human-in-the-loop

Analyst review proposal, kiểm tra visualization, review insight và quyết định nội dung report. AI hỗ trợ, không thay thế vai trò này.

Workspace isolation

Backend xác minh identity, membership và capability trên request được bảo vệ; frontend chỉ là lớp UX.