How it works
A combination of deep data evaluations with actionable workflows across four progressive stages to ensure your data models are production-ready.Health dimensions
Domain Health evaluates three dimensions:
- Schema quality assesses whether the domain’s table and column definitions are clear and usable. It flags cryptic or ambiguous names, overlapping names that lack descriptions, and missing join relationships between tables that are commonly queried together.
- Context quality re-runs your Reviewed Queries through the system and evaluates whether the generated SQL matches expected output. The Context Quality Agent diagnoses root causes, knowledge conflicts, stale definitions, contradictions and proposes specific fixes.
- Usage signals track conversation volume, negative feedback rate, and limited-context rate.
Running an analysis
Click Run Analysis in the Domain Health tab. Use this before a planned rollout or after a significant domain change.
Recommendations
After each analysis, WisdomAI surfaces a prioritized list of specific actions:
Each recommendation can be accepted (applied immediately) or declined (dismissed for 90 days).
| Priority | What it covers |
|---|---|
| HIGH | Direct SQL or knowledge fixes with a measurable impact on eval scores |
| MEDIUM | Knowledge additions for uncovered tables or ambiguous definitions |
| LOW | Hygiene improvements such as adding descriptions or renaming columns |
Target users
Domain Health is available to:- Domain Admins: Run analyses, review recommendations, and monitor scores over time.
- Explorers and Analysts: See the readiness banner and Learning chip when a domain is below threshold. No action required.
FAQs
How often does the automated health check run?
How often does the automated health check run?
Analysis runs are currently triggered manually from the Domain Health tab. Automated weekly runs are on the near-term roadmap.
Does accepting a recommendation apply changes immediately?
Does accepting a recommendation apply changes immediately?
Yes. The change takes effect on the next query.
My domain has no Reviewed Queries. What happens to the context quality score?
My domain has no Reviewed Queries. What happens to the context quality score?
Without Reviewed Queries, context quality cannot be measured. Adding and reviewing queries is the primary way to improve this score.
What's the difference between schema quality and context quality?
What's the difference between schema quality and context quality?
Schema quality evaluates the structural layer, whether names are clear, joins are defined, and tables are accessible. Context quality evaluates the knowledge layer, whether the domain’s curated content produces correct answers on queries it has been taught.
Does Domain Health work for MCP data sources?
Does Domain Health work for MCP data sources?
Support for MCP sources is on the near-term roadmap. The current release covers SQL-based domains.
What is the Learning chip?
What is the Learning chip?
A small chip displayed next to a domain name in the selector dropdown when the domain’s health score is below the production-ready threshold.
Next steps
Advanced data modeling
Learn how to add the metrics, joins, and context that improve your schema and context quality scores.
Context Builder - Connections
Keep your domain’s knowledge layer synchronized automatically as your source systems change.