Document Usage
Document Usage shows how often a bot’s knowledge search pulled each document while answering. Use it to find the content your visitors rely on and the sources that never come up.
Open a bot and click Document Usage under Statistics in its sidebar. Choose a date range at the top, and click Refresh to load the latest numbers.
What the page shows
| Area | What it shows |
|---|---|
| Total Document Hits | How many times documents were retrieved in the selected range. |
| Unique Documents Used | How many different documents were retrieved. |
| Sources Contributing | How many sources those documents came from. |
| Top 10 Documents | The most-retrieved documents. |
| Usage by Source | Hits grouped by source. |
| Usage Over Time | How hits change across the selected range. |
| All Documents | Every retrieved document with its Document Title, Source, Hit Count, and Last Used time. Search by title and choose 10, 20, or 50 rows per page. |
A document that was later removed appears as (deleted).
How hits are counted
A hit is recorded each time the bot’s knowledge search retrieves a document while preparing an answer. A retrieved document isn’t always cited in the final reply, so hits measure what the bot looked at, not only what it quoted. Counting runs in the background and is best-effort, so totals are approximate.
Hits are counted per bot. If several bots share a source, each bot shows only its own usage.
Use it to improve answers
- Check top documents for accuracy. These pages shape the most answers, so keep them current.
- Look for sources with no usage. If a source never appears, it may be off-topic for this bot, or visitors may not ask about it.
- Compare with Content Gaps. Questions the bot couldn’t answer show where content is missing. See Content Gaps.