> ## 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.

# Errors & Troubleshooting

> Common errors in Ask Anything and how to resolve them.

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](mailto:support@clarityq.ai) with:

* The question you asked
* The error message you received
* The product and date range you were querying