> For the complete documentation index, see [llms.txt](https://chatlyst.gitbook.io/chatlyst-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatlyst.gitbook.io/chatlyst-user-guide/train-and-test-bot/train-and-test-bot.md).

# Train & Test bot

Train & Test provides a dedicated space to test the chatbot widget and improve response quality through document training and feedback.

Use this section to test, review results, and process training tickets in a clear workflow.

{% hint style="warning" %}
**Important Note:** Upload Business Knowledge before using Train & Test so the bot can answer accurately. Select Upload Business Knowledge to open the Business Knowledge section, then upload the documents. For more context and additional information, follow [Business Knowledge](/chatlyst-user-guide/business-knowledge/business-knowledge.md).

<img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FZi3rOIYgN0rQKHq7JLrv%2FScreenshot%202026-04-16%20at%204.56.30%E2%80%AFPM.png?alt=media&amp;token=7a1fb881-3d5b-4c0f-8b2b-0b6cc4956c45" alt="" data-size="original">
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2Ffyp0Zni6JUoN2mH1NPqg%2Fimage.png?alt=media&amp;token=fca79288-fb77-4a3d-be9b-ced6fba2ba6d" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Navigation tab — Located at the top-left of the page to switch between Testing and History.

<img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FOsN1Zyat3EcIrFnXP5Ef%2F1.png?alt=media&amp;token=63a7c586-6dc5-4cd8-a56b-3d601642fd3d" alt="" data-size="original">
{% endhint %}

{% hint style="info" %}
Training Panel Notification — Shows the current number of pending training tickets. Select it to open the Training Panel, where tickets can be reviewed and managed.

<img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FoNPGZLZtVmfryxa4kKuv%2F2.png?alt=media&amp;token=a9dcb7a0-c41a-4954-a6c1-f5d7903c196e" alt="" data-size="original">
{% endhint %}

***

## Testing Area

Testing Area provides a space to test the bot and confirm performance before rolling out changes. It supports both the live Widget Preview and Streaming Mode, so conversations can run in real time while responses are checked for accuracy, usefulness, and consistency.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FQaVwj4hePMolsaFoWu6W%2FYour%20paragraph%20text%20(6).png?alt=media&amp;token=7b3783f4-1a1f-4db1-a3d5-c041deb2ff96" alt=""><figcaption></figcaption></figure></div>

### Controls

<details>

<summary><strong>Auto Test</strong></summary>

Select **Auto Test** to start an automated test conversation, so Chatlyst can simulate a real user and show how your bot responds without any manual input.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FAgjuTlkpLpTPqxMRQKy9%2Fimage.png?alt=media&amp;token=cefc2181-b1d9-4c46-8c95-846420fa11c8" alt=""><figcaption></figcaption></figure></div>

</details>

<details>

<summary><strong>New Chat</strong></summary>

Select to start a new chat session while training, so testing starts from a clean conversation without earlier messages or context.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2Fabz4SdUV7RCaXifMDIV5%2Fimage.png?alt=media&amp;token=e54019d3-a2e3-4cb3-8065-4e0193d90b73" alt=""><figcaption></figcaption></figure></div>

</details>

<details>

<summary><strong>Change Widget</strong> </summary>

Located next to **New Chat**. Select the widget to test in this session.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FmzdMlMnUThiYvomeVACL%2Fimage.png?alt=media&amp;token=b78f8f86-c041-4b37-82d3-53fde739099c" alt=""><figcaption></figcaption></figure></div>

</details>

<details>

<summary><strong>Preview tab</strong></summary>

Switch between **Widget Preview** and **Streaming Mode** to control how the chat displays during testing.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F4hUjo8A2YIeqwFdAHTTX%2Fimage.png?alt=media&amp;token=fdc61d85-9158-433b-9db1-05488d386b73" alt=""><figcaption></figcaption></figure></div>

<div><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FU1yM5u0JuUWeSrJVrWPF%2Fimage.png?alt=media&amp;token=f2786461-b3ed-4a43-b22d-4680234e3002" alt=""><figcaption><p><strong>Widget Preview Appearance</strong></p></figcaption></figure> <figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FmYEpJIWsYSZP0oeRnEZ9%2Fimage.png?alt=media&amp;token=e54822a8-1d63-4053-aafd-2c1cf66c7019" alt=""><figcaption><p><strong>Streaming Mode Appearance</strong></p></figcaption></figure></div>

</details>

***

## Start a Test Chat

1. Select **Widget Preview** or **Streaming Mode**, depending on how the conversation should display.
2. Start chatting with the bot.
3. Responses are generated from the uploaded Business Knowledge.

{% hint style="warning" %}
**Important Note:**&#x20;

1. Test conversations do not appear in the Chat section.&#x20;
2. Switching the Preview tab automatically starts a new chat.&#x20;
3. Testing the bot consumes AI response credits.
   {% endhint %}

<div><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FU1yM5u0JuUWeSrJVrWPF%2Fimage.png?alt=media&amp;token=f2786461-b3ed-4a43-b22d-4680234e3002" alt=""><figcaption><p><strong>Widget Preview Appearance</strong></p></figcaption></figure> <figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FmYEpJIWsYSZP0oeRnEZ9%2Fimage.png?alt=media&amp;token=e54822a8-1d63-4053-aafd-2c1cf66c7019" alt=""><figcaption><p><strong>Streaming Mode Appearance</strong></p></figcaption></figure></div>