Skip to main content

Robots

The Robots page maintains the model catalog and shows the number of datasets linked to each model. It also provides the basis for dataset filtering and visualization models. The platform ships with 23 models. Robot-side devices are registered on the Device Management page.

Robot list

Prerequisites​

ItemContent
Menu entryManage → Robot
Route/robots
Required permissionView Robots (model list and model datasets)
Related permissionsManage Robots (link datasets to models), View Teleoperation (read the model list when registering devices)
Visible rolesAdministrator, Project Manager
Write restrictionOnly administrators can create, edit, and delete models; not exposed as a configurable module permission key

Model Browsing​

Model Types​

TypeLabel
HUMANOIDHumanoid Robot
MOBILE_MANIPULATORMobile Manipulator
DESKTOP_ARMDesktop Manipulator
MOBILE_BASEMobile Chassis
QUADRUPEDQuadruped Robot
INDUSTRIAL_ARMIndustrial Manipulator
OTHEROther

Type tabs switch at the top of the list. When a tab other than All is selected, the backend filters by model type.

Model List​

ElementDescription
Card iconVisualization model image of the model
Display nameChinese Title or English Title based on the interface language; falls back to Name when both are empty
ManufacturerModels with a manufacturer show a company tag
Dataset countNumber of datasets linked to the model; select to open the dataset list
Add robotVisible to administrators only
Edit and deleteVisible to administrators only on the card

The search box matches loaded models by name, Chinese title, English title, manufacturer, and introduction.

Model Maintenance​

Model Fields​

FieldTypeRequiredValues and description
Robot nameTextYesUnique identifier, up to 255 characters; cannot be changed when editing
Robot iconImageYesRequired when creating; used for the card and the visualization model
Chinese TitleTextNoUp to 255 characters; Name is shown when empty
English TitleTextNoUp to 255 characters; Name is shown when empty
Robot TypeEnumNoDefaults to Other
Action mapping supportedEnumNoSupported, Coming soon, Not supported; defaults to Not supported
Robot IntroductionTextNoModel description
Robot ManufacturerTextNoUp to 100 characters
Introduction linkURLNoUp to 1000 characters

Dataset Association​

EntryBehavior
Card icon and dataset countJump to the data management page and filter data for the model by robot=<model name>
Model dataset APIReturns datasets linked to the model; fields include file name, size, duration, uploader, upload time, and annotation count

Constraints and Limits​

ItemValueDescription
Built-in models23Match the visualization models
Model name lengthUp to 255Globally unique
Manufacturer lengthUp to 100
Icon and introduction link lengthUp to 1000
Deletion methodSoft deleteReturns a conflict message when the name matches a deactivated model
Write roleAdministratorCreate, edit, delete

Troubleshooting​

SymptomPossible causeActionOwner
Adding a model reports that the name already existsThe name matches an active or deactivated modelChange the name, or restore the deactivated modelAdministrator
Model list is emptyThe type filter returned nothing, or the keyword matched nothingSwitch the type tab or clear the keywordAdministrator, Project Manager
Dataset count is 0No data is linked to the model, or linked data is in a project that the current account cannot seeCheck the model field and project visibility of the data in data managementProject Manager, Administrator
The name is still taken after deletionDeletion is a soft deleteRestore the model or use another nameAdministrator
PagePurpose
Device ManagementDevice registration, Agent installation, and remote takeover
Data ManagementFilter and view data by model
Collection taskDevices and data for collection tasks