Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clarityq.ai/llms.txt

Use this file to discover all available pages before exploring further.

Occasionally, the agent may encounter errors when answering a question. Here’s what you might see and how to handle it.

​
SQL Errors

The agent generates SQL based on your Semantic Catalog and question. If the generated query fails:
  • The error is displayed inline in the conversation with details about what went wrong
  • The agent may retry — it can detect the error, adjust the query, and re-run automatically
  • If retries fail, the agent will explain the issue and may ask for clarification
Common causes:
  • Referencing a column or table that doesn’t exist in the warehouse
  • Incorrect date formats or ranges
  • Permission issues on specific tables
What you can do:
  • Edit your question to be more specific
  • Use @ mentions to point the agent to the correct component
  • Check if the relevant table is in your Table Catalog and has an approved status

​
Token Limit Warnings

Long conversations or very complex analyses can approach the token limit. If this happens, you’ll see a warning. Start a new conversation to continue with a fresh context.

​
Query Timeout

Some queries against large tables may take longer than expected. If a query times out:
  • Try narrowing the date range
  • Add filters to reduce the data scanned
  • Check if mandatory filters are set on the table to limit the data scope

​
Agent Errors

If the agent encounters an unexpected error during analysis, an error message will appear in the conversation. You can:
  • Retry by asking the same question again
  • Rephrase the question with more specificity
  • Start a new conversation if the issue persists

​
Aborting a Request

If the agent is taking too long or you want to change your question, click the Stop button (appears while the agent is working) to abort the current request. You can then edit your question or ask a new one.

​
Getting Help

If you encounter persistent errors or unexpected behavior, reach out to support@clarityq.ai with:
  • The question you asked
  • The error message you received
  • The product and date range you were querying