OpenParable
Skip to content
← Back to skills

Yao Robot

Apps & Automation
yao-robot

Yao Robot is an Agent Skill for apps & automation published in the YaoApp/yao repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/YaoApp/yao/blob/HEAD/tools/skills/yao-robot/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/yao-robot, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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}'
ParameterTypeRequiredDescription
team_idstringnoFilter by team ID
statusstringnoFilter by robot status
keywordsstringnoSearch in name/bio
pageintegernoPage number (default 1)
pagesizeintegernoPage size (default 20, max 100)

robot_get

Get full robot profile including config, agents, prompts.

tai tool robot_get '{"member_id": "rob-abc123"}'
ParameterTypeRequiredDescription
member_idstringyesRobot 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"]}'
ParameterTypeRequiredDescription
display_namestringyesRobot display name
biostringnoRobot description
system_promptstringnoSystem prompt
agentsarraynoAgent IDs the robot can use
workspacestringnoWorkspace ID to bind
autonomous_modebooleannoEnable autonomous mode
robot_configobjectnoSee robot_config structure below

robot_config structure

Only these sub-fields are accepted (others are silently ignored for security):

Sub-fieldTypeDescription
identityobject{role, duties[], rules[]} — role definition (role required)
quotaobject{max, queue, priority} — concurrency limits
clockobject{mode, times[], days[], every, tz, timeout} — scheduling
triggersobject{clock: {enabled}, intervene: {enabled}, event: {enabled}}
executorobject{mode, max_duration} — execution mode (standard/dryrun/sandbox)
default_localestringDefault language, e.g. "en", "zh"

robot_update

Update robot profile or config fields. Only provided fields are changed.

Warning: robot_config is 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"}'
ParameterTypeRequiredDescription
member_idstringyesRobot member ID
OthersvariesnoSame 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"}'
ParameterTypeRequiredDescription
member_idstringyesRobot 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"}'
ParameterTypeRequiredDescription
member_idstringyesRobot member ID
statusstringnoFilter: pending, running, paused, completed, failed, cancelled, confirming, waiting
pageintegernoPage number (default 1)
pagesizeintegernoPage 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"}'
ParameterTypeRequiredDescription
member_idstringyesRobot member ID
execution_idstringyesExecution 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"}'
ParameterTypeRequiredDescription
member_idstringyesRobot member ID
messagesarraynoInput messages (text/images)
trigger_typestringno"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"}'
ParameterTypeRequiredDescription
member_idstringyesRobot member ID
execution_idstringyesExecution ID

robot_result_list

List completed executions with delivery outputs (reports, files).

tai tool robot_result_list '{"member_id": "rob-abc123"}'
ParameterTypeRequiredDescription
member_idstringyesRobot member ID
pageintegernoPage number (default 1)
pagesizeintegernoPage size (default 20)

Typical Workflow

  1. robot_list — discover available robots
  2. robot_get — get full details of a specific robot
  3. robot_status — check if the robot has available slots
  4. robot_execution_create — trigger a task, get execution_id
  5. robot_execution_get — poll execution progress using execution_id
  6. robot_result_list — retrieve completed results

Guidelines

  • Use robot_list for discovery, robot_get for details (list returns summaries only)
  • robot_status tells you if the robot is busy before triggering
  • After robot_execution_create, use the returned execution_id with robot_execution_get to track progress
  • robot_result_list only shows completed executions with outputs
  • All output is JSON