Skip to main content

guide Step

The guide step walks users through instructions one at a time. Useful for troubleshooting or setup.

Syntax

- guide:
goal: "Connect your device to WiFi"
instructions:
- "Open Settings on your device"
- "Select WiFi"
- "Connect to your home network"
success:
- done: "Great, you are connected"
failure:
- escalate: support
max_attempts: 2
name: "WiFi Setup"

Properties

PropertyTypeRequiredDescription
goalstringYesWhat you are trying to accomplish
instructionsstring[]YesSteps to walk through
successtargetNoWhat to do on success
failuretargetNoWhat to do on failure
max_attemptsnumberNoRetry limit per instruction (default 2)
namestringNoHuman readable step name
verifyobjectNoReserved for future action based verification

Example

- guide:
goal: "Reset your device"
instructions:
- "Unplug the device"
- "Wait 30 seconds"
- "Plug it back in"
success:
- done: "Your device should be back online"
failure:
- escalate: support