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

# Report a Bug

> Learn how to report a technical issue in Agentsy with clear reproduction steps, useful diagnostics, and appropriate privacy precautions.

If something in Agentsy does not work as expected, a clear bug report helps the support team understand the problem and investigate it more efficiently.

This guide explains what to check first, what information to include, and how to report an issue without exposing private account or visitor information.

## Before reporting an issue

Try these quick checks to determine whether the issue is temporary or specific to your setup:

1. **Reload the page** and try the action again.
2. **Check your connection** and whether other websites are working normally.
3. **Try a private browsing window** to rule out browser extensions or cached sessions.
4. **Check the relevant configuration**, such as assistant instructions, knowledge files, access settings, or custom-domain DNS.
5. **Record whether the problem happens consistently** or only occasionally.

> [!NOTE]
>
> If the problem involves an unexpected charge, account access, or potentially exposed information, prioritize contacting support rather than repeatedly reproducing the issue.

## Identify the type of problem

The area affected helps determine which details to collect.

| Problem area | Examples | Helpful information |
| - | - | - |
| Sign-in and access | Login fails, visitor is redirected to sign-in, invitation does not work | URL, account role, error text, time of attempt |
| Assistant conversations | No response, streaming stops, error appears | Test question, approximate time, whether the issue repeats |
| Answer quality | Assistant ignores instructions or gives unsupported information | Expected behavior, actual answer, relevant knowledge source |
| Knowledge management | File fails to upload or information cannot be retrieved | File type, approximate size, upload status, test question |
| Branding and website | Layout problem, broken link, mobile display issue | Page URL, device, screen size, screenshot |
| Domains and SSL | Domain does not resolve, certificate warning, incorrect redirect | Custom domain, DNS changes, exact browser error |
| Billing | Payment fails, invoice missing, coupon not reflected | Invoice reference, billing date, non-sensitive charge details |

For topic-specific troubleshooting, see [Assistant Response Issues](/troubleshooting-and-support/assistant-response-issues), [Knowledge Retrieval Problems](/troubleshooting-and-support/knowledge-retrieval-problems), [Domain and SSL Issues](/troubleshooting-and-support/domain-and-ssl-issues), or [Billing Problems](/troubleshooting-and-support/billing-problems).

## Gather the information needed for a bug report

A good report answers five questions: **What happened? Where? When? How can it be reproduced? What should have happened instead?**

### 1. Describe the issue clearly

Use a short, specific summary. For example:

* "Guest chat redirects visitors to the sign-in page after clicking the logo"
* "Assistant response stops streaming after the first paragraph"
* "Custom domain displays a certificate warning on mobile"

Avoid vague descriptions such as "the platform is broken" when more specific details are available.

### 2. Include steps to reproduce

List the actions in the order they occurred. For example:

1. Open the public AI Experience at its published URL.
2. Select the option to try the assistant as a guest.
3. Start a conversation.
4. Click the website logo to return to the main page.
5. Observe the resulting URL and message.

> [!TIP]
>
> If you can reproduce the issue, try to identify the **smallest sequence of actions** that triggers it. This is often more useful than a long description of everything you did beforehand.

### 3. Explain expected and actual behavior

Be explicit about the difference:

| | Example |
| - | - |
| **Expected** | Clicking the logo returns the visitor to the public AI Experience homepage. |
| **Actual** | The visitor is redirected to a sign-in page and sees an authentication warning. |

Include the exact error message when possible, but remove any private or sensitive details.

### 4. Record the environment

Include what you know:

* **Page URL:** The affected public or administrative page.
* **Device:** Desktop, tablet, or phone.
* **Operating system:** For example, macOS, Windows, iOS, or Android.
* **Browser:** For example, Chrome, Safari, Firefox, or Edge; include its version if available.
* **Approximate date and time:** Include your time zone.
* **Frequency:** Every attempt, sometimes, or once.
* **Scope:** Only your account, only one AI Experience, or multiple users, if known.

Do not spend time collecting technical details you cannot easily access. A clear description and reproducible steps are a strong starting point.

### 5. Attach supporting evidence

Screenshots or short screen recordings can make a visual or intermittent problem easier to diagnose. Where appropriate, include:

* A screenshot of the error message.
* A short recording showing the steps leading to the issue.
* The affected URL.
* Relevant timestamps or non-sensitive error text.

> [!WARNING]
>
> Before sharing screenshots, recordings, or logs, remove passwords, API keys, authentication tokens, payment card details, private conversation content, and personal information belonging to visitors or clients. Do not send sensitive information simply to make a bug easier to reproduce.

## Use this bug report template

Copy and complete the fields that apply to your issue:

```text theme={null}
Subject: [Short description of the problem]

Affected AI Experience or page URL:

Problem summary:

Steps to reproduce:
1.
2.
3.

Expected result:

Actual result:

Exact error message (if any):

Date, time, and time zone:

Device, operating system, and browser:

How often it happens:

Troubleshooting already attempted:

Screenshots or recording (with sensitive information removed):

Business impact (optional):
```

> [!TIP]
>
> A report does not need every field completed. Send the information you can verify rather than guessing at missing details.

## Report the issue to Agentsy

Use the support contact method available in your Agentsy account or the [Contact Support](/troubleshooting-and-support/contact-support) guide. Include your completed report and any safe supporting evidence.

If the issue prevents you from accessing your account, describe the sign-in problem and provide a reachable contact email. Do not share your password.

### How to describe urgency

Explain the impact rather than assigning an unsupported severity label:

| Impact | Example |
| - | - |
| Blocking | Visitors cannot start any conversation on a published AI Experience. |
| Significant | A key function fails consistently, but other parts of the experience work. |
| Limited | An issue affects one device, browser, or non-critical element. |
| Intermittent | A problem occurs occasionally and is difficult to reproduce. |

> [!NOTE]
>
> Submitting a report does not guarantee a particular response time or resolution date. Available support arrangements may depend on your account or agreement.

## What happens after reporting?

Support may request additional context, a fresh screenshot, or a repeat test to isolate the cause. If the issue changes or resolves, reply to the existing support conversation with the new information so the investigation stays together.

Avoid making multiple configuration changes at once while testing a suspected bug. When possible, change one variable at a time and record the result.

## Bug report checklist

* [ ] I can explain what happened in one or two sentences.
* [ ] I included the affected URL or feature.
* [ ] I documented steps to reproduce the issue, if possible.
* [ ] I described expected and actual behavior.
* [ ] I recorded the approximate time and browser or device.
* [ ] I listed troubleshooting steps already attempted.
* [ ] I removed sensitive information from attachments.
* [ ] I explained whether the issue blocks visitors or business activity.

## Related guides

* [Sign-In Problems](/troubleshooting-and-support/sign-in-problems)
* [Assistant Response Issues](/troubleshooting-and-support/assistant-response-issues)
* [Knowledge Retrieval Problems](/troubleshooting-and-support/knowledge-retrieval-problems)
* [Domain and SSL Issues](/troubleshooting-and-support/domain-and-ssl-issues)
* [Billing Problems](/troubleshooting-and-support/billing-problems)
* [Contact Support](/troubleshooting-and-support/contact-support)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.