LangChain 中文文档

主题

Studio 实验室

开始使用 Studio

Studio 在 LangSmith 部署界面 中支持连接到两种类型的图：

已部署的图 ​

Studio 可在 LangSmith 界面 中通过 Deployments 导航访问。

对于已部署的应用程序，您可以将 Studio 作为该部署的一部分进行访问。为此，请在界面中导航到相应的部署，然后选择 Studio。

这将加载连接到您实时部署的 Studio，允许您在该部署中创建、读取和更新线程、助手和记忆。

本地开发服务器 ​

先决条件 ​

要使用 Studio 在本地测试您的应用程序：

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

设置 ​

  1. 安装 LangGraph CLI：
bash
pip install -U "langgraph-cli[inmem]"
langgraph dev
bash
uv add "langgraph-cli[inmem]"
langgraph dev
bash
npx @langchain/langgraph-cli dev

浏览器兼容性 Safari 会阻止到 Studio 的 localhost 连接。要解决此问题，请使用 --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。

  1. 对于正在运行的服务器，可以通过以下任一方式访问调试器：
    1. 直接导航到以下 URL：https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024。
    2. 在界面中导航到 Deployments，点击某个部署上的 Studio 按钮，输入 http://127.0.0.1:2024 并点击 Connect。

如果您的服务器运行在不同的主机或端口上，请相应更新 baseUrl。

（可选）附加调试器 ​

要进行带有断点和变量检查的逐步调试，请运行以下命令：

bash
# 安装 debugpy 包
pip install debugpy
# 启用调试启动服务器
langgraph dev --debug-port 5678
bash
# 安装 debugpy 包
uv add debugpy
# 启用调试启动服务器
langgraph dev --debug-port 5678

然后附加您首选的调试器：

VS Code
PyCharm

将此配置添加到 launch.json：

json
{
    "name": "Attach to LangGraph",
    "type": "debugpy",
    "request": "attach",
    "connect": {
      "host": "0.0.0.0",
      "port": 5678
    }
}

如果在入门时遇到问题，请参考故障排除指南。

后续步骤 ​

有关如何运行 Studio 的更多信息，请参考以下指南：

LangChain 中文文档

Copyright © 王码码