STEP Span 是 0.1.2 版本新增的语义层级,它让 Agent 执行的「第几轮」变得可观测。具体来说,STEP 使用 gen_ai.span.kind=STEP 标识,并补齐了三个关键语义字段:gen_ai.operation.name=react 标识操作类型为 ReAct 模式、gen_ai.react.round 标识当前是第几轮迭代、gen_ai.react.finish_reason 标识该轮结束的原因。最终形成了标准的 ReAct 层级结构:ENTRY -> AGENT -> STEP -> (LLM/TOOL...)。这种结构的价值在于:排障时可以精确定位到「第 N 轮」出现了问题,而不是在整个链路中盲目搜索。结合 finish_reason 字段,可以快速判断某一轮是正常结束、工具调用失败还是超时退出,将故障定位路径从分钟级压缩到秒级。
加载中...