用途：在 OpenHands Cloud 沙箱中按 cron 计划运行定时任务，适合生成报告、健康检查、数据同步、代码审查、安全扫描等重复性工作。
主要能力：提供两类创建预设。Prompt 预设（POST /api/automation/v1/preset/prompt）用自然语言描述任务，服务自动生成 SDK 样板、打包并上传；Plugin 预设（POST /api/automation/v1/preset/plugin）可加载带技能、MCP 配置、钩子和命令的插件。管理接口包括列表 GET /api/automation/v1、详情 GET /api/automation/v1/{id}、更新 PATCH、删除 DELETE、手动触发 POST /api/automation/v1/{id}/dispatch、运行记录 GET /api/automation/v1/{id}/runs。
使用方式：所有请求需 Bearer 认证，生产主机为 app.all-hands.dev。创建时提供 name、prompt、trigger（type 必须为 cron，schedule 为 5 段 cron 表达式，timezone 为 IANA 时区，默认 UTC），可选 timeout。插件预设还需 plugins 列表，source 支持 github:owner/repo、git URL 或本地路径，可选 ref 与 repo_path。
限制与注意：应优先使用预设端点，不要自行编写 SDK 脚本或打包 tarball，除非用户明确要求；若预设无法满足需求，应向用户说明选项由其选择。运行状态包括 PENDING、RUNNING、COMPLETED、FAILED。运行结束后沙箱默认保留，直到超时或被手动删除。自定义自动化的完整参考见 references/custom-automation.md。