Skip to main content

LangSmithStudio

LangSmith Studio 效果是什么样，能监控到什么额外信息？

即使没有LangSmith Studio 也能自己实现一模一样的观测吗 答案是：可以，但没有必要从零开始，因为已经有现成的开源替代方案。

LangSmith Studio 的核心能力本质上是可视化的链路追踪（Tracing），而这项能力并非 LangChain 独有的黑科技。你完全可以用开源工具自己搭建一套，实现近乎一样的观测效果。

心智模型​

LangSmith Studio 是一个本地 Agent 的可视化开发与调试界面。它通过 langgraph dev 启动本地服务器，与你的 Agent 代码连接，实时展示每一步执行细节（提示词、工具调用、输出），并支持热重载、从任意步骤重放、检查中间状态，无需额外代码或部署即可快速迭代。

二级标题及内容​

  • 【前提条件】Prerequisites 需要 LangSmith 账号（免费注册）和 API Key。若不想将数据追踪到 LangSmith，可在 .env 中设置 LANGSMITH_TRACING=false。

  • 【步骤1】安装 CLI 安装 langgraph-cli[inmem]，它提供连接 Agent 到 Studio 的本地开发服务器。

  • 【步骤2】准备 Agent 使用 create_agent 创建的任意 Agent 均可直接使用，无需特殊修改。

  • 【步骤3】环境变量 在项目根目录创建 .env 文件，写入 LANGSMITH_API_KEY。注意：不要将该文件提交到版本控制。

  • 【步骤4】创建配置文件 创建 langgraph.json，声明依赖（dependencies）、图入口（graphs）和环境文件（env）。create_agent 返回的已是编译好的 LangGraph 图，可直接作为 graphs 的值。

  • 【步骤5】安装依赖 安装项目所需的 langchain 及相关模型包。

  • 【步骤6】在 Studio 中查看 运行 langgraph dev，通过 https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024 访问。注意：Safari 会阻止 localhost 连接，需加 --tunnel 参数。

最佳实践​

  • 启动前确保环境变量就绪：API Key 必须正确配置在 .env 中，否则无法连接。
  • 利用热重载快速迭代：修改代码后 Studio 自动更新，无需手动重启。
  • 从任意步骤重放：调试时不必从头开始，可在执行轨迹中任一步骤重新运行，快速验证修改效果。
  • Safari 用户加 --tunnel：避免 localhost 被浏览器阻止，改用安全隧道访问。

成本主要来自“追踪”数据量：

免费额度：LangSmith 的开发者 (Developer) 计划是免费的，包含每月 5000 次追踪，适合个人和轻量级使用。

超额付费：如果你每月产生的追踪数量超过免费额度，就需要付费。你可以随时在“套餐和账单”页面添加信用卡，升级到额度更高的付费计划