《Agent Runtime 工程化》第九章可观测与 Trace：导读

《Agent Runtime 工程化：从工具调用循环到可恢复执行系统》封面

书名：《Agent Runtime 工程化：从工具调用循环到可恢复执行系统》

作者：陈堂会

章节：第九章可观测与 Trace / 导读

第九章可观测与 Trace：导读

Agent 出错后，最怕只剩一句'模型没做好'。这一章讲怎么查清楚。

没有 trace 的 Agent Runtime，就像没有采访记录的新闻调查。出错后只能凭印象复盘：模型好像看过文件，好像调用过工具，好像测试失败了，好像用户批准过。工程系统不能靠'好像'。

OpenTelemetry 把 trace 定义为请求在系统中经过路径的记录，span 是其中的操作单元。Agent Runtime 可以借用这套思想：一次 run 是 trace；一次模型调用、工具调用、权限审批、上下文构建、checkpoint 写入，都是 span。

Trace 与 Eval 反馈闭环

图 9-1：Trace 记录真实运行，Eval 把可复现问题变成回归用例。两者放在一起，可靠性才有抓手。