Agent Trace 与可观测性
Trace 记录一次任务中的模型生成、工具调用、交接、护栏和耗时。
为什么重要
没有轨迹只能看到错误结果，无法定位决策失败在哪一步。
核心原理
事件应关联同一 trace_id，记录输入摘要、输出、状态、耗时、Token 和错误，并对敏感内容脱敏。
工程实现
- 统一事件模型
- 结构化错误
- 线上样本可回放
最小示例
工具超时可定位到具体调用和重试，而不是只看到“任务失败”。
常见误区
- 只记录最终文本
- 日志包含密钥或完整隐私数据
面试怎么说
Agent 可观测性要覆盖决策轨迹、工具执行、成本和错误，而不只是 HTTP 日志。