可观测性：Trace 与 Probe

观测把一次运行拆成可查询的 span：模型调用、工具、代理、审批等。写入失败默认不阻断主路径，避免遥测拖垮会话；列表与详情接口供控制台与排障使用。

Probe

Probe.start / Probe.end 记录一条观测。类型包括 generation、tool、agent、approval、span、event 等。入口 source 可区分 chat / task / command / shell / trigger / summarize 等。

flowchart LR
  Run[会话 / 触发运行] --> G[generation]
  Run --> T[tool]
  Run --> A[agent]
  Run --> P[approval]
  G --> Store[(observation)]
  T --> Store
  A --> Store
  P --> Store

查询

• GET /observation/traces：可按 session、agent、team_run_id、时间、状态过滤；详情含扁平列表与树
• 另有成本、审批相关聚合，以及 Agent Graph 视图

观测不是审计哈希链：前者回答“发生了什么、花了多久”；后者回答“记录是否被改写”。追责仍以哈希链审计为准。

---

相关阅读：

• 角色团队协作
• 端到端主链路
• 哈希链审计