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

# Work with Waldo

> Ask questions, approve actions, read and check answers, and manage chats in Waldo.

This page covers a Waldo chat from prompt to checked answer. To open Waldo and write your first prompt, see [Give Waldo your first prompt](https://docs.wherobots.com/get-started/waldo-quickstart.md).

> [!NOTE]
>
> **Waldo is in public preview.** It's available in every Organization Edition, including the free Professional Edition trial. Features and limits may change before general availability.

A new chat opens on the **Ask Waldo** page. Type in the **Ask about your data** box, or click a suggested prompt to start.

![The Ask Waldo page with suggested prompts and the Ask about your data box](https://mintcdn.com/wherobots/pIL7XBACyDQjslj7/images/develop/waldo/empty-state.png?fit=max\&auto=format\&n=pIL7XBACyDQjslj7\&q=85\&s=e50f016a1fc42e09373557f39a836b30)

A new Waldo chat

## How a chat works

**1. You give Waldo a prompt**

Name the place, what you want measured, and the output you want.

**2. Waldo asks you to clarify**

When a prompt has more than one reading, Waldo asks up to three questions and suggests a default for each. Answer them, or reply "use your defaults".

![Waldo asks clarifying questions, each with a default](https://mintcdn.com/wherobots/cznO35op89Akau7K/images/develop/waldo/clarifying-questions.png?fit=max\&auto=format\&n=cznO35op89Akau7K\&q=85\&s=e091110bc8257f082390b71852d9abec)

Clarifying questions, each with a default

**3. Waldo finds the data**

Waldo searches the catalogs you can access and checks table schemas.

**4. Waldo writes and runs code**

Waldo writes Python or SQL and runs it. Each step shows in the chat as it runs.

![Waldo's expanded steps, each with its status, run time, and rows returned](https://mintcdn.com/wherobots/pIL7XBACyDQjslj7/images/develop/waldo/working-steps.png?fit=max\&auto=format\&n=pIL7XBACyDQjslj7\&q=85\&s=08b457e30eaaf1f8a52225f44a388ffc)

Each step Waldo ran, with its result

**5. Waldo asks before it uses compute or changes anything**

Starting a runtime, running a task, or changing a file needs your approval in the chat. See [Approve actions](#approve-actions).

**6. Waldo returns the answer**

A short summary, tables, a map card, and the method and data Waldo used.

## Read the answer

Each answer starts with the result in one or two sentences, then tables and a map card.

* **Maps.** Click **Open the map** to view the results in Wherobots Map. Click **Save** to keep the map.
* **Tables.** Key numbers and the top results.
* **Method and caveats.** The datasets and definitions Waldo used, their dates, and what the result doesn't cover.

![Mesa rooftop solar results in Wherobots Map, with the layer list on the left and the Waldo sidebar showing an approval card](https://mintcdn.com/wherobots/pIL7XBACyDQjslj7/images/develop/waldo/wherobots-map.jpg?fit=max\&auto=format\&n=pIL7XBACyDQjslj7\&q=85\&s=b156e69655168c2605545d8e72dd11b3)

Results in Wherobots Map, with the Waldo chat alongside

![The method, data, and caveats at the end of an answer](https://mintcdn.com/wherobots/pIL7XBACyDQjslj7/images/develop/waldo/method-and-caveats.png?fit=max\&auto=format\&n=pIL7XBACyDQjslj7\&q=85\&s=8a437f9bfcf778ab09094a83434bd7b8)

The method, data, and caveats at the end of an answer

When Waldo runs a [RasterFlow](https://docs.wherobots.com/develop/rasterflow/index.md) task, the answer links to the run and maps each output, such as the buildings in the area and the detected objects.

![A RasterFlow pilot result for Camberley Place in Mesa, Arizona, with a View run link, two map cards, a summary table, and a map of matched homes and panel detections over aerial imagery](https://mintcdn.com/wherobots/pIL7XBACyDQjslj7/images/develop/waldo/rasterflow-run-maps.jpg?fit=max\&auto=format\&n=pIL7XBACyDQjslj7\&q=85\&s=0534f4df765b9a4358feb5c2bb321df0)

A RasterFlow result, with a link to the run and maps of its outputs

## See what Waldo did

Click **Worked** at the top of an answer to see every step. Expand a step to see the code Waldo ran, how long it took, and how many rows it read. Click the copy icon to reuse the code in a notebook or Job Run.

![An expanded Waldo step showing the SQL it ran](https://mintcdn.com/wherobots/pIL7XBACyDQjslj7/images/develop/waldo/step-code.png?fit=max\&auto=format\&n=pIL7XBACyDQjslj7\&q=85\&s=94364a28230bb6136216fc9981b59361)

The code behind a step

## Approve actions

Waldo asks for your approval before it:

* starts or stops a runtime,
* runs a job, including a job that writes results or copies files,
* creates a Python file, such as a `.py` script,
* changes an existing file or notebook,
* saves or updates a map,
* runs a query that adds, changes, or deletes data, which it can do only if you have write access,
* runs a billed task, such as a RasterFlow task, or
* creates, changes, pauses, resumes, or runs a [task schedule](https://docs.wherobots.com/develop/waldo/schedules.md).

Waldo doesn't ask before read-only actions, such as listing tables, reading data, and searching the web. By default, it also doesn't ask before it creates a new notebook or a new file that isn't Python, such as GeoJSON. To approve those too, set **Create a file** and **Create a notebook** to **Ask** in **Settings** > **Waldo tools**.

An approval card appears in the chat, and Waldo waits until you answer. Choose one:

| Option | What it does |
| - | - |
| **Approve** | Runs this call. Waldo asks again next time. |
| **Always allow** | Runs this call and future calls of the same tool without asking. |
| **Deny** | Skips this call. |
| **Always deny** | Skips this call and future calls of the same tool. |

![The Waldo wants to run card for a RasterFlow task, with Approve, Always allow, Deny, and Always deny](https://mintcdn.com/wherobots/cznO35op89Akau7K/images/develop/waldo/approval-card.png?fit=max\&auto=format\&n=cznO35op89Akau7K\&q=85\&s=d59a93e129a79f394753bca364a3bf01)

An approval card for a RasterFlow task. The task inputs are blurred.

To change a tool you set to **Always allow** or **Always deny**, open **Settings** in Wherobots Cloud and go to **Waldo tools**. Each tool is set to **Ask**, **Always allow**, or **Always deny**. Set web search to **Ask** to approve each search.

For a large job, such as a global scan, Waldo also states the expected size and time and asks before it starts.

![Waldo states the size of a global scan and asks before it starts](https://mintcdn.com/wherobots/cznO35op89Akau7K/images/develop/waldo/asks-before-large-run.png?fit=max\&auto=format\&n=cznO35op89Akau7K\&q=85\&s=26f10fd440a4989dc341b391ba09ccb6)

Waldo asks before a large global scan

## Open Waldo from any page

Click **Ask Waldo** on any page in Wherobots Cloud to open Waldo in a sidebar. The message box shows the page you're on, such as a table, Job Run, saved map, Notebook Runtime, file, or RasterFlow run, and Waldo receives it with your message. To leave the page out, click the **X** next to it.

## Follow up and refine

Keep asking in the same chat. Waldo uses the earlier messages as context. For example:

* "Use half a mile instead of one mile for urban tracts."
* "Show only the rural tracts."
* "Save the results as GeoParquet in My Files."

You can send a message while Waldo is working. Waldo reads it after the current step.

## Files and notebooks

Waldo writes files, such as GeoJSON or a Python script, to **My Files**. It asks before it creates a Python file, changes an existing file, or runs a job that writes files. Waldo can also create a notebook and give you a link to open it.

## Long-running tasks

Some tasks take more than a few minutes. Turn on **Email when done** at the top of the chat, or from the chat's menu in the list, to get an email with the answer.

## Manage chats

* Your chats are listed under **Recents** on the left. Use **Search chats** to find one.
* Open a chat's menu in the list to pin it under **Pinned**, rename it, copy its link, archive it, or turn on **Email when done**.
* Click **New chat** to start over. Start a new chat for an unrelated question.
* Archive a chat you're done with. An archived chat keeps its history but takes no new messages.
* Chats are private. Only you can see and reply to your chats.
* Use the thumbs up or thumbs down icons to rate an answer. Ratings help Wherobots improve Waldo.

## Tips for better results

A good question names four things: the place, the measure, the definition, and the output.

| Instead of | Try |
| - | - |
| Find towers on steep slopes | Find cell towers in King County, WA on slopes steeper than 15 degrees. Show them on a map. |
| Where are the downtowns? | Find the 10 densest clusters of Overture shops and restaurants in King County, WA. Show them on a map. |
| Flood risk in Texas | Count buildings within 100 meters of a river or lake in Harris County, TX, by ZIP code. |

* **Name the data** if you know it, such as "Overture buildings" or "my assets table".
* **Give the data year** if it matters, such as "2020 census tracts".
* **Start small.** Try one county before a whole state.

## Check Waldo's answers

Waldo can make mistakes. Check important results before you share them or act on them. Each answer gives you what you need to check it:

* **The steps.** Every step and its code is under **Worked**.
* **The method.** Answers name the datasets, definitions, and data dates used.
* **Missing data.** If your catalogs lack what the question needs, Waldo stops and says so.

Check these before you rely on a result:

1. **The definition.** Did Waldo use the definition you meant? "Food desert" or "tower site" can mean different things.
2. **The data and its date.** Is the dataset right for your question, and recent enough?
3. **The area.** Did Waldo use an official boundary, not a hand-drawn box?
4. **The numbers.** Do the totals look plausible? Spot-check a few rows on the map.
5. **The code.** Copy the code and re-run it in a notebook if you plan to reuse it.

## Troubleshooting

| Problem | What to do |
| - | - |
| Waldo isn't in the left navigation | An Admin turned Waldo off. Ask them to turn it on in **Organization Settings** > **Preferences**. |
| Waldo can't reach your catalogs | Contact [support@wherobots.com](mailto:support@wherobots.com). |
| Waldo is waiting and nothing happens | Look for an approval card in the chat, and approve or deny it. |
| The reply stopped streaming | Click **Reconnect to this reply**. Waldo keeps working while you're disconnected. |
| Waldo says the data isn't available | The dataset isn't in your catalogs. Add it, or name a dataset that is. |
| A notebook from Waldo shows "No Kernel" | Select the Python 3 kernel, then run all cells. |
| Waldo stopped with a quota message | Your Organization's token quota is used up. Contact your account team or [support@wherobots.com](mailto:support@wherobots.com). |
| An interrupted reply didn't finish | Click **Retry this reply**, or ask the question again. |

Per-chat cost doesn't show in the chat yet. Check [Usage History](https://docs.wherobots.com/develop/workload-history.md) for compute usage.


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