> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ask & Visualize

> Ask anything. See the answer.

<Note>
  **Ask & Visualize** is the page that lets you ask plain-language questions about your contact center and get charts, numbers, or raw rows back in seconds.
</Note>

## Page anatomy

| Region               | What you see                                                                         |
| -------------------- | ------------------------------------------------------------------------------------ |
| Filter bar           | Date and hour controls, see [Overview](/en/Systems/Contact-Center-QA/Overview-Page). |
| Sidebar (start edge) | A list of past chat threads with search, **New chat**, and per-row delete.           |
| Chat canvas (center) | The main scrollable area. Question turns from you, answer turns from the system.     |
| Composer (bottom)    | The text input plus **Send** button. The composer pins to the bottom of the page.    |

## The composer

Pinned at the bottom of the chat canvas.

| Element         | What it shows                                                                                                              |
| --------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Text input      | Placeholder *Ask anything about your calls...* Capped at 500 characters. Arabic input renders right-to-left automatically. |
| **Send** button | A brand-gradient pill with a send icon. Disabled when the input is empty or a turn is currently streaming.                 |
| **Stop** button | Replaces **Send** while a turn is streaming. Click to cancel the in-flight answer.                                         |

The Send button has extra padding on the end edge so the floating chat widget launcher in the bottom-end corner does not cover it.

## The thread sidebar

A list of every chat thread you have started in this project.

| Element               | What it shows                                                                                                             |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **History** header    | Title at the top of the sidebar.                                                                                          |
| Search box            | Placeholder *Search history...* Filters the thread list by title.                                                         |
| **+ New chat** button | Opens a fresh thread.                                                                                                     |
| Thread row            | Each row shows the thread title (the first question) and a small chevron.                                                 |
| Active filter pill    | Below each thread, a small chip shows the date range that thread was scoped to.                                           |
| Delete                | Click the small trash icon on a row. The first click shows *Click again to confirm*; the second click deletes the thread. |
| Empty state           | *No chat history yet.*                                                                                                    |

## The chat canvas

Scrolls vertically. Older turns at the top, newest at the bottom. Each turn carries:

| Element           | What it shows                                                              |
| ----------------- | -------------------------------------------------------------------------- |
| Avatar            | Round tile, brand gradient for system turns, your initials for your turns. |
| Body              | The text or rendered chart.                                                |
| Per-answer footer | Small action buttons (described below).                                    |

### Streaming and error states

| State         | What you see                                                                                 |
| ------------- | -------------------------------------------------------------------------------------------- |
| Question sent | The question turn appears immediately, the answer turn shows a spinner with **Thinking...**. |
| Streaming     | The answer renders progressively as the model thinks and the SQL runs.                       |
| Failed        | The answer carries the message *Something went wrong. Try again.* in a small red strip.      |

## Suggestions

When the canvas is empty, the page surfaces six suggestion chips you can click to drop a question into the composer.

| Suggestion                                 |
| ------------------------------------------ |
| *Show me total calls for the last 7 days*  |
| *Top 10 intents across the dataset*        |
| *Sentiment distribution this month*        |
| *What is the busiest hour of the day*      |
| *Show an activity heatmap by day and hour* |
| *List the most recent negative sessions*   |

The empty state title reads *Ask anything about your contact center.* with a body line *I can summarize call volume, surface top intents, plot sentiment, and show raw session rows. Try one of the suggestions below or type your own question.*

## What the system can return

The system picks the best renderer for your question.

| Renderer       | When it shows up                                                                                                                                                                                              |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Big number** | Single-value answers (e.g. "Total calls last 7 days" → one big number with a comparison delta below).                                                                                                         |
| **Pie chart**  | Distribution questions (e.g. "Sentiment distribution this month"). Donut shape with inside-positioned percent labels. Slices under 4% hide their label. The legend is truncated at 28 characters and scrolls. |
| **Bar chart**  | Ranking questions (e.g. "Top 10 intents"). Vertical for time series, horizontal for ranked categories. Each bar carries a small data label at the tip.                                                        |
| **Line chart** | Time series (e.g. "Calls per day this month"). The x axis is dates, the y axis uses thousands separators.                                                                                                     |
| **Heatmap**    | Cross-tab questions (e.g. "Activity by day and hour"). Same shape as the Activity Heatmap on Overview.                                                                                                        |
| **Table**      | Row-level questions (e.g. "List the most recent negative sessions"). Up to a fixed page cap, with a row count and a *Truncated for display* indicator if more rows exist.                                     |

## Per-answer footer

| Action                    | When it shows                                |
| ------------------------- | -------------------------------------------- |
| **PNG**                   | On chart answers. Downloads the chart.       |
| **CSV**                   | On table answers. Downloads the data.        |
| **rows** count            | On table answers. Reads **{n} rows**.        |
| **Truncated for display** | On table answers when the result was capped. |

## Common questions

<AccordionGroup>
  <Accordion title="My question came back with a chart I did not expect.">
    The system picks the renderer based on the question's shape (a count yields a big number, a distribution yields a pie, a ranking yields a bar). Re-phrase the question to nudge it (for example, "List the rows" forces a table, "Show me the share" forces a pie).
  </Accordion>

  <Accordion title="The answer is wrong.">
    Two common causes. First, the question may be ambiguous (for example, "show me last week" could mean any of the past 7 days, or the previous Monday-to-Sunday week). Be explicit: *Last 7 days* or *the most recent calendar week starting Monday*. Second, the date filter at the top of the page applies, so a question like "Show me total calls" returns the count inside the active filter window, not the project's all-time count.
  </Accordion>

  <Accordion title="My question is in Arabic, the answer came back in English.">
    The system mirrors your question's language. If you got an English answer for an Arabic question, ask the question again in Arabic so the system has a clean signal.
  </Accordion>

  <Accordion title="Can the system change my data?">
    No. Every query is read-only. Only `SELECT` and `WITH` queries are accepted, and destructive operations are rejected at the server. Sensitive columns are also deny-listed.
  </Accordion>

  <Accordion title="Can I share an answer with a teammate?">
    Yes. Click **PNG** on a chart answer or **CSV** on a table answer. Both are downloaded to your machine, you can attach them to chat or email.
  </Accordion>

  <Accordion title="The thread list is full of half-finished chats.">
    Use the per-row trash icon to delete chats you do not need. The first click asks for confirmation, the second deletes. There is no undo.
  </Accordion>

  <Accordion title="Can I ask a follow-up question that builds on the last answer?">
    Yes. The system keeps the thread context, follow-ups like "And by hour?" or "Now show only the negatives" work in plain language.
  </Accordion>

  <Accordion title="The composer is hidden behind the floating chat widget.">
    The composer's end-edge padding clears the launcher, the Send button stays clickable. If your screen is unusually narrow and the launcher overlaps anyway, scroll the page slightly, the launcher slides out of the way.
  </Accordion>
</AccordionGroup>

## Where to go next

<CardGroup cols={2}>
  <Card title="Sentiment Analysis" icon="face-smile" href="/en/Systems/Contact-Center-QA/Sentiment-Analysis">Curated chart for sentiment distribution.</Card>
  <Card title="Intent Analysis" icon="lightbulb" href="/en/Systems/Contact-Center-QA/Intent-Analysis">Curated chart for top 10 intents.</Card>
  <Card title="Volume Forecasting" icon="chart-mixed" href="/en/Systems/Contact-Center-QA/Volume-Forecasting">Plan ahead with a model-based projection.</Card>
  <Card title="TimeLens AI" icon="wand-magic-sparkles" href="/en/Systems/Contact-Center-QA/TimeLens-AI">Streamed narrative report instead of a one-shot answer.</Card>
</CardGroup>