以编程方式使用文档

默认情况下，LangSmith使用启发式方法来确定显示在 **输入** 和 **输出** 列中的内容 **运行** 表。不过，你可以通过为特定追踪类型配置自定义预览路径，精确自定义这些列的显示内容。

这在以下情况下特别有用：

  • - 你的追踪具有深层嵌套结构。
  • - 你想专注于数据中的特定字段。
  • - 默认启发式方法没有显示对你的用例最相关的信息。

在UI中配置预览格式

访问预览设置

  1. 导航到项目中的追踪。
  2. 选择 **运行** tab.
  3. 找到格式图标 在运行表右上方。
  4. 在 **配置输入和输出预览** 侧窗口中，从下拉菜单中选择追踪名称。

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

  • - 字段名称（例如， messages 用于LLM对话历史， output, metadata).
  • - 数组索引（例如，[0]、[1]、[-1]表示最后一项）。
  • - 数组的项目计数（例如，(3)表示3个项目）。
  • - 以内联方式显示的字符串和数字预览值。
显示追踪数据结构树形视图的配置输入和输出预览侧面板 显示追踪数据结构树形视图的配置输入和输出预览侧面板

设置路径

1. 选择 **输入** or **输出** 标签页。然后，任选以下方式： - 下拉菜单可直接指定预览中应显示的输入数据路径。 - 示例追踪数据结构的交互式树形视图，你可浏览并选择要显示的确切字段。

选择字段：

  1. 通过点击箭头图标（▶）展开或折叠嵌套对象和数组来浏览树。
  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 or user）和 content field.

要显示用户的问题：

  1. 展开 **messages** 节点（显示数组元素）。
  2. 展开 [1] （第二条消息，即用户消息）。
  3. 点击 **content**.
  4. 旁边的复选框。 messages[1].content.

或者，使用负索引获取最后一条消息：

  1. 展开 **messages**.
  2. 展开 [-1].
  3. 点击 **content**.
  4. Result: messages[-1].content （始终显示最后一条消息）。

后续步骤