
书名:《Agent Runtime 工程化:从工具调用循环到可恢复执行系统》
作者:陈堂会
章节:第一章 Agent Runtime 全景 / 1.4 step、turn、run、trace、session、checkpoint
电子版系列:查看完整目录
第一章 Agent Runtime 全景:1.4 step、turn、run、trace、session、checkpoint
本书统一使用以下术语。
turn 是一次用户与系统的交互轮次。用户提出一个任务,是一个 turn 的开始。
step 是 runtime 在一个 turn 内的一次模型决策或工具执行推进。一次 turn 可以有很多 step。
run 是一次完整执行,从收到用户请求到最终回答、失败或取消。长任务中,一个 run 可能跨进程恢复。
session 是用户和 Agent 的长期上下文容器。它包含历史消息、运行配置、workspace、用户偏好、权限策略等。
trace 是一次 run 的可观测记录。它不是聊天记录,而是工程记录:每个 step 的输入、输出、耗时、token、工具调用、错误、审批结果。
checkpoint 是可恢复状态的快照。它应当包含对话状态、runtime 状态、必要的文件变更信息,以及恢复时避免重复执行危险工具的标记。
这些词看似琐碎,实际是团队协作的地基。没有统一术语,就无法讨论'这个失败发生在第几个 step''是否应该从 checkpoint 恢复''trace 里看不到 tool result 是 runtime 漏记还是工具没返回'。

