> ## 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.

# Describe the data you need

> Tips for writing requests AI Assistant can act on: name the site, the fields, and any filters, then adjust the What I understood card before it builds.

AI Assistant works from what you tell it. The more specific your request, the better it can match a template or a route, and the less you'll need to adjust the task later.

You can write in any language. Each message to AI Assistant can be up to 2,000 characters.

## Start from the page that shows the data

The most effective way to get a working task is to paste the URL of the page where the data appears, not the site's homepage. This helps every route: Browser Use and Cloud Agent spend less time exploring the site, and Auto-detect needs that page to find the data at all.

To get the URL, open the site in your browser, search or set any filters until the data shows, and copy the URL from the address bar.

| Instead of | Paste |
| - | - |
| The store's homepage | The search results page for "wireless earbuds" |
| The job site's homepage | The results page for software engineer jobs in Berlin |

## One site per chat

Each chat builds a task for one site or data source. If you need data from several sites, start a separate chat for each one. For example, to compare prices on Amazon and eBay, build one task in one chat and the other in a new chat.

## What to include

* **The site**: the URL of the page that shows the data, or the site's name if you don't have one.
* **The fields**: name each piece of data you want, such as title, price, rating, and link.
* **Filters and scope**: keywords, locations, categories, date ranges, or how many results you need.
* **How often**: whether you need the data once or on a regular basis.

If you're not sure which site has the data, describe what you need. AI Assistant can [suggest data sources](https://www.octoparse.com/docs/en/ai-assistant/how-it-works.md#suggested-data-sources).

## Examples

| Too vague | Specific |
| - | - |
| Get Amazon data | Collect Amazon.de search results for "wireless earbuds" with title, price, rating, and link |
| Find dentists | Collect dental clinics in New York from Google Maps with name, address, rating, and phone |

For more requests you can copy, with what makes each one work, see [Example requests](https://www.octoparse.com/docs/en/ai-assistant/use-cases.md).

## Pages that need clicks to reach the data

[Browser Use](https://www.octoparse.com/docs/en/ai-assistant/browser-use.md) and [Cloud Agent](https://www.octoparse.com/docs/en/ai-assistant/cloud-agent.md) explore the site before they write the collection rules. If the data still takes some clicking to reach from the page you paste, you can save them time:

* Say how to get there: which tab, filter, or button to use, and where the data sits on the page.
* Say what to do with more results, such as going to the next page or scrolling down.

## Edit the What I understood card

Before it recommends a way forward, AI Assistant sums up your request in a **What I understood** card:

* **Website**: the site it will collect from
* **Goal**: the data you want
* **Constraints**: filters and conditions, such as a location or a price range

If anything is off, select **Edit**, change the details, and select **Save**. Use **Add condition** to add a constraint. You can also just reply in the chat with what to change.

Check the card before you pick a route. To change the request while Browser Use or Cloud Agent is building, select the stop button in the input box, then send your corrected request. Stopping also clears anything you've typed in the input box, so copy it first if you need it. A stopped build leaves an unfinished task in your task list. See [Unfinished tasks](https://www.octoparse.com/docs/en/ai-assistant/manage-ai-tasks.md#unfinished-tasks).

## If the result isn't what you wanted

Before you rely on a task, check its fields and a sample of the data. If something's off, tell AI Assistant what to change in the chat, such as a missing field or a different page. For a task that's already saved, use **Resume Chat** on the task. See [Manage AI tasks](https://www.octoparse.com/docs/en/ai-assistant/manage-ai-tasks.md).

## Related pages

> [card] [How AI Assistant works](https://www.octoparse.com/docs/en/ai-assistant/how-it-works.md)
>
> How it reads your request and picks a route.

> [card] [Troubleshooting](https://www.octoparse.com/docs/en/ai-assistant/troubleshooting.md)
>
> What to do when a build fails or a site blocks it.


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