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

# 如何使用 Studio

本页面介绍在 Studio 中使用的核心工作流程。它解释了如何运行应用程序、管理助手配置以及处理对话线程。每个部分都包含图形模式（图形执行的完整功能视图）和聊天模式（轻量级对话界面）下的操作步骤：

* [运行应用程序](#运行应用程序)：执行您的应用程序或智能体并观察其行为。
* [管理助手](#管理助手)：创建、编辑和选择应用程序使用的助手配置。
* [管理线程](#管理线程)：查看和组织线程，包括为调试而分支或编辑过去的运行记录。

## 运行应用程序

<Tabs>
  <Tab title="图形模式">
    ### 指定输入

    1. 在页面左侧图形界面下方的 **输入** 部分定义图形的输入。Studio 将尝试根据图形定义的[状态模式](/oss/python/langgraph/graph-api/#schema)渲染输入表单。要禁用此功能，请点击 **查看原始数据** 按钮，这将显示 JSON 编辑器。
    2. 点击 **输入** 部分顶部的向上或向下箭头，可以切换并使用之前提交的输入。

    ### 运行设置

    #### 助手

    要指定运行使用的[助手](/langsmith/assistants)：

    1. 点击左下角的 **设置** 按钮。如果当前已选择助手，按钮上还会显示助手名称。如果未选择助手，则会显示 **管理助手**。
    2. 选择要运行的助手。
    3. 点击模态框顶部的 **激活** 切换开关以激活它。

    更多信息，请参阅[管理助手](#管理助手)。

    #### 流式传输

    点击 **提交** 旁边的下拉菜单，然后点击切换开关以启用或禁用流式传输。

    #### 断点

    要使用断点运行图形：

    1. 点击 **中断**。
    2. 选择一个节点，并选择在该节点执行之前还是之后暂停。
    3. 在线程日志中点击 **继续** 以恢复执行。

    有关断点的更多信息，请参阅[人在回路](/oss/python/langchain/human-in-the-loop)。

    ### 提交运行

    要使用指定的输入和运行设置提交运行：

    1. 点击 **提交** 按钮。这将在当前选定的[线程](/oss/python/langgraph/persistence#threads)中添加一个[运行](/langsmith/assistants#execution)。如果当前未选择任何线程，则会创建一个新线程。
    2. 要取消正在进行的运行，请点击 **取消** 按钮。
  </Tab>

  <Tab title="聊天模式">
    在对话面板底部指定聊天应用程序的输入。

    1. 点击 **发送消息** 按钮，将输入作为人类消息提交，并接收流式返回的响应。

    要取消正在进行的运行：

    1. 点击 **取消**。
    2. 点击 **显示工具调用** 切换开关以隐藏或显示对话中的工具调用。
  </Tab>
</Tabs>

## 管理助手

Studio 允许您查看、编辑和更新助手，并允许您使用这些助手配置运行图形。

更多概念性细节，请参阅[助手概述](/langsmith/assistants/)。

<Tabs>
  <Tab title="图形模式">
    要查看您的助手：

    1. 点击左下角的 **管理助手**。这将打开一个模态框，供您查看所选图形的所有助手。
    2. 指定您希望标记为 **激活** 的助手及其版本。LangSmith 将在提交运行时使用此助手。

    **默认配置** 选项将处于激活状态，它反映了您在图形中定义的默认配置。对此配置所做的编辑将用于更新运行时配置，但除非您点击 **创建新助手**，否则不会更新或创建新的助手。
  </Tab>

  <Tab title="聊天模式">
    聊天模式允许您通过页面顶部的下拉选择器在图形的不同助手之间切换。要创建、编辑或删除助手，请使用图形模式。
  </Tab>
</Tabs>

## 管理线程

Studio 提供工具来查看服务器上保存的所有[线程](/oss/python/langgraph/persistence#threads)并编辑其状态。您可以在图形模式和聊天模式下创建新线程、在线程之间切换以及修改过去的状态。

<Tabs>
  <Tab title="图形模式">
    ### 查看线程

    1. 在右侧窗格顶部，选择下拉菜单以查看现有线程。
    2. 选择所需的线程，线程历史记录将填充在页面右侧。
    3. 要创建新线程，请点击 **+ 新建线程** 并[提交运行](#运行应用程序)。
    4. 要在线程中查看更详细的信息，请将页面顶部的滑块向右拖动。要查看较少信息，请将滑块向左拖动。此外，可以折叠或展开状态的各个轮次、节点和键。
    5. 在 `Pretty` 和 `JSON` 模式之间切换以使用不同的渲染格式。

    ### 编辑线程历史记录

    要编辑线程的状态：

    1. 在所需节点旁边选择 <Icon icon="pencil" /> **编辑节点状态**。
    2. 根据需要编辑节点的输出，然后点击 **分支** 以确认。这将从所选节点的检查点创建一个新的分支运行。

    如果您希望在不编辑状态的情况下从给定检查点重新运行线程，请点击 **从此处重新运行**。这同样会从所选检查点创建一个新的分支运行。这对于重新运行与状态无关的更改（例如选定的助手）非常有用。
  </Tab>

  <Tab title="聊天模式">
    1. 在页面右侧窗格中查看所有线程。
    2. 选择所需的线程，线程历史记录将填充在中心面板中。
    3. 要创建新线程，请点击 **+** 并提交运行。

    要编辑线程中的人类消息：

    1. 在人类消息下方点击 <Icon icon="pencil" /> **编辑节点状态**。
    2. 根据需要编辑消息并提交。这将创建对话历史记录的一个新分支。
    3. 要重新生成 AI 消息，请点击 AI 消息下方的重试图标。
  </Tab>
</Tabs>

## 后续步骤

有关在 Studio 中可以完成的更多任务的详细信息，请参阅以下指南：

* [迭代提示词](/langsmith/observability-studio)
* [在数据集上运行实验](/langsmith/observability-studio#run-experiments-over-a-dataset)

***

<div className="source-links">
  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/i18n\zh-CN\langsmith\use-studio.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>

  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
  </Callout>
</div>
