LangSmith 部署 UI 中的 Studio 支持连接到两种类型的图:

已部署的图

Studio 在 LangSmith UI 中从 Deployments 导航访问。 对于已部署的应用程序,您可以作为该部署的一部分访问 Studio。为此,请在 UI 中导航到部署并选择 Studio 这将加载连接到实时部署的 Studio,允许您创建、读取和更新该部署中的线程助手内存

本地开发服务器

先决条件

要使用 Studio 在本地测试您的应用程序:
  • 首先遵循本地应用程序快速入门
  • 如果您不希望数据跟踪到 LangSmith,请在应用程序的 .env 文件中设置 LANGSMITH_TRACING=false。禁用跟踪后,不会有数据离开您的本地服务器。

设置

  1. 安装 LangGraph CLI
    pip install -U "langgraph-cli[inmem]"
    langgraph dev
    
    浏览器兼容性 Safari 阻止 localhost 连接到 Studio。要解决此问题,请使用 --tunnel 运行命令以通过安全隧道访问 Studio。
    这将在本地启动智能体服务器,在内存中运行。服务器将在监视模式下运行,侦听并在代码更改时自动重新启动。阅读此参考以了解启动 API 服务器的所有选项。 您将看到以下日志:
    > Ready!
    >
    > - API: [http://localhost:2024](http://localhost:2024/)
    >
    > - Docs: http://localhost:2024/docs
    >
    > - LangSmith Studio Web UI: https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024
    
    运行后,您将自动定向到 Studio。
  2. 对于正在运行的服务器,使用以下方法之一访问调试器:
    1. 直接导航到以下 URL:https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024
    2. 在 UI 中导航到 Deployments,单击部署上的 Studio 按钮,输入 http://127.0.0.1:2024 并单击 Connect
    如果在不同的主机或端口上运行服务器,请更新 baseUrl 以匹配。

(可选)附加调试器

对于使用断点和变量检查进行分步调试,请运行以下命令:
# Install debugpy package
pip install debugpy
# Start server with debugging enabled
langgraph dev --debug-port 5678
然后附加您首选的调试器:
  • VS Code
  • PyCharm
将此配置添加到 launch.json
{
    "name": "Attach to LangGraph",
    "type": "debugpy",
    "request": "attach",
    "connect": {
      "host": "0.0.0.0",
      "port": 5678
    }
}
有关入门问题,请参阅故障排除指南

后续步骤

有关如何运行 Studio 的更多信息,请参阅以下指南:
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.