Skip to content

Job、Task 与生命周期 ​

Job 暴露应用能力,Task 同步执行研究并持久化证据。CLI、HTTP、MCP 和 Studio 访问相同的已配置 Job,原生 Task 执行是独立的 CLI 操作。

Job 命令归属、Task 执行与持久化证据

对照 ​

概念执行方式所有权与输出
Job异步 StepApplication,返回 JobResponse 和可选事件
Task同步步骤及子任务CLI 执行进程,保存 metadata、文件并返回退出码
Task index读取工作区记录Application,提供摘要、关系图和事件流
Daemon监督服务和定时命令宿主,负责进程生命周期和更新

从名称到执行身份 ​

task_type、注册名和 task_name 组成 type#registration#instance。metadata 的 started_at 标识当前执行。运行所有权还包括 machine_id、pid、process_started_at、可选的可达 execution_target 和源 workspace_dir。

demo 等注册名解析到类,task_name 标识实例,例如 base#demo#check。

本地与远程执行 ​

本地 exec 在 CLI 进程执行。exec --target HOST:PORT 调用目标服务的 cli Job,由它拥有命令子进程并传输 stdout/stderr 直到完成。HTTP/MCP 调用方可用 argv: ["exec", "--task", "demo", ...] 调用 cli。命令响应包含 stdout、stderr、exit_code 和截断标志。默认 cli Job 在连接关闭后继续执行,持续读取 stdout/stderr 并丢弃无人订阅的输出事件。停止执行使用 Task kill;服务关闭会停止其命令进程组。重试前先检查证据。

选择抽象 ​

研究使用 BaseTask,同步子任务调用使用 run_task();异步应用能力使用 Job Step,可复用受管理资源使用 Component。插件只注册 Task,框架 provider 在应用装配时显式提供。

状态含义 ​

Task 状态为 running、succeeded、failed。成功结果退出码为 0,进程停止和异常会导致失败。步骤状态还包括 pending、waiting、done、missed、skipped。业务窗口 incomplete 不一定使整个 Task 失败。

步骤进度 ​

执行器运行 build_task_steps() 生成的同步 callable,记录进度和计时,关闭资源后构建最终输出。report_progress() 支持命名子步骤,生命周期完成前应停止后台生产者。publish_output() 持久化经校验的部分业务结果。

生命周期记录发布 ​

metadata.json 是当前生命周期文档,通过原子替换发布完整快照;步骤事件日志支持观察。最终业务输出和终态在同一 metadata 中发布。运行时在整个执行及覆盖期间持有 persistent/task.lock 文件锁,拒绝同 ID 并发执行,不创建全局锁目录;任意文件系统删除仍需调用方协调。

固定名称重跑 ​

运行时核对旧执行已停止,拒绝未确认或异机的 running 记录,再替换当前文件并保留 persistent/。自动名称发生冲突时拒绝执行。显式重跑会推进 started_at,目录不是不可变历史。替换生产任务前应消费或固定其产物。每次 Task 结束后,运行时向 persistent/history.jsonl 追加一行完整的终态元信息 JSON,包括输入、输出、子调用及产物修订;失败执行和确认进程已退出的对账也追加一条终态记录。运行中更新仍保存在 metadata.json。追加时加锁、刷盘,并清理上次中断留下的不完整末行。历史保留元信息,不保存旧产物。

等待与停止 ​

wait_task 内部捕获当前 started_at,等待时改变则失败。查询不修正失效 running 状态。启动检查和显式 kill 可修正确认已退出的本机记录;权限不足和异机进程保持未验证。

axonx kill --task-id ID --timeout 5 --force false 核对身份,停止后代和根执行并重新读取记录。子任务共享根执行进程。远程停止使用执行所在机器和工作区。观察或删除不能代替停止进程。

Task 契约 · 任务管理

Agent-native quant research.