The Context Layer is a prerequisite for using Ask Anything. The more complete and accurate your context, the better ClarityQ’s answers will be.
What’s in the Context Layer?
The Context Layer is made up of six components:Table Catalog
A live inventory of the tables and columns in your data warehouse. ClarityQ automatically discovers and indexes your schema.
Event Catalog
A catalog of product events, parameters, and user properties — synced from your analytics tracking and mapped to the semantic catalog.
Semantic Catalog
The core business logic layer. Define metrics, events, segments, and dimensions that reflect how your organization measures and analyzes data.
Memory
Persistent context that ClarityQ retains across conversations — at the personal and product level.
Skills
Reusable analysis methodologies that guide the AI agent through complex, multi-step workflows consistently.
Files
Documents, spreadsheets, and images you upload so the agent can draw on knowledge that doesn’t live in your warehouse.
Recommended Build Order
The components build on each other. Follow this order for the best results:1
Table Catalog
Once you’ve connected your data warehouse, choose which tables ClarityQ can use. Open Add Tables to the Context from the Table Catalog and pick them. ClarityQ then profiles those tables and suggests descriptions for you to review, and you build entities from them.
2
Event Catalog
If your product tracks events (e.g., via Mixpanel, Amplitude, or custom tracking), set up the Event Catalog. Use the Missing Description Wizard to fill in gaps, then sync events to the Semantic Catalog.
3
Semantic Catalog
This is where you define business logic. Create entities, dimensions, metrics, events, and segments that map to how your team actually talks about data. ClarityQ’s AI agent actively helps build these components — leveraging your existing definitions, documentation, and data structure.
4
Memory
Add the knowledge that doesn’t live in your database — business rules, naming conventions, domain-specific context. Memory improves answer quality over time.
5
Skills
Once your team has established repeatable analysis patterns, encode them as skills. The agent will follow these step by step for consistent, high-quality results.