> ## 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.

# 如何使用 Studio

本页描述了您将在 Studio 中使用的核心工作流程。它解释了如何运行您的应用程序、管理助手配置以及处理对话线程。每个部分都包含图模式（全面查看图执行情况）和聊天模式（轻量级对话界面）中的操作步骤：

* [运行应用程序](#run-application)：执行您的应用程序或智能体并观察其行为。
* [管理助手](#manage-assistants)：创建、编辑和选择您的应用程序所使用的助手配置。
* [管理对话线程](#manage-threads)：查看和组织对话线程，包括分叉或编辑过去的运行以进行调试。

## 运行应用程序

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

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

    ### 运行设置

    #### 助手

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

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

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

    #### 流式传输

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

    #### 断点

    要使用断点运行您的图：

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

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

    ### 提交运行

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

    1. 点击 **提交** 按钮。这将向当前选定的[对话线程](/oss/python/langgraph/persistence#threads)添加一个[运行](/langsmith/runs)。如果当前未选择对话线程，则会创建一个新的。
    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. 要创建新的对话线程，请点击 **+ 新对话线程** 并[提交运行](#run-application)。
    4. 要在对话线程中查看更详细的信息，请将页面顶部的滑块向右拖动。要查看较少的信息，请将滑块向左拖动。此外，可以折叠或展开各个轮次、节点和状态键。
    5. 在 `美化` 和 `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="terminal-2">
    [连接这些文档](/use-these-docs) 到 Claude、VSCode 等，通过 MCP 获取实时答案。
  </Callout>

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