Skip to content

4.10 轨迹视图

本节目标

学会切换到轨迹视图,从"原始记录"的角度回看 agent 每一步到底做了什么。

一个会话,三个视图

打开一个会话,对话区顶部有三个视图 tabSession log对话轨迹

  • 对话视图:默认。展示的是"人话版":你的消息、agent 的回复、折叠的工具行。适合日常查看
  • 轨迹视图:展示的是"原始版":会话里每一轮的完整原始记录,一字不落
  • Session log:会话底层的原始事件日志,按事件流展开,是比轨迹更底层的一层

大多数时候看对话视图就够了。当你想搞清楚"agent 到底干了什么"时,切到轨迹视图。

对话视图 vs 轨迹视图

这是同一个会话的两种呈现。对话视图长这样:

对话视图

它把 agent 的工作流整理成了清晰的消息流。而同一个会话切到轨迹视图,长这样:

轨迹视图

轨迹视图按轮次组织,每一轮完整记录这些内容:

记录段内容
Turn第几轮、第几步
USER你的原始输入
CONTEXT注入的运行时上下文(当前权限、工作区、可用技能等)
ASSISTANTagent 的完整思考过程
TOOL工具调用的原始 JSON 和返回结果

什么时候用轨迹视图

  • 排查"它为什么这么干":对话视图只给结论,轨迹视图能看到它每一步的思考和原始上下文
  • 看上下文注入:想知道 agent 看到了哪些系统提示和技能清单,轨迹里都有
  • 核对工具调用:对话视图的工具行是摘要,轨迹里是工具调用的完整参数和原始返回

怎么切换

点对话区顶部的轨迹 tab 即可切换,再点对话切回来。切换不影响会话内容,只是换一种看法。

小提示

轨迹视图信息量大,是给"查细节"用的。日常干活看对话视图就好,别被原始记录淹没。

常见问题

问:轨迹视图能改内容吗?

不能,轨迹是只读的记录。想改会话内容,在对话里继续发消息或开新会话。

问:轨迹视图能看到删除前的内容吗?

它展示的是会话里已有的记录。会话记录怎么管理,5.1 节会讲。

小结

  • 会话有 Session log、对话、轨迹 三个视图,点顶部 tab 切换
  • 对话视图是人话版,轨迹视图是原始轮次记录(USER/CONTEXT/ASSISTANT/TOOL)
  • 排查细节、核对工具调用时切轨迹视图

到这里,会话里的进阶功能就全部点亮了。下一章回到侧边栏,看看会话怎么管理。

发现错误?提交反馈 · 欢迎 提 PR 改进本书