任务

使用 cloudx CLI 创建和管理定期运行的 CloudX 分析任务。

任务

cloudx tasks 命令用于管理当前账号中定期运行的 CloudX 分析任务。

任务会按五字段 cron 计划运行提示词。CloudX 使用所选的 IANA 时区计算运行时间。

可用命令：

cloudx tasks list：按从新到旧的顺序列出任务。
cloudx tasks get：显示一个任务。
cloudx tasks create：创建任务。
cloudx tasks update：修改任务。
cloudx tasks enable 和 cloudx tasks disable：控制定期运行。
cloudx tasks run：立即将已启用的任务加入运行队列。
cloudx tasks delete：删除任务。

任务命令需要启用 Tasks 功能。读取命令需要 configuration:read 权限。写入命令需要编辑者权限和 configuration:write 权限。

创建任务

--prompt 和 --schedule 为必填项。除非另行设置，否则 CloudX 会使用 UTC 创建已启用的私有任务。

cloudx tasks create \
  --name "每周收入回顾" \
  --prompt "检查每周收入并标记重大变化" \
  --schedule "0 9 * * 1" \
  --timezone Asia/Shanghai \
  --access workspace

省略 --name 时，CloudX 会根据提示词生成名称。

创建标志

标志	必需	默认值	说明
`--prompt`	是		要运行的提示词。
`--schedule`	是		五字段 cron 表达式。
`--name`	否	自动生成	任务名称。最多 120 个字符。
`--timezone`	否	`UTC`	计划使用的 IANA 时区。
`--enabled`	否	`true`	创建已启用的任务。
`--access`	否	`private`	可访问任务并接收通知的用户范围：`private` 或 `workspace`。
`--json`	否	`false`	输出结构化 JSON。

私有任务仅对创建者可见。工作区任务对工作区中的所有成员可见。

列出和查看任务

cloudx tasks list
cloudx tasks list --json
cloudx tasks get task_123
cloudx tasks get task_123 --json

列表视图显示任务 ID、名称、计划、时区、访问范围、状态和下次运行时间。详情视图还显示提示词、创建者和创建来源。

更新任务

设置一个或多个要更新的字段。未指定的字段保持不变。

cloudx tasks update task_123 --schedule "0 10 * * 1"
cloudx tasks update task_123 --timezone Asia/Shanghai
cloudx tasks update task_123 --access workspace

update 支持 --name、--prompt、--schedule、--timezone、--access 和 --json。只有任务创建者可以将工作区任务更改为私有任务。

启用、停用和运行任务

停用任务会暂停其定期运行。重新启用后，任务会恢复计划。

cloudx tasks disable task_123
cloudx tasks enable task_123
cloudx tasks run task_123

cloudx tasks run 会立即将一次运行加入队列。任务必须已启用，且当前不能有正在运行的实例。

删除任务

cloudx tasks delete task_123

任务正在运行时，CloudX 会拒绝删除操作。

结构化输出

所有任务命令都支持 --json。可在脚本和 Agent 工作流中使用该格式。

cloudx tasks create \
  --prompt "总结昨天的表现" \
  --schedule "0 8 * * *" \
  --json

任务响应包含 cron 表达式、时区、可读计划、状态、访问模式、创建者（如适用）、下次运行时间、时间戳和创建来源。