查看追踪

使用轨迹（Trajectory）视图或详情（Details）视图在 LangSmith 中检查 agent 线程。

从追踪项目出发，使用 Threads、Traces 或 Runs 标签来改变表格中显示的内容。要缩小到特定行，请应用一个过滤器。点入任意一行以打开侧面板。

侧面板以线程作为导航的主要单元来组织。UI 不会把每个运行当作孤立对象，而是保持周边对话可见，以便你理解某个运行在 agent 更广泛执行中的位置。

NOTE

Threads 标签和 Turns 视图仅对用 thread_id 元数据字段插桩的运行可用。没有线程插桩时，你会将追踪看作单个运行，且无法访问 Turns 视图。

侧面板顶部有三种视图可用：

• Trajectory：对话层。将轨迹作为输入、输出、推理、工具调用和子 agent 活动进行浏览。用它来找到该看哪里。按 T 切换到该视图。
• Turns：逐轮摘要。将线程中的每一轮视作一张显示其输入和输出的卡片查看，可展开/折叠。当你想要一个不带完整对话渲染的结构概览时使用它。
• Details：调试层。点入某个特定运行以检查输入、输出、计时、token 计数、错误和元数据。用它来理解在执行中某个特定点发生了什么。按 D 切换到该视图。

NOTE

对于没有任何可渲染消息的线程，Trajectory 标签会被禁用。侧面板默认使用 Details 视图。

使用 Trajectory 视图在对话中定位自己并识别需要关注之处，然后切换到 Details 视图以检查某个特定运行：

Start in the Trajectory view

打开一个线程并切换到 Trajectory 视图，以查看完整对话。

Investigate

浏览轨迹以识别意外行为，例如糟糕的工具结果、意外的子 agent 交接、延迟飙升。

Inspect the run

点击相关消息或工具调用，以在产生它的那个精确运行处打开 Details 视图。检查其输入、输出、计时、错误和元数据。

Return to the trajectory

切换回 Trajectory 视图以继续浏览对话。

Trajectory 视图

使用 Trajectory 视图浏览完整的轨迹并识别意外行为（例如糟糕的工具结果、意外的子 agent 交接或延迟飙升），然后再深入某个特定运行。

Trajectory 视图显示什么

轨迹中的每一轮都渲染为单个块，包含模型的响应、它触发的工具调用，以及那些工具返回的结果。你可以浏览完整轨迹并读取 agent 的行为，而无需打开一个子运行。

每个块的元数据行显示：

• Token 用量： 该调用的 token 总数
• 成本： 该调用的总成本
• 模型名称
• 一个指向 Details 视图 中相应运行的 LLM call 链接（仅当该 AI 消息有可见文本时显示）

当模型使用扩展思考时，Thought 块会默认折叠，并内联出现在 assistant 消息中。点击以展开该轮模型的思维链。

子 agent 作为独立动作内联出现在对话中。点入一个子 agent 以打开该子 agent 消息的嵌套视图。点击返回以回到父线程。

工具调用 与其触发的 assistant 消息一同出现。每个工具调用卡都包含一个指向其在 Details 视图 中运行的链接。当 agent 一起进行多个工具调用时——无论是重复调用同一个工具，还是并行调用多个不同工具——这些调用会折叠成一个分组的单行。展开该组以查看每个单独的调用。

要将线程下载为 Markdown 文件，请使用 Trajectory 视图中的下载按钮。导出的文件包含完整的对话文字记录，含人工和 AI 轮次、工具调用和工具结果，并格式化为可在任何 Markdown 查看器中阅读。

自定义 Trajectory 视图

你可以使用单个运行上的元数据键来控制运行在 Trajectory 视图中的显示方式。

• ls_agent_type：控制一个类 agent 运行的消息出现在何处。接受的值：

  值	Trajectory 视图行为
  "root"	该运行的消息出现在主 Trajectory 视图中。
  "subagent"	该运行的消息作为对话线程中的一个子 agent 动作出现。

  @traceable(metadata={"ls_agent_type": "root"})
  def my_agent():
      ...

• ls_message_format：覆盖自动格式检测。接受的值：

  • "langchain"：按 LangChain 消息格式解析
  • "completions"：按 OpenAI Chat Completions 格式解析
  • "responses"：按 OpenAI Responses API 格式解析
  • "anthropic"：按 Anthropic 消息格式解析

• LS_MESSAGE_VIEW_EXCLUDE：将某个单独的运行从 Trajectory 视图排除。从 langsmith 导入该常量（Python 和 JS），或使用字面字符串 "ls_message_view_exclude"。有关代码示例，参阅从 Trajectory 视图排除运行。

  • 对于 @traceable / traceable()：在被标记运行的追踪上下文内执行的子运行会继承该排除。
  • 对于 wrap_openai / wrapOpenAI、wrapAISDK、RunTree.createChild 和 LangChain RunnableConfig：在你想要隐藏的每个运行上设置该键。对这些界面，向子运行的继承并不保证。

有关自动设置此元数据的集成，参阅Trajectory 视图集成。

Turns 视图

使用 Turns 视图逐轮浏览一个线程的结构，而不带 Trajectory 视图的完整对话渲染。线程中的每一轮都作为一张卡片出现，显示根运行的输入和输出。点击卡片的箭头以展开或折叠其内容。

Turns 视图在以下情况下很有用：

• 线程没有可渲染的消息（例如，来自一个不被 Trajectory 视图支持的集成的追踪）。
• 你希望在决定深入哪一轮之前，快速浏览线程的结构概览。
• 你希望查看每轮的原始输入和输出，而不将其规范化为聊天式对话。

点入任意一轮，以在产生它的那个运行处打开 Details 视图。

自定义 Turns 视图

默认情况下，LangSmith 使用启发式方法挑选每张轮次卡上显示哪些输入和输出字段。要覆盖显示哪些字段，请点击线程顶部的 Format 按钮以打开格式面板，选择你要显示的特定输入和输出路径，并保存。你的选择会针对该项目持久保存。

Details 视图

Details 视图是调试层。当你点入某个特定运行时，周围的线程上下文仍然可用，以便你理解那个运行在更广泛对话中的位置。检查输入、输出、元数据、计时、错误和子运行，而不失去对线程的把握。

自定义 Details 视图

在某个运行上设置 run_type="llm" 会使 Details 视图为该运行渲染 token 计数和延迟。有关完整的消息格式规范，参阅记录一个 LLM 追踪。

当一个运行的 run_type 为 tool 时，工具消息会自动展开。

在某个运行上设置 run_type="retriever" 会使 Details 视图将每个检索到的文档连同其内容和元数据一并内联渲染。有关所需的返回格式，参阅记录检索器追踪。

动作

从 Details 视图，你还可以：

• 分享一个追踪： 生成一个指向该追踪的公开链接。参阅管理一个追踪。
• 查看服务器日志： 访问与某个由 LangSmith 部署生成的追踪相关联的服务器日志。参阅管理一个追踪。
• 添加到数据集： 将该运行保存为数据集中一个用于评估的示例。参阅在应用中管理数据集。
• 添加到标注队列： 将该运行或其整个线程发送到队列以进行人工复核和反馈。参阅标注队列。

---