# Usage

### Review Credits

The Usage page shows both credit types in one panel.

<div data-with-frame="true"><img src="/files/608df40660445e059165981fa67ca183314ed1cb" alt=""></div>

{% hint style="info" %}
Top up — Select the wallet icon to open the [top-up flow](/chatlyst-user-guide/top-up-guideline/top-up-guideline.md).

<img src="/files/xOftV5fzz1xwDjyfnDfE" alt="" data-size="original">
{% endhint %}

***

### Review Overview and Trends

{% stepper %}
{% step %}

#### Choose a Date Range

Use the date range selector to specify the time period for the data displayed.

{% hint style="info" %}
Date Range — Use the top-right date range selector to view data for a specific period.

<img src="/files/bFF7s64oOgmFzs4OhEGs" alt="" data-size="original">
{% endhint %}

<div data-with-frame="true"><img src="/files/f4a12b64f33b5d4a2da8f6b9d03f004e4ef0fe04" alt=""></div>
{% endstep %}

{% step %}

#### Switch between Overview and Trends

Use the navigation tab in the middle of the page to switch between [Overview](#overview) and [Trends](#trends).

{% hint style="info" %}
Navigation Tab — Switch between Overview and Trend.

<img src="/files/Mwfpd7pBTTmtETrIXDH0" alt="" data-size="original">
{% endhint %}

<div data-with-frame="true"><img src="/files/d4d2c489d869b2466a1fe27a641440b1f4317d8e" alt=""></div>
{% endstep %}

{% step %}

#### **Overview**

In Overview, key information updates based on the selected date range.

<div data-with-frame="true"><figure><img src="/files/kMLe2k6jx0tuVMPFfOaj" alt=""><figcaption></figcaption></figure></div>

1. Period Summary shows key activity for the selected date range.

<div data-with-frame="true"><img src="/files/85c685be3230218045bd0b16c4f609fd8029fbcb" alt=""></div>

2. Top Users shows the most active users during the selected period.

<div data-with-frame="true"><img src="/files/9f3a0b46e879df50021eedda6bf10bbc2fec128d" alt=""></div>

3. Top Documents shows the most queried knowledge documents and a feedback breakdown.

<div data-with-frame="true"><img src="/files/72ba32a1a353ced32b0a93b1b0688c6e6527ca48" alt=""></div>
{% endstep %}

{% step %}

#### **Trends**

In Trends, compare metrics such as AI Responses Used, KC Bot Used, Messages, and Cost.

The comparison depends on the selected date range.

* If the date range is **Apr 17 to Apr 18**, Chatlyst compares it to **Apr 15 to Apr 16**.

<div data-with-frame="true"><img src="/files/bc889fe5d1a1ea3196117b4b0a8797b25e297927" alt=""></div>

* If the date range is **Apr 14 to Apr 20** (Last 7 days), Chatlyst compares it to **Apr 7 to Apr 13**.

<div data-with-frame="true"><img src="/files/2197a98af3f471e6f92f6cd4d11af922e41bbd8b" alt=""></div>
{% endstep %}
{% endstepper %}

***

### Export the Usage Log

1. Select **Export Usage Log** in the top-right corner.
2. If there is no data in the selected date range, Chatlyst does not generate a file.

<div data-with-frame="true"><img src="/files/b48e1ec223df06066cca59272c8b3e1b65aeb767" alt=""></div>

The exported CSV includes the following columns:

* Date
* AI Response Used
* KC Bot Used
* Messages
* Cost

An example template is shown below:

| Date       | AI Response Used | KC Bot Used | Messages | Cost (HKD) |
| ---------- | ---------------- | ----------- | -------- | ---------- |
| 2026-04-16 | 10               | 1           | 12       | 3.64       |
| 2026-04-17 | 7                | 1           | 7        | 3.21       |
| 2026-04-20 | 5                | 3           | 5        | 7.32       |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chatlyst.gitbook.io/chatlyst-user-guide/dashboard/usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
