> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot AI Assistant

> Fix common AI Assistant problems by route: templates, Browser Use, Cloud Agent, and Auto-detect, plus chat limits and errors that can happen on any route.

Find the route you're using, then the message you see. Problems that can happen on any route come first.

## All routes

### Something went wrong on our side

This isn't caused by your request. Select **Retry**: it usually picks up where it stopped. If you see **Retrying didn't recover it. Support can take a look.**, contact support.

### The route you wanted isn't offered

AI Assistant may leave out a route that can't handle the site you asked about yet. Pick one of the routes AI Assistant offers, or contact support. The sites each route supports change as we update AI Assistant.

### Chat and account limits

| Message | What to do |
| - | - |
| Your request is too long. Please shorten it and try again. | Keep each message to AI Assistant under 2,000 characters. |
| This message is too long to send. Shorten it and try again. | Shorten your message to Cloud Agent. |
| This chat has … messages left. You can start a new chat anytime. | The chat is close to its message limit. Finish what you're doing, or start a new chat. |
| This chat has reached its message limit. Start a new chat to continue. | Start a new chat. Your saved tasks aren't affected. |
| This chat is no longer available. | Start a new chat. |
| AI Assistant took too long to respond. Please try again. | Send your message again. |
| AI Assistant is temporarily unavailable. Please try again in a moment. | Wait a moment, then try again. |
| You're out of credits | Select **Add Credits** to pick up where you left off. If you're a team member, ask your admin to add credits. |
| You've hit your task limit | Delete tasks you no longer need, or upgrade your plan. If you're a team member, ask your admin for more tasks. |

### A run stopped early, or collected fewer rows than expected

On Free and Basic, rows from templates, Browser Use, Cloud Agent, MCP, and the API count toward a monthly limit:

* **On Free, a run stops at 100 rows.** The rows collected so far are kept, and you can export them. To collect more in one run, upgrade your plan.
* **When this month's rows are used up**, runs can't collect more until the 1st of next month. Rows can't be bought separately: upgrade your plan to keep collecting.

See [Monthly rows](https://www.octoparse.com/docs/en/ai-assistant/credits-and-plans.md#monthly-rows).

## Templates

### A template doesn't run well, or the data isn't what you expected

See [Troubleshoot templates](https://www.octoparse.com/docs/en/templates/troubleshooting.md). If that doesn't help, contact support: we can fix the template or customize it for you.

### No template covers what you need

Select **Request a custom template** under the template cards, or build your own task with another route. See [If a template doesn't fit or doesn't work](https://www.octoparse.com/docs/en/ai-assistant/templates.md#if-a-template-doesnt-fit-or-doesnt-work).

### Octoparse Desktop is not installed

You selected **Open in Desktop**, but the app didn't open. Select **Download Octoparse**, install it, then select **I've installed it — try again**.

## Browser Use

### AI Assistant can't reach the Octoparse Extension, or Octoparse Extension required

1. [Install Octoparse in Chrome](https://www.octoparse.com/docs/en/ai-assistant/browser-use.md#install-octoparse-in-chrome) if you haven't already.
2. Make sure the extension is turned on in your browser's extensions page.
3. Refresh the AI Assistant page and try again.

If you see the **Octoparse Extension required** dialog, select **Install extension**, then come back and continue the conversation.

### You've reached your plan's limit for this month

Browser Use stops collecting when you reach your plan's limit. Select **Upgrade** to keep collecting, or wait until your limit resets. See [pricing](https://www.octoparse.com/pricing).

### Sign in to continue, or Blocked by a human check

Sign in, or complete the check, on the tab that just opened, then come back and select **Continue**. See [Sign-ins and human checks](https://www.octoparse.com/docs/en/ai-assistant/browser-use.md#sign-ins-and-human-checks).

### The build didn't find the data

| Message | What to do |
| - | - |
| Out of steps, still no result | Select **Continue** to give it another round. Say where the data sits on the page or which fields matter most, so the next round is more likely to work. |
| No approach worked on this site | Another round of the same request is unlikely to help. Change the request instead: ask for fewer fields, start from a different page, or try another site. |
| Couldn't open that page | Check the URL, or describe the page you want in the chat. |
| The run stopped early | Describe what you expected to see, or pick one of the other options AI Assistant shows below the message. |

If **Continue** doesn't help after a couple of tries, it stops appearing. Change the request, or pick another way to get the data from the options below the message. For tips, see [Describe your data](https://www.octoparse.com/docs/en/ai-assistant/describe-your-data.md).

## Cloud Agent

### This run didn't finish

Cloud Agent didn't get through this time. In the chat, say where the data sits, or point to a different site, and it will try again. You'll get an email when the new build is ready.

### I can't schedule the scraper

Scheduled runs need Standard or above. On Free and Basic, start each run yourself with **Configure input and run**, or start a trial if one is offered. See [Run it on Octoparse Cloud](https://www.octoparse.com/docs/en/ai-assistant/cloud-agent.md#run-it-on-octoparse-cloud).

### Generated, but it couldn't start running automatically

The scraper was built, but its first run didn't start. Select **Configure input and run**, check the inputs, and start the run yourself.

## Auto-detect

### The send button is disabled in Auto-detect

Auto-detect needs exactly one page URL. If you see **This mode supports only one page URL**, include exactly one link to the page you want collected.

### Auto-detect didn't find the data

If Auto-detect can't find the data on the page, no task preview appears, no task is created, and AI Assistant explains in the chat. See [If Auto-detect can't find the data](https://www.octoparse.com/docs/en/ai-assistant/auto-detect.md#if-auto-detect-cant-find-the-data).

### Preview generated, cloud save failed

Auto-detect found the data, but the task wasn't saved to your account. Run Auto-detect on the same URL again.

### Octoparse Desktop doesn't open

**Open in Octoparse** needs Octoparse Desktop. If it isn't installed, the download page opens. Install it, then select **Open in Octoparse** again.

## Still stuck

When a route can't get the data, AI Assistant also lists other ways to get it below the message, such as setting the task up yourself in [Octoparse Desktop](https://www.octoparse.com/docs/en/desktop/no-code-builder.md).

* **Contact support** if a route keeps failing, or you need a template fixed or customized.
* **Want us to collect the data for you?** [Octoparse Data Service](https://www.octoparse.com/data-service) builds and runs the collection and delivers the data on schedule. It's a paid service.


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