Skip to content

Declare Capabilities

Goal: Declare the services a robot supports so Rover Nexus can match it to missions and operations.

Before you begin

  • The agent is installed and enrolled (see Install the Agent).
  • You can edit <state_dir>/robot.toml (default /var/lib/rdyn/robot/robot.toml) as root.
  • A list of the services this robot can actually perform (for example, a "Mow" service).

How capabilities work

A robot advertises the services it supports. Missions and operations declare the capabilities they require, and the fleet manager only assigns work to robots whose advertised capabilities match. Some services also declare a required role, so the requesting operator must hold that role.

Steps

  1. Open robot.toml on the robot:

bash sudo nano /var/lib/rdyn/robot/robot.toml

  1. Add the capabilities/services this robot supports in the capabilities section. A reference for the exact section name and the key/value shape for declaring a service (service name, parameters, and any required role) is coming soon.

  2. Save the file and restart the agent so it re-advertises:

bash sudo systemctl restart rover-agent

  1. Confirm in the web app that the robot lists the expected services and can be matched to a mission that requires them.

Notes

  • Only declare services the robot can actually perform; missions matched to a missing capability will fail.
  • Services that declare a required role enforce that role at request time.

Next steps