Data Quality Agent Demo

Overview

Data Quality Agent is an LLM-ready data reliability agent that profiles business CSV exports, runs deterministic quality checks, and returns evidence-backed findings that can be attached to a data incident ticket. The demo uses a support-ticket export with realistic data-quality failures, and the deterministic report detects operational issues before they reach dashboards or downstream analytics. The default engine is deterministic; when an OpenAI-compatible key is configured, the LLM agent can choose a dataset-specific strategy, read structured tool results, re-plan across model calls, and must attach the source-of-truth quality report before finalizing. Beyond CSV upload, the backend includes an optional read-only PostgreSQL adapter for real business tables. It is disabled by default and requires explicit environment configuration before use. The adapter rejects write operations, enforces row limits, sets a statement timeout, and is tested with mocked DB tests. A seeded Postgres demo can be run locally with docker compose up --build. Reports include deterministic verification for evidence support, known field references, sensitive-value leakage, unsupported LLM evidence, action coverage, and score bounds. Each API report returns a trace id for sanitized run review through /runs/{trace_id}, with optional SQLite persistence enabled through TRACE_DB_PATH. The support-ticket snapshot is regenerated by a CI verifier and stored as verified JSON.