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.