Skip to main content
默认情况下,LangSmith 使用启发式方法来确定在运行表的输入输出列中显示什么内容。但是,您可以通过为特定追踪类型配置自定义预览路径,精确自定义这些列中显示的内容。 这在以下情况下特别有用:
  • 您的追踪具有深层嵌套结构。
  • 您希望聚焦于数据中的特定字段。
  • 默认启发式方法未能显示与您的用例最相关的信息。

在 UI 中配置预览格式

访问预览设置

  1. 导航到项目中的某个追踪。
  2. 选择运行选项卡。
  3. 在运行表顶部找到 格式按钮。
  4. 配置输入和输出预览侧边窗口中,从下拉菜单中选择一个追踪名称。
运行表顶部显示格式按钮,用于配置输入和输出预览 当您选择一个追踪名称时,LangSmith 会加载一个成功的追踪示例,并将其结构渲染为一棵可展开的树。树中的每个节点代表数据中的一个字段,显示:
  • 字段名称(例如,messages、output、metadata)。
  • 数组索引(例如,[0]、[1]、[-1] 表示最后一项)。
  • 数组的项目计数(例如,(3) 表示 3 个项目)。
  • 字符串和数字的预览值以内联方式显示。
配置输入和输出预览侧边面板,显示追踪数据结构的树状视图

设置路径

  1. 选择输入输出选项卡。然后,您可以选择以下任一方式:
    • 使用下拉菜单直接从输入数据中指定应显示在预览中的路径。
    • 使用示例追踪数据结构的交互式树状视图,您可以浏览并选择要显示的确切字段。
    要选择一个字段:
    1. 通过点击箭头图标(▶)展开或折叠嵌套的对象和数组来浏览树。
    2. 点击要显示在预览中的字段旁边的复选框。选定的路径会出现在树前面的文本输入框中。
    当您选择一个复选框时,路径会自动使用正确的语法构建(例如,messages[-1].content)。
方法最适合示例
树状选择探索不熟悉的数据结构,查看示例值点击浏览:messages → [-1] → content
手动输入当您确切知道想要什么时,对于深层路径更快输入:output.data.results[0].answer
包含超过 3 个项目的数组会自动折叠,以防止视图过于复杂:
☐ messages (15)
  ☐ [0]
  ☐ [1]
  ... (点击展开全部 15 个项目)
点击 按钮可以展开并查看所有数组项目。

示例

例如,您的追踪输入如下:
{
  "messages": [
    {"role": "system", "content": "You are a helpful assistant"},
    {"role": "user", "content": "What is the weather today?"}
  ],
  "metadata": {
    "user_id": "user123",
    "session_id": "sess456"
  }
}
要显示用户的问题:
  1. 展开 messages 节点(显示数组项目)。
  2. 展开 [1](第二条消息,即用户消息)。
  3. 点击 content 旁边的复选框。
  4. 输入框显示:messages[1].content
或者,使用负索引表示最后一条消息:
  1. 展开 messages
  2. 展开 [-1]
  3. 点击 content
  4. 结果:messages[-1].content(始终显示最后一条消息)。
如果在树中看到 "No paths available"
  • 请确保在过去 7 天内至少有一个具有所选追踪名称的成功追踪。
  • 该追踪必须在您正在配置的输入/输出字段中包含数据。
  • 如果需要,请尝试发送一个测试追踪。

后续步骤