从跟踪项目中，使用 **线程**, **跟踪**, or **运行** 标签页可更改表格中显示的内容。点击任意行可打开侧边面板。
侧边面板围绕 线程 作为主要导航单元。不是将每个 运行 作为孤立对象，UI 会保持周围对话可见，以便您了解某个运行在智能体更广泛执行中的位置。
侧边面板顶部提供三种视图：
- - **消息** (**测试版**）：对话层。扫描整个线程中的输入、输出、推理、工具调用和子智能体活动。使用此视图可找到需要查看的位置。按
M可切换到此视图。 - - **轮次**: The per-turn summary. View each turn in the thread as a card showing its inputs and outputs, with expand/collapse. Use this when you want a structural overview without the full conversation rendering. Press
T可切换到此视图。 - - **详情**：调试层。深入了解特定运行，检查输入、输出、计时、令牌数量、错误和元数据。使用此视图可了解执行过程中特定点发生的情况。按
D可切换到此视图。
使用消息视图在对话中定位并确定需要关注的重点，然后切换到详情视图检查特定运行：
Start in the Messages view
打开一个线程并切换到消息视图以查看完整线程。
Investigate
扫描线程以识别异常行为，例如糟糕的工具有结果、意外的子智能体交接或延迟峰值。
Inspect the run
点击相关的消息或工具调用可在生成它的确切运行处打开详情视图。检查其输入、输出、计时、错误和元数据。
Return to the thread
切换回消息视图以继续扫描对话。
消息视图
使用消息视图扫描完整线程并识别异常行为——糟糕的工具有结果、意外的子智能体交接或延迟峰值——然后再深入了解特定运行。
消息视图显示的内容
线程中的每个轮次都呈现为一个包含模型响应、触发的工具调用以及这些工具返回结果的单一块。您可以扫描整个线程并阅读智能体行为，而无需打开子运行。
每个块的元数据行显示：
- 令牌使用量： 调用的总令牌数
- Cost: 通话的总成本
- 模型名称
- - An **LLM 调用** 指向对应运行的链接，位于 详情视图 （仅当 AI 消息有可见文本时显示）
思考 当模型使用扩展思考时，这些区块会以内联形式出现在助手消息中，默认折叠。点击展开该回合的思维链。
子代理 以独立操作的形式以内联方式出现在对话中。点击进入子代理可打开其消息的嵌套视图。点击返回可回到父线程。
工具调用 随触发它们的助手消息一起出现。每个工具调用卡片都包含一个指向其在 详情视图中的运行的链接。当代理同时发出多个工具调用时（可以是同一工具的重复调用或多个不同工具的并行调用），这些调用会折叠成单个分组行。展开分组可查看每个单独的调用。
在消息和详情标签页之间切换时，LangSmith 会保留消息的折叠和展开状态。
要将对话下载为 Markdown 文件，请使用消息视图中的下载按钮。导出的文件包含完整对话记录，包括人与 AI 的交互、工具调用和工具结果，格式适合在任何 Markdown 查看器中阅读。
自定义消息视图
可以通过单个运行的元数据键来控制它们在消息视图中的显示方式。
- -
ls_agent_type：控制类似代理运行的消息出现位置。可接受的值：
| 值 | 消息视图行为 |
|---|---|
"root" | 此运行的消息会显示在主消息视图中。 |
"subagent" | 此运行的消息会作为子代理操作显示在对话线程中。 |
@traceable(metadata={"ls_agent_type": "root"})
def my_agent():
...
- -
ls_message_format: 覆盖自动格式检测。接受的值： - -
"langchain": 解析为 LangChain 消息格式 - -
"anthropic": 解析为 Anthropic 消息格式 - -
"responses": 解析为 OpenAI Responses API 格式 - -
LS_MESSAGE_VIEW_EXCLUDE: 从消息视图中排除单个运行。从以下位置导入常量langsmith（Python 和 JS），或使用字面字符串"ls_message_view_exclude"。有关代码示例，请参阅 从消息视图中排除运行. - - 对于
@traceable/traceable()：在标记运行的追踪上下文内执行的子运行会继承排除设置。 - - 对于
wrap_openai/wrapOpenAI,wrapAISDK,RunTree.createChild和 LangChainRunnableConfig：在每个要隐藏的运行上设置密钥。在这些界面上，对子运行的继承不能保证。
轮次视图
使用轮次视图可以逐轮扫描线程结构，无需消息视图的完整对话呈现。线程中的每轮都显示为一张卡片，展示根运行的输入和输出。点击卡片的 V 形图标可展开或折叠其内容。
轮次视图在以下情况下很有用：
- - 线程没有可渲染的消息（例如，来自不受消息视图支持的集成的追踪）。
- - 你想在决定深入查看哪一轮之前快速了解线程的结构。
- - 您希望查看每个回合的原始输入和输出，而不是规范化为聊天风格的对话。
点击任意回合以打开 详情视图 该运行产生的。
自定义回合视图
默认情况下，LangSmith 使用启发式方法选择要在每个回合卡片上显示的输入和输出字段。若要覆盖显示的字段，请点击 **格式** 按钮以打开格式窗格，选择要显示的特定输入和输出路径，然后保存。您的选择将对该项目保持不变。
详情视图
详情视图是调试层。当您点击进入特定运行时，周围的线程上下文保持可用，以便您了解该运行在更广泛对话中的位置。在不丢失线程追踪的情况下检查输入、输出、元数据、时间、错误和子运行。
自定义详情视图
设置 run_type="llm" 在运行上会导致详情视图渲染该运行的令牌计数和延迟。完整的消息格式规范，请参阅 记录 LLM 追踪.
当运行的 run_type is tool.
设置 run_type="retriever" 在运行上会导致详情视图内联渲染每个检索到的文档及其内容和高元数据。所需的返回格式，请参阅 记录检索器追踪.
操作
从详情视图中，您还可以：