By name: yao-robot description: Robot management expert. ALWAYS invoke this skill when you need to list, create, update, or manage robots, check robot status, trigger robot executions, cancel tasks, or retrieve execution results. Use this skill before guessing robot APIs.
Robot Tools
Ten tools for managing robots and their executions, called via bash.
robot_list
List robots with summary info. Use robot_get for full details.
tai tool robot_list '{}'
tai tool robot_list '{"keywords": "weather", "page": 1, "pagesize": 10}'
| Parameter | Type | Required | Description |
|---|---|---|---|
team_id |
string | no | Filter by team ID |
status |
string | no | Filter by robot status |
keywords |
string | no | Search in name/bio |
page |
integer | no | Page number (default 1) |
pagesize |
integer | no | Page size (default 20, max 100) |
robot_get
Get full robot profile including config, agents, prompts.
tai tool robot_get '{"member_id": "rob-abc123"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
member_id |
string | yes | Robot member ID |
robot_create
Create a new robot with profile and config.
tai tool robot_create '{"display_name": "Weather Bot", "bio": "Reports weather daily"}'
tai tool robot_create '{"display_name": "Code Reviewer", "system_prompt": "You review code", "agents": ["yao.agent-smith"]}'
| Parameter | Type | Required | Description |
|---|---|---|---|
display_name |
string | yes | Robot display name |
bio |
string | no | Robot description |
system_prompt |
string | no | System prompt |
agents |
array | no | Agent IDs the robot can use |
workspace |
string | no | Workspace ID to bind |
autonomous_mode |
boolean | no | Enable autonomous mode |
robot_config |
object | no | See robot_config structure below |
robot_config structure
Only these sub-fields are accepted (others are silently ignored for security):
| Sub-field | Type | Description |
|---|---|---|
identity |
object | {role, duties[], rules[]} — role definition (role required) |
quota |
object | {max, queue, priority} — concurrency limits |
clock |
object | {mode, times[], days[], every, tz, timeout} — scheduling |
triggers |
object | {clock: {enabled}, intervene: {enabled}, event: {enabled}} |
executor |
object | {mode, max_duration} — execution mode (standard/dryrun/sandbox) |
default_locale |
string | Default language, e.g. "en", "zh" |
robot_update
Update robot profile or config fields. Only provided fields are changed.
Warning:
robot_configis a full replace, not a merge. If you only pass{"quota": {"max": 5}}, other sub-configs (identity, clock, etc.) will be cleared. Always pass the complete robot_config when updating.
tai tool robot_update '{"member_id": "rob-abc123", "bio": "Updated description"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
member_id |
string | yes | Robot member ID |
| Others | varies | no | Same as robot_create (optional) |
robot_status
Check if robot is busy: running task count, available slots, last/next run times.
tai tool robot_status '{"member_id": "rob-abc123"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
member_id |
string | yes | Robot member ID |
robot_execution_list
List executions (tasks in progress or recent history).
tai tool robot_execution_list '{"member_id": "rob-abc123"}'
tai tool robot_execution_list '{"member_id": "rob-abc123", "status": "running"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
member_id |
string | yes | Robot member ID |
status |
string | no | Filter: pending, running, paused, completed, failed, cancelled, confirming, waiting |
page |
integer | no | Page number (default 1) |
pagesize |
integer | no | Page size (default 20) |
robot_execution_get
Get execution details: goals, tasks, progress, errors.
tai tool robot_execution_get '{"member_id": "rob-abc123", "execution_id": "exec-xyz"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
member_id |
string | yes | Robot member ID |
execution_id |
string | yes | Execution ID |
robot_execution_create
Trigger a new execution. Returns execution_id for tracking.
tai tool robot_execution_create '{"member_id": "rob-abc123", "messages": [{"role": "user", "content": "Generate report"}]}'
tai tool robot_execution_create '{"member_id": "rob-abc123", "trigger_type": "human"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
member_id |
string | yes | Robot member ID |
messages |
array | no | Input messages (text/images) |
trigger_type |
string | no | "human" or "event" (default human) |
robot_execution_cancel
Cancel a running execution.
tai tool robot_execution_cancel '{"member_id": "rob-abc123", "execution_id": "exec-xyz"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
member_id |
string | yes | Robot member ID |
execution_id |
string | yes | Execution ID |
robot_result_list
List completed executions with delivery outputs (reports, files).
tai tool robot_result_list '{"member_id": "rob-abc123"}'
| Parameter | Type | Required | Description |
|---|---|---|---|
member_id |
string | yes | Robot member ID |
page |
integer | no | Page number (default 1) |
pagesize |
integer | no | Page size (default 20) |
Typical Workflow
robot_list— discover available robotsrobot_get— get full details of a specific robotrobot_status— check if the robot has available slotsrobot_execution_create— trigger a task, getexecution_idrobot_execution_get— poll execution progress usingexecution_idrobot_result_list— retrieve completed results
Guidelines
- Use
robot_listfor discovery,robot_getfor details (list returns summaries only) robot_statustells you if the robot is busy before triggering- After
robot_execution_create, use the returnedexecution_idwithrobot_execution_getto track progress robot_result_listonly shows completed executions with outputs- All output is JSON