Studio 快速入门

• 部署在云端或自托管的图。
• 使用 Agent Server 在本地运行的图。

​

部署的图

​

本地开发服务器

​

前提条件

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

​

设置

1. 安装 LangGraph CLI：
   pip

   uv

   npm

   pip install -U "langgraph-cli[inmem]"
   langgraph dev
   
   浏览器兼容性 Safari 会阻止 localhost 到 Studio 的连接。要解决此问题，请使用 --tunnel 参数运行命令以通过安全隧道访问 Studio。您需要通过单击 Studio UI 中的连接到本地服务器来手动将隧道 URL 添加到允许的源中。具体步骤请参阅故障排除指南。
   这将在本地启动 Agent Server，并使用内存模式运行。服务器将以监视模式运行，监听代码更改并自动重启。请阅读此参考文档以了解启动 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. 在界面中导航到部署，单击某个部署上的 Studio 按钮，输入 http://127.0.0.1:2024 然后单击连接。
   如果您的服务器运行在不同的主机或端口上，请相应地更新 baseUrl。

​

（可选）附加调试器

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

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

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

​

后续步骤

• 运行应用程序
• 管理助手
• 管理线程
• 迭代提示词
• 调试 LangSmith 追踪
• 将节点添加到数据集