What you see when ClarityQ answers a question: the plan, the reasoning steps, the SQL it ran, the final table or visualization, and how to verify each part.
When you ask a question in Ask Anything, the agent works through several visible steps before arriving at a final answer. Here’s what you’ll see and what it means.
Reasoning
The first thing you’ll often see is the agent’s thinking — a collapsible block that shows how the agent interprets your question. This is where it breaks down what you’re asking, identifies the key concepts, and plans its approach.Reading the thinking block is useful when you want to understand why the agent chose a particular approach, or when the final answer doesn’t match your expectations and you want to see where the reasoning diverged.An answer often contains several thinking blocks. Only the first one is expanded for you — the rest start collapsed, so the answer stays readable. Click any of them to open it.
Searching Your Semantic Catalog
Next, the agent searches your Semantic Catalog for relevant business definitions — metrics, events, segments, and entities that match the concepts in your question. You’ll see a brief note showing what the agent searched for and how many results it found.This step is how ClarityQ connects your plain-language question to the business logic your team has defined. If you asked about “churn,” the agent is looking for your organization’s specific definition of churn — not guessing.
Reviewing Semantic Components
After searching, the agent reviews the components it found. You’ll see a list of the semantic items being examined — with their names, types, and descriptions. You can click any component to view its full definition in the Semantic Catalog.The list is grouped to stay readable: skills first, then metrics, then entities, segments, and events. When the agent looks at an entity’s dimensions, those dimensions appear in parentheses next to the entity they belong to rather than as separate items. Files the agent read appear here too, and clicking one downloads it.This is where the agent decides which metrics, dimensions, and entities to use in its analysis. If you notice the agent picked the wrong component, you can follow up with a correction or use an @ mention to be more specific.
Asking for Clarification
Sometimes — especially when your question could mean more than one thing — the agent pauses and asks you a question before continuing. You’ll see a card with multiple choice options or a text field.For example, the agent might ask which time granularity you want (daily vs. weekly), or which of two similar metrics you’re referring to. Answer the question and the agent continues from where it left off.
Running Queries
Once the agent knows what to analyze, it executes one or more SQL queries against your data warehouse. For each query, you’ll see:
A title describing what the query does
The SQL code in a collapsible block — expand it to see exactly what was run
Execution time and cost — how long the query took and what it cost
A results table — interactive, with sortable columns
The agent often runs multiple queries in sequence, building on earlier results. For example, it might first query overall numbers, then break them down by dimension, then compare to a previous period.
If a SQL query fails, the agent detects the error and usually retries with a corrected query automatically. You’ll see both the failed attempt and the retry.
The Final Answer
After all the analysis is complete, the agent presents its findings:
A written insight summarizing what the data shows, putting numbers in context — for example, noting that a metric is “down 3.2% compared to last week” or “at its highest point in 90 days”
Visualizations — when the visualization toggle is on, every numeric answer includes rich visuals. Depending on the complexity of the question, this can be a single chart or a full visual report with multiple charts, all automatically selected to best fit the data
This is the part you’ll share with stakeholders or use to make decisions. Everything above it — the thinking, searching, querying — is the transparent trail showing how the agent got there.
Working with Results
Once you have your answer, you can:
Ask follow-up questions — “Break that down by country” or “What about last month?”
Challenge the result — If something looks off, tell the agent. Ask it to re-check assumptions or approach the question differently.
Edit your question — Hover over your message and click edit to refine it. The agent re-runs the analysis with your updated wording.
Check the SQL — Expand any SQL block to verify the query logic yourself.
Rating Responses
Rate any response using the feedback buttons — thumbs up, neutral, or thumbs down. You can optionally add a text reason. Ratings help improve ClarityQ’s accuracy over time.A thumbs-down can also kick off a Diagnosis — an investigation into what went wrong that suggests a fix to your Context Layer.
{"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":"ask-anything/understanding-responses","slug":"/ask-anything/understanding-responses","pageMetadata":{"title":"Understanding Responses","description":"What you see when ClarityQ answers a question: the plan, the reasoning steps, the SQL it ran, the final table or visualization, and how to verify each part.","href":"/ask-anything/understanding-responses"},"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: \"What you see when ClarityQ answers a question: the plan, the reasoning steps, the SQL it ran, the final table or visualization, and how to verify each part.\"\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`,em:`em`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`When you ask a question in Ask Anything, the agent works through several visible steps before arriving at a final answer. Here’s what you’ll see and what it means.`}),`\n`,_jsx(Heading,{level:`2`,id:`reasoning`,children:`Reasoning`}),`\n`,_jsxs(_components.p,{children:[`The first thing you’ll often see is the agent’s `,_jsx(_components.strong,{children:`thinking`}),` — a collapsible block that shows how the agent interprets your question. This is where it breaks down what you’re asking, identifies the key concepts, and plans its approach.`]}),`\n`,_jsxs(_components.p,{children:[`Reading the thinking block is useful when you want to understand `,_jsx(_components.em,{children:`why`}),` the agent chose a particular approach, or when the final answer doesn’t match your expectations and you want to see where the reasoning diverged.`]}),`\n`,_jsxs(_components.p,{children:[`An answer often contains several thinking blocks. Only the `,_jsx(_components.strong,{children:`first`}),` one is expanded for you — the rest start collapsed, so the answer stays readable. Click any of them to open it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`searching-your-semantic-catalog`,children:`Searching Your Semantic Catalog`}),`\n`,_jsx(_components.p,{children:`Next, the agent searches your Semantic Catalog for relevant business definitions — metrics, events, segments, and entities that match the concepts in your question. You’ll see a brief note showing what the agent searched for and how many results it found.`}),`\n`,_jsx(_components.p,{children:`This step is how ClarityQ connects your plain-language question to the business logic your team has defined. If you asked about “churn,” the agent is looking for your organization’s specific definition of churn — not guessing.`}),`\n`,_jsx(Heading,{level:`2`,id:`reviewing-semantic-components`,children:`Reviewing Semantic Components`}),`\n`,_jsx(_components.p,{children:`After searching, the agent reviews the components it found. You’ll see a list of the semantic items being examined — with their names, types, and descriptions. You can click any component to view its full definition in the Semantic Catalog.`}),`\n`,_jsxs(_components.p,{children:[`The list is grouped to stay readable: skills first, then metrics, then entities, segments, and events. When the agent looks at an entity’s dimensions, those dimensions appear in parentheses next to the entity they belong to rather than as separate items. `,_jsx(_components.a,{href:`/context-layer/files`,children:`Files`}),` the agent read appear here too, and clicking one downloads it.`]}),`\n`,_jsxs(_components.p,{children:[`This is where the agent decides which metrics, dimensions, and entities to use in its analysis. If you notice the agent picked the wrong component, you can follow up with a correction or use an `,_jsx(_components.code,{children:`@`}),` mention to be more specific.`]}),`\n`,_jsx(Heading,{level:`2`,id:`asking-for-clarification`,children:`Asking for Clarification`}),`\n`,_jsx(_components.p,{children:`Sometimes — especially when your question could mean more than one thing — the agent pauses and asks you a question before continuing. You’ll see a card with multiple choice options or a text field.`}),`\n`,_jsx(_components.p,{children:`For example, the agent might ask which time granularity you want (daily vs. weekly), or which of two similar metrics you’re referring to. Answer the question and the agent continues from where it left off.`}),`\n`,_jsx(Heading,{level:`2`,id:`running-queries`,children:`Running Queries`}),`\n`,_jsx(_components.p,{children:`Once the agent knows what to analyze, it executes one or more SQL queries against your data warehouse. For each query, you’ll see:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A title`}),` describing what the query does`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The SQL code`}),` in a collapsible block — expand it to see exactly what was run`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Execution time and cost`}),` — how long the query took and what it cost`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A results table`}),` — interactive, with sortable columns`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`The agent often runs multiple queries in sequence, building on earlier results. For example, it might first query overall numbers, then break them down by dimension, then compare to a previous period.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`If a SQL query fails, the agent detects the error and usually retries with a corrected query automatically. You’ll see both the failed attempt and the retry.`})}),`\n`,_jsx(Heading,{level:`2`,id:`the-final-answer`,children:`The Final Answer`}),`\n`,_jsx(_components.p,{children:`After all the analysis is complete, the agent presents its findings:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A written insight`}),` summarizing what the data shows, putting numbers in context — for example, noting that a metric is “down 3.2% compared to last week” or “at its highest point in 90 days”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Visualizations`}),` — when the visualization toggle is on, every numeric answer includes rich visuals. Depending on the complexity of the question, this can be a single chart or a full visual report with multiple charts, all automatically selected to best fit the data`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`This is the part you’ll share with stakeholders or use to make decisions. Everything above it — the thinking, searching, querying — is the transparent trail showing how the agent got there.`}),`\n`,_jsx(Heading,{level:`2`,id:`working-with-results`,children:`Working with Results`}),`\n`,_jsx(_components.p,{children:`Once you have your answer, you can:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Ask follow-up questions`}),` — “Break that down by country” or “What about last month?”`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Challenge the result`}),` — If something looks off, tell the agent. Ask it to re-check assumptions or approach the question differently.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Edit your question`}),` — Hover over your message and click edit to refine it. The agent re-runs the analysis with your updated wording.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Check the SQL`}),` — Expand any SQL block to verify the query logic yourself.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`rating-responses`,children:`Rating Responses`}),`\n`,_jsx(_components.p,{children:`Rate any response using the feedback buttons — thumbs up, neutral, or thumbs down. You can optionally add a text reason. Ratings help improve ClarityQ’s accuracy over time.`}),`\n`,_jsxs(_components.p,{children:[`A thumbs-down can also kick off a `,_jsx(_components.a,{href:`/ask-anything/diagnosing-answers`,children:`Diagnosis`}),` — an investigation into what went wrong that suggests a fix to your Context Layer.`]})]})}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":"Understanding Responses","description":"What you see when ClarityQ answers a question: the plan, the reasoning steps, the SQL it ran, the final table or visualization, and how to verify each part.","href":"/ask-anything/understanding-responses"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Reasoning","slug":"reasoning","depth":2,"children":[]},{"title":"Searching Your Semantic Catalog","slug":"searching-your-semantic-catalog","depth":2,"children":[]},{"title":"Reviewing Semantic Components","slug":"reviewing-semantic-components","depth":2,"children":[]},{"title":"Asking for Clarification","slug":"asking-for-clarification","depth":2,"children":[]},{"title":"Running Queries","slug":"running-queries","depth":2,"children":[]},{"title":"The Final Answer","slug":"the-final-answer","depth":2,"children":[]},{"title":"Working with Results","slug":"working-with-results","depth":2,"children":[]},{"title":"Rating Responses","slug":"rating-responses","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"clarityq","siteName":"ClarityQ Documentation","title":"Understanding Responses - ClarityQ Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T11:29:18.507Z","originalFileLocation":"ask-anything/understanding-responses.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=\"What you see when ClarityQ answers a question: the plan, the reasoning steps, the SQL it ran, the final table or visualization, and how to verify each part.\">\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=\"Understanding Responses - ClarityQ Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"What you see when ClarityQ answers a question: the plan, the reasoning steps, the SQL it ran, the final table or visualization, and how to verify each part.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ClarityQ Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.clarityq.ai/ask-anything/understanding-responses\">\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=Ask+Anything\u0026amp;title=Understanding+Responses\u0026amp;description=What+you+see+when+ClarityQ+answers+a+question%3A+the+plan%2C+the+reasoning+steps%2C+the+SQL+it+ran%2C+the+final+table+or+visualization%2C+and+how+to+verify+each+part.\u0026amp;theme=8a1189787dd42c7f361220a1\u0026amp;signature=808580d94a835864e0794d8e473f58fb4d0883d4a8c341137edf2b18e53bf3fe\">\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=\"Understanding Responses - ClarityQ Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"What you see when ClarityQ answers a question: the plan, the reasoning steps, the SQL it ran, the final table or visualization, and how to verify each part.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://clarityq.mintlify.site/_mintlify/api/og/v2?division=Ask+Anything\u0026amp;title=Understanding+Responses\u0026amp;description=What+you+see+when+ClarityQ+answers+a+question%3A+the+plan%2C+the+reasoning+steps%2C+the+SQL+it+ran%2C+the+final+table+or+visualization%2C+and+how+to+verify+each+part.\u0026amp;theme=8a1189787dd42c7f361220a1\u0026amp;signature=808580d94a835864e0794d8e473f58fb4d0883d4a8c341137edf2b18e53bf3fe\">\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/ask-anything/understanding-responses\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ask-anything/understanding-responses.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/ask-anything/understanding-responses#webpage\",\"url\":\"https://docs.clarityq.ai/ask-anything/understanding-responses\",\"name\":\"Understanding Responses\",\"description\":\"What you see when ClarityQ answers a question: the plan, the reasoning steps, the SQL it ran, the final table or visualization, and how to verify each part.\",\"dateModified\":\"2026-11-15T11:29:18.507Z\",\"isPartOf\":{\"@id\":\"https://docs.clarityq.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.clarityq.ai/ask-anything/understanding-responses#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.clarityq.ai/ask-anything/understanding-responses#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Ask Anything\",\"item\":\"https://docs.clarityq.ai/ask-anything/how-ask-anything-works\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Understanding Responses\",\"item\":\"https://docs.clarityq.ai/ask-anything/understanding-responses\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.clarityq.ai/ask-anything/understanding-responses#article\",\"headline\":\"Understanding Responses\",\"name\":\"Understanding Responses\",\"description\":\"What you see when ClarityQ answers a question: the plan, the reasoning steps, the SQL it ran, the final table or visualization, and how to verify each part.\",\"url\":\"https://docs.clarityq.ai/ask-anything/understanding-responses\",\"mainEntityOfPage\":{\"@id\":\"https://docs.clarityq.ai/ask-anything/understanding-responses#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":"/ask-anything/understanding-responses.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","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?","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","description":"How to ask effective questions using mentions, skills, date ranges, and filters.","href":"/ask-anything/asking-questions"},{"title":"Understanding Responses","href":"/ask-anything/understanding-responses"},{"title":"Diagnosing Answers","description":"Investigate why a ClarityQ answer was wrong, trace it to the data or definitions used, and apply the suggested fix to your Context Layer so it stays correct.","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":"Understanding Responses - ClarityQ Documentation","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}