用途：用于对 Tilebox Workflows（跨集群并行处理引擎）中的作业与集群进行运维操作，适合提交作业、列出作业、查看状态、列出与创建集群、等待作业完成等场景。面向智能体时，建议在每条 job 命令上加 --json，除非明确需要人类可读输出。
主要能力：提交作业（tilebox job submit）、按时间或状态筛选列出（tilebox job list --last 7d --json）、查看单个作业（tilebox job get <job-id> --json）、等待完成（tilebox job wait <job-id> --json）、查看日志（tilebox job logs <job-id> --sort desc --limit 100 --json）、查看追踪与跨度（tilebox job spans <job-id> --sort asc --json）、重试失败任务（tilebox job retry <job-id> --json）、取消作业（tilebox job cancel <job-id> --json）。提交后可产生 trace，每次任务运行生成 span，日志与作业、任务、runner、服务、trace、span 元数据关联。
使用方式：先用 tilebox agent-context job --output-schema 与 tilebox agent-context cluster --output-schema 确认已安装标志与返回结构。提交基本形式为 tilebox job submit --name <job-name> --task <task-identifier-name> --version v0.0 --input '<json-or-plain-text>' --json；--name、--task 必填，--version 默认 v0.0，--input 支持内联 JSON 或纯文本，--input-file 支持文件与 - 读标准输入；--cluster 默认集群可省略，--max-retries 默认 0。仅在确认有可用 runner 时使用 --wait。Python 任务默认标识为 <ClassName>@v0.0，输入须与 serialize_task/deserialize_task 一致，字段数量不同时输入形态不同（无字段可省略、单字段直接传值、多字段传对象）。分页时保持筛选与排序不变，把 next_cursor 传给 --cursor 直到为空。
适用场景与限制：适合提交、观测、排障、重试与取消作业。Python CronTask 或 StorageEventTask 提交需使用 working-with-tilebox-automations 技能，并需 --automation 构造自动化触发器包装。重试应仅在代码、数据、凭据或基础设施问题修复后进行；取消时排队任务不再被拾取，已在运行的任务可能完成。遇到参数或输出结构不明确时使用 agent-context，且不要给它加 --json。