> ## 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.
# TimeLens AI
> Chronological intelligence, on demand.
**TimeLens AI** is the page that turns the active date range into a streamed, chronological narrative report. Each segment in the report is a roughly 150-call bucket with main topics, flagged issues, and a short summary.
## Page anatomy
| Region | What you see |
| ------------ | ------------------------------------------------------------------------------------- |
| Filter bar | Below the hero, same date-and-hour controls as every other CCQA page. |
| Prompt card | A textarea for steering the report (optional) plus four suggestion chips. |
| CTA row | The action buttons that drive the report. |
| Report panel | Either an empty state or the streaming segment cards, depending on the report status. |
## The hero card
The hero is bespoke for TimeLens. In addition to the standard eyebrow / title / body, it carries:
| Element | What it shows |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Calls in scope** chip | Total calls inside the active filter window. |
| **Date range** chip | The active date range, formatted. |
| **Time span** chip | The number of days covered. |
| **{n} segments, \~150 calls each** chip | The number of segments the slider will produce, computed from calls in scope divided by roughly 150. |
| Segment count slider | Lets you pick how many segments the narrative will cover. Range starts at **1** and goes up to ceil(calls in scope รท 150). For a 148,000-call month the maximum climbs to about 990. The default value is the smaller of 10 or the maximum. |
| **Will analyze {segs} segments, {calls} calls** caption | Updates instantly as you move the slider. |
The segment count is a quality lever, not a cost-saving knob. More segments produce a longer, more granular narrative; fewer segments produce a tighter executive-style summary. 10 is a good starting point.
## The Prompt card
Steers the analysis. Leave it empty for a full default report.
| Element | What it shows |
| -------------------- | ----------------------------------------------------------------------------------------------- |
| Title | **Prompt Wittify AI**. |
| Subtitle | *Optional, steer the analysis. Leave empty for a full default report.* |
| Textarea placeholder | *e.g. Focus on billing complaints and escalation patterns after 6pm.* Capped at 500 characters. |
| Suggestion chips | Four one-click prompts you can drop into the textarea: |
| Suggestion chip | What it asks the model to do |
| ------------------------------------------------------------------ | --------------------------------------- |
| *Summarize the top 3 emerging complaints and when they peaked.* | Surface hot issues with timing. |
| *What issues spiked in the last segment compared to earlier?* | Trend change in the most recent slice. |
| *List the most common resolution themes and quote exemplar turns.* | Coaching material with verbatim quotes. |
| *Identify escalation risk and flag calls needing review.* | QA-queue style triage. |
## The CTA row
The buttons available on the page change based on the current state.
| Button | When it shows | What it does |
| ------------------------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
| **Generate Timeline Report** | Idle (no report yet, or filter has just changed) | Starts streaming a new report. |
| **Stop** | Streaming | Cancels the stream. The report panel keeps whatever segments arrived before you stopped. |
| **Regenerate** | Ready | Replaces the current report with a new one using the same filter and prompt. |
| **Download filtered calls CSV** | Always | Downloads the session-id list for the active filter window as a CSV file. |
| **Generate PDF report** | Ready | Opens a Blob-URL print window with a strict content security policy so you can save or print the report. |
The PDF blob URL is revoked after 60 seconds. If you intend to save the file, do so before it auto-revokes.
If your browser blocks the popup, the toast reads *Your browser blocked the popup. Allow popups for this site to export the report as PDF.*
The CSV uses a UTF-8 BOM and CRLF line endings so Excel reads Arabic content correctly. Every cell goes through formula-injection defence (cells starting with `=`, `+`, `-`, `@`, tab, or carriage return get a leading single quote). The default filename is `timelens-filtered-calls.csv`.
## The Report panel
| Phase | What you see |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Idle (default) | Title **Ready when you are**, body *Tune your date filter above, optionally steer the analysis with a prompt, then hit Generate. The AI will stream a chronological narrative of what happened in your calls.*, plus a hint *TIP, PICK HOW MANY CHAPTERS THE NARRATIVE SHOULD COVER*. |
| Generating | Header label **Generating report...** with **Streaming from Wittify AI**. Segment cards arrive one at a time as the stream lands. |
| Ready | Header label **Report ready**. The Regenerate, Download filtered calls CSV, and Generate PDF report buttons appear in the CTA row. |
| Empty (no calls in filter) | Title **No calls in scope**, body *Your current date and hour filter has no calls to analyze. Widen the range above and try again.* |
### The segment cards
Each segment card carries:
| Element | What it shows |
| ------------------------------- | ----------------------------------------------------------------------------------------- |
| **SEGMENT {n} / {total}** badge | The position in the narrative. |
| Calls range | Reads **`{count}` call in `{date}`** or **`{count}` calls in `{date range}`**. |
| **Main topics:** | A bullet list of the dominant topics in this segment. |
| **Identified issues:** | A bullet list of flagged issues, with the originating session ids linked when applicable. |
| **Notes and summary:** | A short paragraph that ties the segment together. |
The card body always renders sequentially (Segment 1 first, Segment 2 second, etc.) and text streams in word by word.
## Common questions
By design. TimeLens reports are filter-bound. Changing the date range, hour range, or prompt invalidates the current report (the data you would be reading no longer matches the model's input). Click **Generate Timeline Report** again with the new filter.
**Stop** appears only while a stream is actively running, **Regenerate** appears only after the stream finished. If you see Stop change to Regenerate, the report is now in the Ready state.
Allow popups for this site in your browser. The toast tells you exactly what to do. After granting permission, click **Generate PDF report** again.
Yes, but the stream stops as soon as you navigate away. There is no resume, you have to click **Generate Timeline Report** again on return.
This should not happen, the export uses a UTF-8 BOM and CRLF line endings. If you still see odd characters, your Excel installation may have a regional default that overrides the BOM, try opening the file with **Data > Get Data > From Text** and selecting **UTF-8** explicitly.
Linked session ids open the matching call in the [Sentiment Analysis](/en/Systems/Contact-Center-QA/Sentiment-Analysis) page's Recent Sessions block. If a link is dead, the session may have been removed or the engine flagged a session id that does not exist in your project.
The maximum is calls in scope divided by roughly 150. If you only have a few hundred calls in your filter, the slider tops out at 1 to 5. Widen the date range to see more segments.
Not yet. The textarea is reset whenever you reload the page. If you reuse the same prompt often, copy it into a note.
## Where to go next
See the sentiment shifts behind the narrative.
Per-call breakdown of who spoke when.
Catch trouble before it compounds.
Plan staffing for the next 7 to 180 days.