Appearance
Timeline 与 Evidence 表面
Timeline 和 Evidence surfaces 解释 Agent 工作如何发生,以及结果是否可信。它们应可用,但不应压垮主 conversation。
Timeline 层级
| 层 | 目的 | 默认 UI |
|---|---|---|
| Inline process | 当前 turn 状态和关键事件。 | 紧凑且实时。 |
| Turn timeline | Tool calls、reasoning summaries、actions、artifacts。 | 默认折叠。 |
| Session timeline | 多回合历史和 incidents。 | 懒加载或分页。 |
| Diagnostic log | Provider、routing、retries、performance。 | 开发或支持视图。 |
| Evidence pack | 可导出审计资产。 | 后台任务和 evidence panel。 |
| Replay case | 可复现情境或失败 trace。 | Debug 或 review entry。 |
不是每个事件都属于用户可见 timeline。详细 facts 可以存储,但 UI 在用户请求细节前只投影有用摘要。
Inline process 与 timeline 归档
Inline process 负责当前 active turn 的 live 状态。Turn timeline 负责 completed 或历史 turn 的可检查归档。两者 SHOULD 使用相同 runtime facts,但不应在同屏展示同一 fact 的两份详情。
推荐规则:
- 当前 running turn:reasoning、tool progress、action-required 和 runtime status 在 inline process 中实时显示,并默认展开关键 running step。
- Turn 完成后:process items 移入 turn timeline,默认折叠为稳定摘要,用户需要时再展开。
- 旧 session hydration:先恢复 recent messages 与 compact process summary,详细 timeline 延迟到 idle 或用户展开。
- Timeline summary 应优先使用 tool summary、turn summary、artifact/action label 或完整 reasoning summary;不要使用流式碎片 token 作为标题。
- 如果同一 tool/reasoning item 已在 inline process 展开,timeline 可以显示占位 summary 或完全隐藏该详情,直到 run 完成。
Evidence facts
Evidence surfaces SHOULD 消费明确 evidence facts:
- source id 和 title
- source location 或 citation anchor
- artifact id 或 task id
- verification state
- reviewer decision
- replay reference
- generated timestamp
- provenance 或 tool reference
- disputed 或 stale status
缺少 evidence 时,显示 unavailable 或 unknown,不要编造 citations。
Review 和 replay
Review decisions 与 replay cases 不是模型输出。
- Review decision SHOULD 表示人工或策略评审结果。
- Replay case SHOULD 捕获足够上下文以复现运行或失败。
- Evidence export 可能昂贵时 SHOULD 作为后台任务。
- UI status SHOULD 来自 evidence facts,而不是前端乐观推断。
来源链接
Generated artifacts 和 final answers SHOULD 在可用时链接 evidence:
text
final answer -> evidence refs
artifact -> source refs
process item -> tool refs
review decision -> evidence pack
replay case -> runtime trace这让用户能从 answer 到 source、从 artifact 到生成 turn、从 failure 到 diagnostic trace。
验收场景
- 旧 session 的 timeline details 懒加载。
- Tool events、artifacts、approvals 完成后仍可链接。
- 只有 source facts 存在时才显示 citations。
- Evidence export 不阻塞 active turn。
- Review 和 replay views 使用同一底层 evidence facts。
- 当前 running turn 的 process 详情不在 inline process 和 timeline 中双重展开。
- Running process 展开,completed process 默认折叠归档。