| # Wrist Wearable Assistant — Intent Reference | |
| This document lists every intent the on-device model can emit. Your app parses these tags and runs the matching handler. | |
| ## How intents work | |
| Bot lines in training data and at runtime use this format: | |
| ``` | |
| bot: <INTENT:GET_STEPS> You're at <STEPS_TODAY> of <STEP_GOAL> — keep going! | |
| ``` | |
| | Part | Role | | |
| |------|------| | |
| | `<INTENT:NAME>` | Tells the app **what to do** (fetch steps, start timer, etc.) | | |
| | `<SLOT>` placeholders | Names **which values** the app injects from sensors/settings | | |
| | Text after the tag | What the user **sees or hears** on the watch | | |
| The model never outputs real metric values — only intents and slot tokens. Your runtime replaces slots with live data. | |
| `NONE` is used when the bot only acknowledges or chats with no device action. | |
| --- | |
| ## Steps | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `GET_STEPS` | Read step metrics from the pedometer: today’s count, goals, streaks, week/month totals, comparisons. | `<STEPS_TODAY>`, `<STEPS_YESTERDAY>`, `<STEP_GOAL>`, `<STEPS_REMAINING>`, `<STEP_GOAL_PCT>`, `<STEP_STREAK_DAYS>`, `<STEPS_WEEK_TOTAL>`, `<STEPS_LAST_WEEK_TOTAL>`, `<STEPS_MONTH_TOTAL>`, `<TIME>`, `<DATE>`, `<PERCENT>` | | |
| | `SET_STEP_GOAL` | Change the user’s daily step target. | `<STEP_GOAL>` | | |
| --- | |
| ## Distance | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `GET_DISTANCE` | Read distance metrics: today’s total, last session, units, weekly progress, lifetime mileage, hourly average. | `<DISTANCE_TODAY>`, `<DISTANCE_LAST_SESSION>`, `<DISTANCE_UNIT>`, `<DISTANCE_WEEK_REMAINING>`, `<DISTANCE_WEEK_BEST>`, `<DISTANCE_LIFETIME>`, `<DISTANCE_HOURLY_AVG>`, `<TIME>`, `<DATE>` | | |
| --- | |
| ## Heart rate | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `GET_HEART_RATE` | Read heart rate data: current BPM, resting rate, overnight low, session average, daily peak, elevated minutes, effort zone. | `<HR_CURRENT_BPM>`, `<HR_RESTING_BPM>`, `<HR_RESTING_OVERNIGHT_LOW>`, `<HR_AVG_SESSION>`, `<HR_PEAK_TODAY>`, `<HR_ELEVATED_MINUTES>`, `<HR_ZONE>`, `<DURATION>` | | |
| | `MEASURE_HEART_RATE` | Trigger a live on-demand pulse reading from the optical sensor. | `<HR_CURRENT_BPM>` | | |
| --- | |
| ## Sleep | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `GET_SLEEP` | Read sleep data: duration last night, sleep/wake times, weekly average, awake minutes, goal gap, weekend total. | `<SLEEP_HOURS_LAST_NIGHT>`, `<SLEEP_START_TIME>`, `<SLEEP_WAKE_TIME>`, `<SLEEP_AVG_WEEK>`, `<SLEEP_AWAKE_MINUTES>`, `<SLEEP_GOAL_HOURS>`, `<SLEEP_WEEKEND_TOTAL>`, `<DATE>`, `<DURATION>` | | |
| | `LOG_NAP` | Record or confirm a short nap session. | `<DURATION>`, `<SLEEP_HOURS_LAST_NIGHT>`, `<TIME>` | | |
| --- | |
| ## Calories | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `GET_CALORIES` | Read calorie burn: daily total, active burn, remaining to goal, yesterday comparison, per-mile estimate. | `<CALORIES_TODAY>`, `<CALORIES_ACTIVE>`, `<CALORIES_REMAINING>`, `<CALORIE_GOAL>`, `<CALORIE_GOAL_PCT>`, `<CALORIES_YESTERDAY>`, `<CALORIES_PER_MILE>`, `<DISTANCE_UNIT>`, `<DURATION>` | | |
| | `SET_CALORIE_GOAL` | Change the user’s daily active calorie burn target. | `<CALORIE_GOAL>` | | |
| --- | |
| ## Active minutes | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `GET_ACTIVE_MINUTES` | Read movement time: today’s active minutes, remaining to goal, weekly total, most active day. | `<ACTIVE_MINUTES_TODAY>`, `<ACTIVE_MINUTES_REMAINING>`, `<ACTIVE_MINUTES_GOAL>`, `<ACTIVE_MINUTES_WEEK>`, `<MOST_ACTIVE_DAY>`, `<DURATION>`, `<TIME>`, `<DATE>` | | |
| | `SET_ACTIVE_GOAL` | Change the user’s daily active minutes target. | `<ACTIVE_MINUTES_GOAL>` | | |
| --- | |
| ## Battery | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `GET_BATTERY` | Read power state: percentage, estimated days left, days since charge, charge complete status. | `<BATTERY_PCT>`, `<BATTERY_DAYS_LEFT>`, `<DAYS_SINCE_CHARGE>`, `<CHARGE_COMPLETE>`, `<DURATION>`, `<DATE>` | | |
| | `ENABLE_POWER_SAVE` | Turn on low-power / battery saver mode on the device. | `<BATTERY_PCT>` | | |
| | `DISABLE_AOD` | Turn off always-on display to reduce power draw. | `<BATTERY_PCT>` | | |
| --- | |
| ## Alarms and reminders | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `SET_ALARM` | Create or update a wake alarm at a given time. | `<ALARM_TIME>`, `<ALARM_LABEL>`, `<DATE>`, `<TIME>` | | |
| | `LIST_ALARMS` | Show all alarms currently stored on the device. | `<ALARM_TIME>`, `<ALARM_LABEL>` | | |
| | `DELETE_ALARM` | Remove one or all alarms. | `<ALARM_LABEL>`, `<ALARM_TIME>` | | |
| | `SNOOZE_ALARM` | Snooze the currently firing alarm for a short period. | `<ALARM_TIME>`, `<DURATION>`, `<ALARM_LABEL>` | | |
| | `SET_REMINDER` | Schedule a recurring reminder (water, bedtime wind-down, move prompts). | `<ALARM_TIME>`, `<ALARM_LABEL>`, `<REMINDER_INTERVAL>`, `<TIME>` | | |
| | `MUTE_REMINDERS` | Disable hourly move reminders or similar nudges. | *(none)* | | |
| | `EXPLAIN_NUDGE` | Explain why the watch just vibrated (e.g. sedentary move nudge). | `<NUDGE_REASON>`, `<DURATION>`, `<TIME>` | | |
| --- | |
| ## Timers and stopwatch | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `START_TIMER` | Start a countdown timer (cooking, stretch, etc.). | `<DURATION>`, `<TIME>` | | |
| | `PAUSE_TIMER` | Pause an active countdown. | `<TIMER_REMAINING>`, `<DURATION>` | | |
| | `CANCEL_TIMER` | Stop and clear a running timer. | `<TIMER_REMAINING>`, `<DURATION>` | | |
| | `GET_TIMER_REMAINING` | Report time left on a timer or whether it has finished. | `<TIMER_REMAINING>`, `<DURATION>` | | |
| | `START_STOPWATCH` | Open or start the stopwatch app. | *(none)* | | |
| | `LAP_STOPWATCH` | Record a lap split on the stopwatch. | `<LAP_TIME>`, `<DURATION>` | | |
| | `RESET_STOPWATCH` | Reset stopwatch to zero. | `<DURATION>`, `<LAP_TIME>` | | |
| --- | |
| ## Workout toggles | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `START_WORKOUT` | Begin tracking a workout (walk, run, cycle, indoor cardio). | `<WORKOUT_TYPE>` | | |
| | `PAUSE_WORKOUT` | Pause the active workout session. | `<WORKOUT_ELAPSED>`, `<WORKOUT_STATE>`, `<WORKOUT_TYPE>` | | |
| | `RESUME_WORKOUT` | Resume a paused workout. | `<WORKOUT_ELAPSED>`, `<WORKOUT_STATE>`, `<WORKOUT_TYPE>` | | |
| | `STOP_WORKOUT` | End the workout and save the session. | `<WORKOUT_ELAPSED>`, `<WORKOUT_TYPE>`, `<WORKOUT_STATE>` | | |
| | `DISCARD_WORKOUT` | End the workout without saving data. | `<WORKOUT_TYPE>`, `<WORKOUT_STATE>` | | |
| | `GET_WORKOUT_STATUS` | Check if a workout is running, paused, or left on by mistake; report elapsed time. | `<WORKOUT_ELAPSED>`, `<WORKOUT_STATE>`, `<WORKOUT_TYPE>` | | |
| | `GET_WORKOUT_SUMMARY` | Show the post-workout summary screen (duration, distance, calories, HR). | `<WORKOUT_TYPE>`, `<WORKOUT_ELAPSED>`, `<DISTANCE_TODAY>`, `<DISTANCE_UNIT>`, `<CALORIES_ACTIVE>`, `<HR_AVG_SESSION>` | | |
| --- | |
| ## Non-action | |
| | Intent | What it does | Typical slots | | |
| |--------|--------------|---------------| | |
| | `NONE` | Pure conversational reply — thanks, encouragement, clarification — with no sensor fetch or device command. | *(none)* | | |
| --- | |
| ## Summary | |
| | Category | Intents | Count | | |
| |----------|---------|------:| | |
| | Steps | `GET_STEPS`, `SET_STEP_GOAL` | 2 | | |
| | Distance | `GET_DISTANCE` | 1 | | |
| | Heart rate | `GET_HEART_RATE`, `MEASURE_HEART_RATE` | 2 | | |
| | Sleep | `GET_SLEEP`, `LOG_NAP` | 2 | | |
| | Calories | `GET_CALORIES`, `SET_CALORIE_GOAL` | 2 | | |
| | Active minutes | `GET_ACTIVE_MINUTES`, `SET_ACTIVE_GOAL` | 2 | | |
| | Battery | `GET_BATTERY`, `ENABLE_POWER_SAVE`, `DISABLE_AOD` | 3 | | |
| | Alarms / reminders | `SET_ALARM`, `LIST_ALARMS`, `DELETE_ALARM`, `SNOOZE_ALARM`, `SET_REMINDER`, `MUTE_REMINDERS`, `EXPLAIN_NUDGE` | 7 | | |
| | Timers / stopwatch | `START_TIMER`, `PAUSE_TIMER`, `CANCEL_TIMER`, `GET_TIMER_REMAINING`, `START_STOPWATCH`, `LAP_STOPWATCH`, `RESET_STOPWATCH` | 7 | | |
| | Workout | `START_WORKOUT`, `PAUSE_WORKOUT`, `RESUME_WORKOUT`, `STOP_WORKOUT`, `DISCARD_WORKOUT`, `GET_WORKOUT_STATUS`, `GET_WORKOUT_SUMMARY` | 7 | | |
| | Non-action | `NONE` | 1 | | |
| | **Total** | | **35** | | |
| --- | |
| Each wearable product may implement only a subset of these intents depending on hardware and firmware. | |