Docs menu
  1. Docs
  2. Help
  3. Writing good prompts

Writing good prompts

How to describe a screen so Rivet builds what you meant the first time.

Describe the screen the way you'd brief a new colleague who knows buildings but not your site. Three things make the biggest difference.

1. Say who it's for

"For the facility manager on duty", "for the dock lead", "for the chief engineer's morning meeting". Rivet uses it to decide what matters most and how much detail to show.

2. Say what question it answers

A board exists to answer a question every time someone looks at it. "Which racks are running hot?" "Which trucks are waiting?" "Is anything in the cooling chain outside its normal range?" Put the question in.

3. Say what goes where

If you have a picture in your head, describe it: "four numbers across the top, then a table, then a chart". Name the order of rows: "hottest first", "longest open first".

Examples

Instead of Try
A temperature dashboard A board for the night shift that shows which racks are running hot, hottest first, with their inlet air and GPU temperature
Robot status The robot fleet with each robot's battery, mission and position on the floor plan, with any below 30% at the top
Energy An energy dashboard for the chief engineer: today's consumption for each AHU and chiller against yesterday's, biggest first

Change it afterwards

You don't have to get it all in the first description. Build something close, then ask for changes one at a time: "Put the robots next to the plan", "Colour the GPU temperature red above 52 °C". Small, specific requests work best. Use Inspect to point at the tile you mean.

Use real names

Rivet reads your site's equipment, so you can name it: "Chiller 2", "Data hall B", "the dock doors on the north side". If it picks the wrong one, say which you meant, or point at it with Inspect.

Every site

An app shows one site at a time, and its Site menu opens the same app on any other site. So ask for what you want on the site you're on, such as "a detention figure for this warehouse" or "this store's busiest hour", and Rivet builds it from what that site has, by kind of equipment, so it works on the others too. Rivet doesn't put every site in one table yet.