Skip to main content
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.
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

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

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

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

Results in Wherobots Map, with the Waldo chat alongside

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

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

When Waldo runs a RasterFlow 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

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

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.
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:
The Waldo wants to run card for a RasterFlow task, with Approve, Always allow, Deny, and Always deny

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

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

Per-chat cost doesn’t show in the chat yet. Check Usage History for compute usage.