← 返回概念解读

Concept Fable精修版

运行步骤

Run Step · Agent execution trace

先读故事。这里不急着给定义,先让问题自己长出来。

寓言故事

不是桥塌了才记账,而是每一根梁都有脚印

北门工坊给城里做木桥。过去验收很简单:桥能走人,就算完成;桥走不了,就返工。老师傅们经验足,很多年都靠这个办法过日子。

后来订单变大,桥不再是一整块木板,而是由测量、备料、切割、上漆、运输、安装、复查组成。每一步都可能改变下一步。可账册仍然只写最终结果:成了,或者没成。

第一次大返工来得很突然。桥面装好后发现中段偏了两寸。木匠说自己按图切的,测量师说图没错,运料人说路上没有磕碰。大家围着歪桥吵了一天,谁也找不到偏差从哪一步开始。

管事的补救办法是让每个人最后签名。签名变多了,问题仍然没解决。因为签名只说明这个人来过,不说明他做了什么、用了哪份图、发现过什么异常、异常后来是否被处理。

第二次事故更小,却更贵。一桶防水漆被换成了便宜漆,安装时没人发现,雨季后桥面起泡。账房只看到成本下降,验收人只看到当日平整,等问题显现,已经分不清是哪一次采购、哪一次确认、哪一个判断出了偏差。

新管事换了一本分步册。每一座桥不只登记结果,还记录每个中间动作:谁生成了新图,谁调用了仓库,谁取回材料,哪一步等待审批,哪一步失败重试,哪一步产出了给下一步使用的结果。

一开始,工人觉得这些小记录太碎。可是下一次梁木尺寸不对时,他们只翻了三页就找到原因:测量后的改图没有传给切割台。问题不再需要靠互相猜测,修复也不必推翻整座桥。

年底复盘时,工坊发现分步册还有另一种价值。它能看出哪些步骤最常等待,哪些工具最常出错,哪些人工批准总是拖慢交付。桥的质量不再只靠最后验收,而是靠每一步留下的证据持续变好。

揭示

这个故事讲的是:运行步骤

Run Step 是 Run 中的中间执行记录,例如一次模型消息生成、一次工具调用、一次等待人工动作或一次失败重试。它让团队能够检查 Agent 执行过程,而不是只看最终回答。企业落地时,Run Step 对调试、审计、验收和运营改进都很关键:它回答每一步发生了什么、输入输出是什么、是否成功、耗时多久、下一步为什么这么走。

它重要的地方在于:它不只是一个术语,而是在真实 AI / Agent 系统里会反复出现的结构性问题。理解它,才能判断什么时候该加模型,什么时候该改流程,什么时候该补治理。

隐喻映射

  • 一座桥:一次 Run,也就是一次完整 Agent 执行
  • 测量、切割、运输、安装:Run Step,执行中的可记录中间动作
  • 只写成败:只看最终输出,缺少过程可观测性
  • 最后签名:粗糙审计,不能解释具体行为
  • 分步册:运行步骤记录和执行 trace
  • 改图未传给切割台:Run Step 帮助定位上下文传递断点
  • 等待审批和失败重试:Run Step 也记录非成功路径
  • 持续变好:过程数据支持交付验收、调试和运营优化

Soloharness 判断

这个概念的实战价值,是帮你把“看起来聪明的 AI 功能”拆成可交付、可验收、可治理的工作单元。

runtracetool callmessage creationaudit log