Skip to content

Mission Commands

Mission commands tell a robot what operation to run.

  • Direction: Downlink (cloud → robot)
  • Topic: robots/{robot_id}/commands
  • Encoding: Cap'n Proto over Zenoh

The agent receives commands, persists the ones it needs (missions, features, objects, settings), and republishes them on local Zenoh for your robot software (or the ROS 2 bridge) to act on. Scheduled missions are held by the agent and fired when due.

Command types

Command Purpose
MissionCommand Run a mission/operation. May reference a feature (e.g. a route or zone) and required capabilities.
DeleteMission Cancel/remove a mission (including a scheduled one).
SetMission / SetMode Set the active mission or operating mode.
GoTo Navigate to a target.
VelocityCmd Direct velocity command.
Stop / Resume Halt or resume operation.
InvokeService Invoke an advertised capability (e.g. Mow).

Teleop is covered separately in Teleoperation; spatial directives and features in Spatial Directives.

MissionCommand fields

Known fields:

Field Notes
mission_id Mission identifier.
run_id Identifier for a specific run/execution.
name Mission name.
user_id Who requested the mission.
detail Mission detail/description.
scheduled_start_ms Epoch-ms start time. If in the future, the agent schedules it; if past, it runs immediately.
expected_end_time_ms Epoch-ms expected completion.
mission_parameters Mission-specific parameters.
capabilities Required capabilities for matching/scoping.
feature Optional associated feature (shape/route). See Spatial Directives.

Detailed field schemas (types, units, and the mission-parameters structure) are coming soon.

Scheduling behavior

  • A mission with a future scheduled_start_ms is scheduled by the agent and fired when due, with a fresh run_id.
  • A mission with a past start time is forwarded immediately.
  • Missions fired too far past their start time may be skipped.

Feedback

Report progress and run status back to the cloud via Mission Feedback.