配置运行的输入与输出预览

通过为特定追踪类型配置自定义预览路径，自定义 Runs 表中 Input 与 Output 列的显示内容。

默认情况下，LangSmith 会使用一种启发式规则来决定在 Runs 表的 Input 和 Output 列中显示什么内容。不过，你可以通过为特定追踪类型配置自定义预览路径，精确控制这些列中显示的内容。

这在以下场景中尤其有用：

• 你的追踪结构嵌套很深。
• 你希望只关注数据中的特定字段。
• 默认的启发式规则没有展示出对你的用例最有价值的信息。

在 UI 中配置预览格式

访问预览设置

1. 进入你项目中的某条追踪。
2. 选择 Runs 标签页。
3. 找到格式图标

•

位于运行表的右上角。 4. 在 Configure Input and Output previews 侧边窗口中，从下拉列表中选择一个追踪名称。

当你选择某个追踪名称后，LangSmith 会加载一条成功的追踪示例，并将其结构渲染为可展开的树。树中的每个节点都代表数据中的一个字段，并显示：

• 字段名称（例如 messages 表示 LLM 对话历史，以及 output、metadata）。
• 数组索引（例如 [0]、[1]、[-1] 表示最后一项）。
• 数组的条目数（例如 (3) 表示共有 3 项）。
• 字符串和数字的预览值，以内联方式展示。

设置路径

1. 选择 Input 或 Output 标签页。然后选择以下任一方式：

   • 下拉菜单：直接从你的输入数据中指定应在预览里显示的路径。
   • 交互式树状视图：展示示例追踪的数据结构，你可以浏览并选中想要显示的确切字段。

   要选中某个字段：

   1. 点击 arrow="true" 图标（▶）展开或折叠嵌套的对象和数组，从而在树中浏览。
   2. 点击你想在预览中显示的字段旁边的复选框。所选路径会出现在树前面的文本输入框中。

   当你勾选复选框时，路径会以正确的语法自动构造出来（例如 messages[-1].content）。

方式	适用场景	示例
树选择	探索不熟悉的数据结构、查看示例值	依次点击：messages → [-1] → content
手动输入	已明确知道想要什么时，处理深层路径更快	输入：output.data.results[0].answer

包含超过 3 项的数组会自动折叠，以免视图信息过载：

☐ messages (15)
  ☐ [0]
  ☐ [1]
  ... (click to expand all 15 items)

点击 ... 按钮可展开并查看所有数组项。

示例

例如，你的追踪输入如下：

{
  "messages": [
    {"role": "system", "content": "You are a helpful assistant"},
    {"role": "user", "content": "What is the weather today?"}
  ],
  "metadata": {
    "user_id": "user123",
    "session_id": "sess456"
  }
}

在这个示例中，messages 是一个消息对象数组，每个对象都包含 role（例如 system 或 user）和 content 字段。

要显示用户的问题：

1. 展开 messages 节点（展开后显示数组项）。
2. 展开 [1]（第二条消息，即用户消息）。
3. 勾选 content 旁边的复选框。
4. 输入框中显示：messages[1].content。

或者，使用负索引来定位最后一条消息：

1. 展开 messages。
2. 展开 [-1]。
3. 点击 content。
4. 结果为：messages[-1].content（始终显示最后一条消息）。

NOTE

如果你在树中看到 "No paths available"：

• 确保过去 7 天内至少存在一条使用所选追踪名称的成功追踪。
• 该追踪在你正在配置的 input/output 字段中必须有数据。
• 如有需要，可尝试发送一条测试追踪。

后续步骤

• 进一步了解查看和筛选追踪。
• 探索自定义输出渲染，实现更高级的可视化。
• 设置元数据与标签来组织你的追踪。

---