> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 配置运行输入和输出预览

> 通过为特定追踪类型配置自定义预览路径，自定义运行表中输入和输出列显示的内容。

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

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

* 您的追踪具有深度嵌套的结构。
* 您希望专注于数据中的特定字段。
* 默认的启发式方法没有显示对您的用例最相关的信息。

## 在 UI 中配置预览格式

### 访问预览设置

1. 导航到您项目中的一个追踪。
2. 选择 **运行** 选项卡。
3. 在运行表顶部找到 <Icon icon="adjustments-horizontal" /> **格式**。
4. 在 **配置输入和输出预览** 侧边窗口中，从下拉菜单中选择一个追踪名称。

<img className="block dark:hidden" src="https://mintcdn.com/other-405835d4/77NFW0Y3VGYDwREY/langsmith/images/tracing-table.png?fit=max&auto=format&n=77NFW0Y3VGYDwREY&q=85&s=9ebcc9c44ae17faac19a1ea25cb7592d" alt="运行表显示顶部的格式按钮，用于配置输入和输出预览" width="1380" height="337" data-path="langsmith/images/tracing-table.png" />

<img className="hidden dark:block" src="https://mintcdn.com/other-405835d4/77NFW0Y3VGYDwREY/langsmith/images/tracing-table-dark.png?fit=max&auto=format&n=77NFW0Y3VGYDwREY&q=85&s=64e663d10e79025c7f4d8ee255cf7a9c" alt="运行表显示顶部的格式按钮，用于配置输入和输出预览" width="1399" height="342" data-path="langsmith/images/tracing-table-dark.png" />

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

* 字段名称（例如，LLM 对话历史的 `messages`、`output`、`metadata`）。
* 数组索引（例如，\[0]、\[1]、\[-1] 表示最后一项）。
* 数组的项目计数（例如，(3) 表示 3 个项目）。
* 字符串和数字的预览值内联显示。

<img className="block dark:hidden" src="https://mintcdn.com/other-405835d4/jwwDDYly65_K9YMB/langsmith/images/configure-preview.png?fit=max&auto=format&n=jwwDDYly65_K9YMB&q=85&s=87c35c44c727b56d4908d37e5d312d35" alt="配置输入和输出预览侧面板，显示追踪数据结构的树视图" width="586" height="651" data-path="langsmith/images/configure-preview.png" />

<img className="hidden dark:block" src="https://mintcdn.com/other-405835d4/jwwDDYly65_K9YMB/langsmith/images/configure-preview-dark.png?fit=max&auto=format&n=jwwDDYly65_K9YMB&q=85&s=8a97273c0ce0840ed37f394089c7c291" alt="配置输入和输出预览侧面板，显示追踪数据结构的树视图" width="583" height="582" data-path="langsmith/images/configure-preview-dark.png" />

### 设置路径

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"
  }
}
```

在此示例中，`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 天内至少有一个使用所选追踪名称的成功追踪。
  * 追踪必须在您正在配置的输入/输出字段中包含数据。
  * 如果需要，请尝试发送一个测试追踪。
</Note>

## 后续步骤

* 了解有关[查看和过滤追踪](/langsmith/filter-traces-in-application)的更多信息。
* 探索[自定义输出渲染](/langsmith/custom-output-rendering)以进行高级可视化。
* 设置[元数据和标签](/langsmith/add-metadata-tags)以组织您的追踪。

***

<div className="source-links">
  <Callout icon="terminal-2">
    [连接这些文档](/use-these-docs)到 Claude、VSCode 等，通过 MCP 获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/langsmith/configure-input-output-preview.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>
