查看追踪

在追踪项目中，使用 线程、追踪 或 运行 标签来更改表格中显示的内容。点击任意行可打开侧面板。 侧面板以线程作为主要导航单元进行组织。界面并非将每个运行视为孤立对象，而是将周围的对话保持可见，以便您了解一个运行在智能体更广泛执行过程中的位置。 侧面板顶部提供三种视图：

• 消息（测试版）：对话层。扫描整个线程的输入、输出、推理、工具调用和子智能体活动。用此视图定位需要查看的位置。按 M 键切换到此视图。
• 轮次：按轮次摘要。以卡片形式查看线程中的每个轮次，显示其输入和输出，并可展开/折叠。当您想要结构性概览而无需完整对话渲染时，请使用此视图。按 T 键切换到此视图。
• 详情：调试层。深入到特定运行以检查输入、输出、时间、令牌计数、错误和元数据。用此视图了解在执行过程中的特定点发生了什么。按 D 键切换到此视图。

使用消息视图在对话中定位自己并确定关注点，然后切换到详情视图检查特定的运行：

​

消息视图

使用消息视图扫描整个线程并识别异常行为，例如糟糕的工具结果、意外的子智能体移交或延迟高峰，然后再深入到特定运行。

​

消息视图显示的内容

线程中的每个轮次都渲染为一个单独的块，包含模型的响应、它触发的工具调用以及这些工具返回的结果。您可以扫描整个线程并阅读智能体的行为，而无需打开子运行。 每个块的元数据行显示：

• 令牌使用量： 调用的总令牌数
• 成本： 调用的总成本
• 模型名称
• 一个指向详情视图中对应运行的 LLM 调用 链接（仅在 AI 消息包含可见文本时显示）

当模型使用扩展思维时，思考 块会以内联方式出现在助手消息中，默认是折叠的。点击可展开该轮次的模型思考链。 子智能体 以不同的操作形式内联出现在对话中。点击一个子智能体会打开该子智能体消息的嵌套视图。点击返回可回到父线程。 工具调用 会与触发它们的助手消息一起显示。每个工具调用卡片都包含一个指向详情视图中其运行的链接。当智能体同时进行多个工具调用（无论是重复调用同一个工具还是并行调用多个不同的工具）时，这些调用会折叠成一个分组行。展开分组可查看每个单独的调用。 要将线程下载为 Markdown 文件，请使用消息视图中的下载按钮。导出的文件包含完整的对话记录，包括人类和 AI 的轮次、工具调用和工具结果，其格式可在任何 Markdown 查看器中阅读。

​

自定义消息视图

您可以使用各个运行的元数据键来控制运行在消息视图中的显示方式。

• ls_agent_type: 控制来自类似智能体运行的消息的显示位置。接受的值：

  值	消息视图行为
  "root"	来自此运行的消息出现在主消息视图中。
  "subagent"	来自此运行的消息作为子智能体操作出现在对话线程中。

  @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: 将单个运行从消息视图中排除。从 langsmith（Python 和 JS）导入常量，或使用字面字符串 "ls_message_view_exclude"。有关代码示例，请参阅从消息视图中排除运行。
  • 对于 @traceable / traceable(): 在标记的运行跟踪上下文中执行的子运行将继承排除属性。
  • 对于 wrap_openai / wrapOpenAI, wrapAISDK, RunTree.createChild, 和 LangChain RunnableConfig: 在您想要隐藏的每个运行上设置键。在这些接口上，向子运行的继承不保证。

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

​

轮次视图

使用轮次视图按轮次扫描线程的结构，无需消息视图的完整对话渲染。线程中的每个轮次都显示为一个卡片，展示根运行的输入和输出。点击卡片的箭头可展开或折叠其内容。 轮次视图在以下情况下很有用：

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

点击任意轮次将在详情视图中打开产生该轮次的运行。

​

自定义轮次视图

默认情况下，LangSmith 使用启发式方法来选取要显示在每个轮次卡片上的输入和输出字段。要覆盖显示哪些字段，请点击线程顶部的 格式 按钮打开格式窗格，选择要显示的特定输入和输出路径，然后保存。您的选择将在项目中保持。

​

详情视图

详情视图是调试层。当您点击一个特定运行时，周围的线程上下文仍然可用，以便您了解该运行在更广泛对话中的位置。在不丢失线程线索的情况下，检查输入、输出、元数据、时间、错误和子运行。

​

自定义详情视图

在运行上设置 run_type="llm" 会使详情视图为该运行渲染令牌计数和延迟。有关完整的消息格式规范，请参阅记录 LLM 追踪。 当运行的 run_type 为 tool 时，工具消息会自动展开。 在运行上设置 run_type="retriever" 会使详情视图为每个检索到的文档内联渲染其内容和元数据。有关所需的返回格式，请参阅记录检索器追踪。

​

操作

在详情视图中，您还可以：

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

---