The ClarityQ Context Layer teaches the agent how your business thinks about its data: tables, metrics, business terms and rules that keep answers consistent.
The Context Layer is the foundation of ClarityQ. It’s a structured model that bridges the gap between your raw database tables and the business concepts your team uses every day — metrics, events, segments, dimensions, and more.Without a Context Layer, ClarityQ would only see tables and columns. With it, ClarityQ understands what “daily active users” means in your organization, how “churn” is calculated, which events matter, and how your data relates to your business logic.
The Context Layer is a prerequisite for using Ask Anything. The more complete and accurate your context, the better ClarityQ’s answers will be.
The Components
The Context Layer is made up of six components, each serving a distinct purpose:
Table Catalog
The Table Catalog is a live inventory of the tables and columns in your data warehouse. ClarityQ automatically discovers your schema and keeps it up to date through daily discovery jobs. From here, you build entities that feed into the Semantic Catalog.Learn more →
Event Catalog
The Event Catalog maps your product’s tracked events, parameters, and user properties. Events are synced to the Semantic Catalog, where they become queryable business concepts. A built-in Missing Description Wizard helps you fill in gaps across your catalog.Learn more →
Semantic Catalog
The Semantic Catalog is where business logic lives. It contains the components that define how your organization measures and analyzes data:
Entities — Core business objects that represent your data sources (e.g., users, orders, sessions)
Dimensions — Properties used to filter and group data (e.g., country, platform, plan type)
Metrics — Business KPIs and calculations (e.g., revenue, retention rate, conversion)
Events — Tracked user actions synced from raw events in the Event Catalog (e.g., signup_completed, purchase_made), each with its parameters
Segments — Reusable cohort definitions (e.g., power users, churned customers)
ClarityQ’s AI agent actively helps build these components using your existing definitions and data structure.Learn more →
Skills
Skills are reusable analysis methodologies encoded as step-by-step instructions. When invoked, the AI agent follows them precisely — asking clarifying questions, executing the analysis, and validating results. Skills ensure complex workflows run consistently every time.Learn more →
Memory
Memory is persistent context that ClarityQ retains across conversations. It operates at two levels — personal and product — and stores business rules, naming conventions, and domain knowledge that doesn’t live in your database.Learn more →
Files
Files are documents, spreadsheets, and images you upload so the agent can use them — reference data, catalogs you maintain outside the warehouse, or business definitions written down elsewhere. Once described, the agent finds them on its own when they’re relevant.Learn more →
The Table Catalog and Event Catalog feed into the Semantic Catalog — one through entity building, the other through event syncing. Memory and Skills enrich the agent’s understanding and capabilities. Together, they power Ask Anything.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ClarityQ Documentation","colors":{"primary":"#5A57FC","light":"#9391ff","dark":"#5A57FC"},"logo":{"light":"https://mintcdn.com/clarityq/RMDLvxRyN9-VIA7h/logo/light.svg?fit=max\u0026auto=format\u0026n=RMDLvxRyN9-VIA7h\u0026q=85\u0026s=f8d4e57d3c0e50c3f720e5b6a7afef0b","dark":"https://mintcdn.com/clarityq/RMDLvxRyN9-VIA7h/logo/dark.svg?fit=max\u0026auto=format\u0026n=RMDLvxRyN9-VIA7h\u0026q=85\u0026s=f838d08af4bdbf4b9f80be89bbd57203"},"favicon":"https://mintcdn.com/clarityq/RMDLvxRyN9-VIA7h/favicon.svg?fit=max\u0026auto=format\u0026n=RMDLvxRyN9-VIA7h\u0026q=85\u0026s=ccd0c18ac98544dea1c3e42018f2db76","navbar":{"links":[{"href":"mailto:support@clarityq.ai","label":"Support"}]},"footer":{"socials":{"linkedin":"https://linkedin.com/company/clarityq"}},"seo":{"metatags":{"msvalidate.01":"2653DA8E28F50109EA5130713FEE874C"},"indexing":"all"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"clarityq","hasAudioNarration":false,"actualSubdomain":"clarityq","customDomains":["docs.clarityq.ai"],"gitSource":{"type":"github","owner":"clarityq","repo":"clarityq-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afd9ba25e3b11ff7dbe3e94","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Context Layer","count":19},{"language":"default","tag":"Data Warehouse Connections","count":11},{"language":"default","tag":"Integrations","count":11},{"language":"default","tag":"Building the Context Layer","count":10},{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Ask Anything","count":8},{"language":"default","tag":"Administration","count":7},{"language":"default","tag":"Semantic Catalog","count":6},{"language":"default","tag":"Event Catalog","count":5},{"language":"default","tag":"Dashboards","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"context-layer/what-is-the-context-layer","slug":"/context-layer/what-is-the-context-layer","pageMetadata":{"title":"What is the Context Layer?","description":"The ClarityQ Context Layer teaches the agent how your business thinks about its data: tables, metrics, business terms and rules that keep answers consistent.","href":"/context-layer/what-is-the-context-layer"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The ClarityQ Context Layer teaches the agent how your business thinks about its data: tables, metrics, business terms and rules that keep answers consistent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The Context Layer is the foundation of ClarityQ. It’s a structured model that bridges the gap between your raw database tables and the business concepts your team uses every day — metrics, events, segments, dimensions, and more.`}),`\n`,_jsx(_components.p,{children:`Without a Context Layer, ClarityQ would only see tables and columns. With it, ClarityQ understands what “daily active users” means in your organization, how “churn” is calculated, which events matter, and how your data relates to your business logic.`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`The Context Layer is a prerequisite for using Ask Anything. The more complete and accurate your context, the better ClarityQ’s answers will be.`})}),`\n`,_jsx(Heading,{level:`2`,id:`the-components`,children:`The Components`}),`\n`,_jsx(_components.p,{children:`The Context Layer is made up of six components, each serving a distinct purpose:`}),`\n`,_jsx(Heading,{level:`3`,id:`table-catalog`,children:`Table Catalog`}),`\n`,_jsx(_components.p,{children:`The Table Catalog is a live inventory of the tables and columns in your data warehouse. ClarityQ automatically discovers your schema and keeps it up to date through daily discovery jobs. From here, you build entities that feed into the Semantic Catalog.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.a,{href:`/context-layer/table-catalog/what-is-the-table-catalog`,children:`Learn more →`})}),`\n`,_jsx(Heading,{level:`3`,id:`event-catalog`,children:`Event Catalog`}),`\n`,_jsx(_components.p,{children:`The Event Catalog maps your product’s tracked events, parameters, and user properties. Events are synced to the Semantic Catalog, where they become queryable business concepts. A built-in Missing Description Wizard helps you fill in gaps across your catalog.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.a,{href:`/context-layer/event-catalog/what-is-the-event-catalog`,children:`Learn more →`})}),`\n`,_jsx(Heading,{level:`3`,id:`semantic-catalog`,children:`Semantic Catalog`}),`\n`,_jsx(_components.p,{children:`The Semantic Catalog is where business logic lives. It contains the components that define how your organization measures and analyzes data:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Entities`}),` — Core business objects that represent your data sources (e.g., users, orders, sessions)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Dimensions`}),` — Properties used to filter and group data (e.g., country, platform, plan type)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Metrics`}),` — Business KPIs and calculations (e.g., revenue, retention rate, conversion)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Events`}),` — Tracked user actions synced from raw events in the Event Catalog (e.g., `,_jsx(_components.code,{children:`signup_completed`}),`, `,_jsx(_components.code,{children:`purchase_made`}),`), each with its parameters`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Segments`}),` — Reusable cohort definitions (e.g., power users, churned customers)`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`ClarityQ’s AI agent actively helps build these components using your existing definitions and data structure.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.a,{href:`/context-layer/semantic-catalog/what-is-the-semantic-catalog`,children:`Learn more →`})}),`\n`,_jsx(Heading,{level:`3`,id:`skills`,children:`Skills`}),`\n`,_jsx(_components.p,{children:`Skills are reusable analysis methodologies encoded as step-by-step instructions. When invoked, the AI agent follows them precisely — asking clarifying questions, executing the analysis, and validating results. Skills ensure complex workflows run consistently every time.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.a,{href:`/context-layer/skills`,children:`Learn more →`})}),`\n`,_jsx(Heading,{level:`3`,id:`memory`,children:`Memory`}),`\n`,_jsx(_components.p,{children:`Memory is persistent context that ClarityQ retains across conversations. It operates at two levels — personal and product — and stores business rules, naming conventions, and domain knowledge that doesn’t live in your database.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.a,{href:`/context-layer/memory`,children:`Learn more →`})}),`\n`,_jsx(Heading,{level:`3`,id:`files`,children:`Files`}),`\n`,_jsx(_components.p,{children:`Files are documents, spreadsheets, and images you upload so the agent can use them — reference data, catalogs you maintain outside the warehouse, or business definitions written down elsewhere. Once described, the agent finds them on its own when they’re relevant.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.a,{href:`/context-layer/files`,children:`Learn more →`})}),`\n`,_jsx(Heading,{level:`2`,id:`how-the-components-connect`,children:`How the Components Connect`}),`\n`,_jsx(CodeBlock,{numberOfLines:`12`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Data Warehouse`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↓`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Table Catalog ──→ Entities ──→ Semantic Catalog`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↓ ↑`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Event Catalog ─── Sync ───────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↑`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Memory ───── Context ─────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↑`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Skills ───── Workflows ───────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ↓`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Ask Anything`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`The Table Catalog and Event Catalog feed into the Semantic Catalog — one through entity building, the other through event syncing. Memory and Skills enrich the agent’s understanding and capabilities. Together, they power Ask Anything.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"What is the Context Layer?","description":"The ClarityQ Context Layer teaches the agent how your business thinks about its data: tables, metrics, business terms and rules that keep answers consistent.","href":"/context-layer/what-is-the-context-layer"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"The Components","slug":"the-components","depth":2,"children":[{"title":"Table Catalog","slug":"table-catalog","depth":3,"children":[]},{"title":"Event Catalog","slug":"event-catalog","depth":3,"children":[]},{"title":"Semantic Catalog","slug":"semantic-catalog","depth":3,"children":[]},{"title":"Skills","slug":"skills","depth":3,"children":[]},{"title":"Memory","slug":"memory","depth":3,"children":[]},{"title":"Files","slug":"files","depth":3,"children":[]}]},{"title":"How the Components Connect","slug":"how-the-components-connect","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"clarityq","siteName":"ClarityQ Documentation","title":"What is the Context Layer? - ClarityQ Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T11:29:18.507Z","originalFileLocation":"context-layer/what-is-the-context-layer.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The ClarityQ Context Layer teaches the agent how your business thinks about its data: tables, metrics, business terms and rules that keep answers consistent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ClarityQ Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"What is the Context Layer? - ClarityQ Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"The ClarityQ Context Layer teaches the agent how your business thinks about its data: tables, metrics, business terms and rules that keep answers consistent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ClarityQ Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://clarityq.mintlify.site/_mintlify/api/og/v2?division=Context+Layer\u0026amp;title=What+is+the+Context+Layer%3F\u0026amp;description=The+ClarityQ+Context+Layer+teaches+the+agent+how+your+business+thinks+about+its+data%3A+tables%2C+metrics%2C+business+terms+and+rules+that+keep+answers+consistent.\u0026amp;theme=8a1189787dd42c7f361220a1\u0026amp;signature=25f11dc9bd704a6e99937fb00e3c8de65b26d9a4af84d52dd8ba3086d8d34843\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"What is the Context Layer? - ClarityQ Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The ClarityQ Context Layer teaches the agent how your business thinks about its data: tables, metrics, business terms and rules that keep answers consistent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://clarityq.mintlify.site/_mintlify/api/og/v2?division=Context+Layer\u0026amp;title=What+is+the+Context+Layer%3F\u0026amp;description=The+ClarityQ+Context+Layer+teaches+the+agent+how+your+business+thinks+about+its+data%3A+tables%2C+metrics%2C+business+terms+and+rules+that+keep+answers+consistent.\u0026amp;theme=8a1189787dd42c7f361220a1\u0026amp;signature=25f11dc9bd704a6e99937fb00e3c8de65b26d9a4af84d52dd8ba3086d8d34843\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/clarityq/YW4hrpKdd3h3lviU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ClarityQ Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5A57FC\">\u003cmeta data-mint-head name=\"msvalidate.01\" content=\"2653DA8E28F50109EA5130713FEE874C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/context-layer/what-is-the-context-layer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.clarityq.ai/#organization\",\"name\":\"ClarityQ Documentation\",\"url\":\"https://docs.clarityq.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/clarityq/RMDLvxRyN9-VIA7h/logo/light.svg?fit=max\u0026auto=format\u0026n=RMDLvxRyN9-VIA7h\u0026q=85\u0026s=f8d4e57d3c0e50c3f720e5b6a7afef0b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.clarityq.ai#website\",\"name\":\"ClarityQ Documentation\",\"url\":\"https://docs.clarityq.ai\",\"publisher\":{\"@id\":\"https://docs.clarityq.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer#webpage\",\"url\":\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer\",\"name\":\"What is the Context Layer?\",\"description\":\"The ClarityQ Context Layer teaches the agent how your business thinks about its data: tables, metrics, business terms and rules that keep answers consistent.\",\"dateModified\":\"2026-11-15T11:29:18.507Z\",\"isPartOf\":{\"@id\":\"https://docs.clarityq.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"ClarityQ Documentation\",\"item\":\"https://docs.clarityq.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"What is the Context Layer?\",\"item\":\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer#article\",\"headline\":\"What is the Context Layer?\",\"name\":\"What is the Context Layer?\",\"description\":\"The ClarityQ Context Layer teaches the agent how your business thinks about its data: tables, metrics, business terms and rules that keep answers consistent.\",\"url\":\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer\",\"mainEntityOfPage\":{\"@id\":\"https://docs.clarityq.ai/context-layer/what-is-the-context-layer#webpage\"},\"dateModified\":\"2026-11-15T11:29:18.507Z\",\"publisher\":{\"@id\":\"https://docs.clarityq.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.clarityq.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ClarityQ Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ClarityQ Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/context-layer/what-is-the-context-layer.md","siteName":"ClarityQ Documentation","nav":{"global":null,"groups":[{"group":"Get Started","pages":[{"title":"What is ClarityQ?","href":"/get-started/what-is-clarityq"},{"title":"Connect Your Data Warehouse","href":"/get-started/connect-your-data-warehouse"},{"title":"Build Your Context Layer","href":"/get-started/build-your-context-layer"},{"title":"Your First Chat","href":"/get-started/your-first-chat"},{"title":"Best Practices","href":"/get-started/best-practices"}]},{"group":"Data Warehouse Connections","pages":[{"title":"BigQuery","href":"/data-warehouse/bigquery"},{"title":"Snowflake","href":"/data-warehouse/snowflake"},{"title":"Amazon Athena","href":"/data-warehouse/athena"},{"title":"Amazon Redshift","href":"/data-warehouse/redshift"},{"title":"PostgreSQL","href":"/data-warehouse/postgres"},{"title":"Databricks","href":"/data-warehouse/databricks"},{"title":"MaxCompute","href":"/data-warehouse/maxcompute"},{"title":"Trino","href":"/data-warehouse/trino"},{"title":"ClickHouse","href":"/data-warehouse/clickhouse"},{"title":"Azure SQL","href":"/data-warehouse/sqlserver"},{"title":"Signing In With Your Own Warehouse Account","sidebarTitle":"Signing In With Your Own Account","description":"Some connections run every query under your own data warehouse identity. Connect your account once so your warehouse applies your permissions to what you ask.","href":"/data-warehouse/signing-in-with-your-own-account"}]},{"group":"Context Layer","pages":[{"title":"What is the Context Layer?","href":"/context-layer/what-is-the-context-layer"},{"group":"Table Catalog","pages":[{"title":"What is the Table Catalog?","description":"A live inventory of your data warehouse tables, columns, and metadata.","href":"/context-layer/table-catalog/what-is-the-table-catalog"},{"title":"Setting Up Your Table Catalog","href":"/context-layer/table-catalog/setting-up-your-table-catalog"},{"title":"Daily Discovery Jobs","href":"/context-layer/table-catalog/daily-discovery-jobs"}]},{"group":"Event Catalog","pages":[{"title":"What is the Event Catalog?","href":"/context-layer/event-catalog/what-is-the-event-catalog"},{"title":"Setting Up Your Event Catalog","href":"/context-layer/event-catalog/setting-up-your-event-catalog"},{"title":"Daily Discovery Jobs","href":"/context-layer/event-catalog/daily-discovery-jobs"},{"title":"Missing Description Wizard","href":"/context-layer/event-catalog/missing-description-wizard"},{"title":"Syncing Events to the Semantic Catalog","href":"/context-layer/event-catalog/syncing-events-to-the-semantic-catalog"}]},{"group":"Semantic Catalog","pages":[{"title":"What is the Semantic Catalog?","href":"/context-layer/semantic-catalog/what-is-the-semantic-catalog"},{"title":"Entities","href":"/context-layer/semantic-catalog/entities"},{"title":"Dimensions","href":"/context-layer/semantic-catalog/dimensions"},{"title":"Metrics","href":"/context-layer/semantic-catalog/metrics"},{"title":"Segments","href":"/context-layer/semantic-catalog/segments"},{"title":"Events","href":"/context-layer/semantic-catalog/events"}]},{"title":"Skills","href":"/context-layer/skills"},{"title":"Rules","href":"/context-layer/rules"},{"title":"Memory","href":"/context-layer/memory"},{"title":"Files","href":"/context-layer/files"}]},{"group":"Building the Context Layer","pages":[{"title":"Recommended Build Order","href":"/context-layer/building/recommended-build-order"},{"title":"How the Context Layer Builder works","href":"/context-layer/building/how-the-context-layer-builder-works"},{"title":"Building Entities from Tables","href":"/context-layer/building/building-entities-from-tables"},{"title":"Building Metrics","href":"/context-layer/building/building-metrics"},{"title":"Building Segments","href":"/context-layer/building/building-segments"},{"title":"Building Skills","href":"/context-layer/building/building-skills"},{"title":"Building Product Memory","href":"/context-layer/building/building-memory"},{"title":"Context Layer Versioning","href":"/context-layer/building/context-layer-versioning"},{"title":"Inbox","href":"/context-layer/building/inbox"},{"title":"Building Events from the Event Catalog","href":"/context-layer/building/building-events-from-the-event-catalog"}]},{"group":"Ask Anything","pages":[{"title":"How Ask Anything Works","href":"/ask-anything/how-ask-anything-works"},{"title":"Asking Questions","href":"/ask-anything/asking-questions"},{"title":"Understanding Responses","href":"/ask-anything/understanding-responses"},{"title":"Diagnosing Answers","href":"/ask-anything/diagnosing-answers"},{"title":"Context Coverage","href":"/ask-anything/context-coverage"},{"title":"Sharing \u0026 Collaboration","href":"/ask-anything/sharing-and-collaboration"},{"title":"Unified Workspaces","href":"/ask-anything/unified-workspaces"},{"title":"Errors \u0026 Troubleshooting","href":"/ask-anything/errors-and-troubleshooting"}]},{"group":"Dashboards","pages":[{"title":"What are Dashboards?","href":"/dashboards/what-are-dashboards"},{"title":"Creating and Editing Dashboards","href":"/dashboards/creating-and-editing-dashboards"},{"title":"Asking About a Dashboard's Data","href":"/dashboards/asking-about-dashboard-data"},{"title":"Scheduling Dashboards","href":"/dashboards/scheduling-dashboards"},{"title":"Sharing and Managing Dashboards","href":"/dashboards/sharing-and-managing-dashboards"}]},{"group":"Automations","pages":[{"title":"What are Tasks?","href":"/automations/what-are-tasks"},{"title":"Creating \u0026 Scheduling Tasks","href":"/automations/creating-and-scheduling-tasks"},{"title":"Task Delivery \u0026 Notifications","href":"/automations/task-delivery-and-notifications"}]},{"group":"Integrations","pages":[{"group":"Embed","pages":[{"title":"Embedding ClarityQ","href":"/integrations/embed/embedding-clarityq"},{"openapi":"post /api/v1/products/{product_id}/embed/token","title":"Mint an embed token","href":"/integrations/embed/mint-embed-token"},{"openapi":"post /api/v1/products/{product_id}/conversations","title":"List conversations","href":"/integrations/embed/list-conversations"}]},{"group":"Slack","pages":[{"title":"Connecting Slack","href":"/integrations/slack/connecting-slack"},{"title":"Using ClarityQ in Slack","href":"/integrations/slack/using-clarityq-in-slack"}]},{"group":"MCP Connectors","pages":[{"title":"MCP Connectors","href":"/integrations/mcp/connecting-mcp-servers"},{"title":"Using Apps","href":"/integrations/mcp/using-mcp-servers"},{"title":"Connecting Atlassian (Jira)","href":"/integrations/mcp/connecting-atlassian"},{"title":"Connecting GitHub","href":"/integrations/mcp/connecting-github"}]},{"group":"ClarityQ MCP Server","pages":[{"title":"Connecting AI Assistants","href":"/integrations/clarityq-mcp-server/connecting-ai-assistants"},{"title":"Using ClarityQ from AI Assistants","href":"/integrations/clarityq-mcp-server/using-clarityq-from-ai-assistants"}]}]},{"group":"Administration","pages":[{"title":"Context Hub","href":"/admin/context-hub"},{"title":"User Management and Roles","href":"/admin/user-management-and-roles"},{"title":"Organization Settings","href":"/admin/organization-settings"},{"title":"Filters","href":"/admin/filters"},{"title":"Usage Dashboard","href":"/admin/usage-dashboard"},{"title":"Usage Limits and Top-Ups","href":"/admin/usage-limits-and-top-ups"},{"title":"Security and Compliance","href":"/admin/security-and-compliance"}]},{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/index"},{"openapi":"post /api/v1/products/{product_id}/ask","title":"Ask a question","href":"/api-reference/api/ask-a-question"},{"openapi":"get /api/v1/products/{product_id}/conversations/{conversation_id}/status","title":"Get conversation status","href":"/api-reference/api/get-conversation-status"},{"openapi":"get /api/v1/products/{product_id}/conversations/{conversation_id}/summary","title":"Get conversation summary","href":"/api-reference/api/get-conversation-summary"},{"title":"Submit Feedback","openapi":"put /api/v1/products/{product_id}/conversations/{conversation_id}/feedback","href":"/api-reference/api/submit-feedback"},{"openapi":"get /api/v1/products/{product_id}/tasks/{task_id}/last-run-summary","title":"Get last completed task run summary","href":"/api-reference/api/get-last-completed-task-run-summary"},{"title":"Get Prompt Usage","openapi":"get /api/v1/products/{product_id}/usage/prompts","href":"/api-reference/api/get-prompt-usage"},{"title":"Submit External Feedback","openapi":"post /api/v1/products/{product_id}/external-feedback","href":"/api-reference/api/submit-external-feedback"}]},{"group":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"What is the Context Layer? - ClarityQ Documentation","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}