主题
如何使用 Studio
本页介绍你在 Studio 中会使用的核心工作流,说明如何运行应用、管理 assistant 配置以及处理对话 thread。每一节都包含 graph 模式(graph 执行的全功能视图)和 chat 模式(轻量级对话界面)下的步骤:
- 运行应用:执行你的应用或 agent,并观察其行为。
- 管理 assistant:创建、编辑并选择应用使用的 assistant 配置。
- 管理 thread:查看和组织 thread,包括为调试而 fork 或编辑过去的 run。
运行应用
指定输入
- 在页面左侧 graph 界面下方的 Input 区域中定义 graph 的输入。Studio 会尝试根据 graph 定义的状态 schema 为你的输入渲染表单。要禁用此功能,请点击 View Raw 按钮,它会显示一个 JSON 编辑器。
- 点击 Input 区域顶部的上下箭头,可以切换并使用之前提交过的输入。
运行设置
Assistant
要指定用于该运行的 assistant:
- 点击左下角的 Settings 按钮。如果当前已选择 assistant,按钮上还会显示 assistant 名称。如果未选择 assistant,则显示 Manage Assistants。
- 选择要运行的 assistant。
- 点击模态框顶部的 Active 开关以启用它。
更多信息请参阅管理 assistant。
流式传输
点击 Submit 旁边的下拉菜单,然后点击开关以启用或禁用流式传输。
断点
要使用断点运行 graph:
- 点击 Interrupt。
- 选择一个节点,并选择在该节点执行之前还是之后暂停。
- 在 thread 日志中点击 Continue 以恢复执行。
有关断点的更多信息,请参阅Human-in-the-loop。
提交运行
要使用指定的输入和运行设置提交运行:
管理 assistant
Studio 允许你查看和编辑 assistant,并允许你使用这些 assistant 配置运行 graph。
有关更多概念性细节,请参阅 Assistants 概览。
要查看 assistant:
- 点击左下角的 Manage Assistants。这会打开一个模态框,供你查看所选 graph 的所有 assistant。
- 指定要标记为 Active 的 assistant 及其版本。提交运行时,LangSmith 将使用该 assistant。
Default configuration 选项会处于启用状态,它反映 graph 中定义的默认配置。对此配置所做的编辑将用于更新运行时配置,但除非你点击 Create new assistant,否则不会更新或创建新的 assistant。
管理 thread
Studio 提供工具来查看服务器上保存的所有 thread 并编辑其状态。你可以在 graph 模式和 chat 模式下创建新 thread、切换 thread 以及修改过去的状态。
查看 thread
- 在右侧窗格顶部,选择下拉菜单以查看现有 thread。
- 选择所需的 thread,页面右侧将显示 thread 历史记录。
- 要创建新 thread,请点击 + New Thread 并提交一次运行。
- 要查看 thread 中更细粒度的信息,请将页面顶部的滑块向右拖动。要查看更少信息,请将滑块向左拖动。此外,你还可以折叠或展开各个轮次、节点和状态键。
- 在
Pretty和JSON模式之间切换,以获得不同的渲染格式。
编辑 thread 历史
要编辑 thread 的状态:
- 选择
所需节点旁边的 Edit node state。 2. 根据需要编辑节点输出,然后点击 Fork 确认。这将基于所选节点的 checkpoint 创建一个新的 fork 运行。
如果你希望在不编辑状态的情况下从给定 checkpoint 重新运行 thread,请点击 Re-run from here。这同样会基于所选 checkpoint 创建一个新的 fork 运行。这对于执行与状态无关的更改(例如所选 assistant)后重新运行很有用。
后续步骤
有关在 Studio 中可完成的任务的更多详细信息,请参阅以下指南: