题目
一条完整 Trace 应如何关联用户请求、模型调用、工具调用、状态和版本信息?
答案
为一次用户请求或任务分配 Trace ID,为每次模型调用、工具调用和关键步骤建立 Span,并记录父子关系。异步队列和子 Agent 继续传递追踪上下文。
任务 ID、模型工具调用 ID 和业务操作 ID 分别保存并相互关联,它们解决的是不同层面的定位问题。还需记录模型、提示词、工具 Schema、知识库和状态结构版本。

每个 Span 记录开始结束时间、状态、Token、重试和错误码;关键状态变更记录为事件。这样能回答“哪一步第一次出错”和“费用花在哪里”。
日志正文应脱敏并受权限控制,大附件保存受控引用。不要为了可观测性把密钥、全部个人资料或内部推理原样存进日志。
