LangSmith监控与可视化

在真实的工业级 AI 开发中,当我们把代码部署到服务器上后,如果不加监控,系统就像是在"蒙眼狂奔"。如果今天的老板问你:"我们这个月调 API 花了多少钱?每次生成代码平均耗时多久?昨天那个测试失败的 Bug,到底是因为 Planner 拆解错了,还是因为 RAG 搜到了垃圾信息?"

如果没有监控,你根本答不上来。传统软件工程里的 print() 和 logging 只能记录"发生了什么",而无法记录"AI 为什么这么想"。

这就是我们今天要引入 LangSmith 的原因。它能像医院的 X 光机一样,把你的大模型每一次思考、每一次工具调用、每一次 Prompt 组装,都扒得清清楚楚!

接下来,我们分三步,极其优雅地(不需要修改核心业务逻辑代码)把这套监控系统装上去。

🛠️ 步骤 1:获取"监控室"的钥匙 (API Key)

  1. 打开浏览器,访问 LangSmith 的官方网站:https://smith.langchain.com/
  2. 使用你的 GitHub 或 Google 账号免费注册/登录。
  3. 登录进去后,点击左下角的 ⚙️ Settings (设置) ,然后找到 API Keys。
  4. 点击 Create API Key ,给它起个名字(比如 skills-creator-key),然后把生成的那串以 **lsv2_**开头的长字符串复制下来,妥善保存。

🛠️ 步骤 2:在项目中配置环境变量

LangChain 的底层写死了一套极其聪明的探针逻辑。只要它在操作系统的环境变量里发现了 LangSmith 的配置,它就会自动把所有的数据打包发往云端监控室。

  1. 打开你的 PyCharm 终端,安装一个用于读取环境变量的轻量级库

    pip install python-dotenv

  2. 在你的项目根目录 下(就是和 app.py 挨着的地方),新建一个文本文件,名字就叫 .env(注意前面有个点,没有后缀名)。

  3. 把下面这段配置贴进 .env 文件里,并替换上你刚才获取的 Key:

代码段

复制代码
# 开启 LangSmith 追踪
LANGCHAIN_TRACING_V2=true
# 填入你刚刚复制的 API Key
LANGCHAIN_API_KEY=lsv2_pt_xxxxxxxxxxxxxxxxxxxxxx
# 给你的监控项目起个名字(会在 LangSmith 后台显示)
LANGCHAIN_PROJECT=my_progect

🛠️ 步骤 3:在代码入口激活探针

最后一步,我们需要让 Python 脚本在启动时,把 .env 文件里的配置读进系统变量里。

打开你的前端入口文件 app.py,在最顶部的导包区域,加上这两行代码:

复制代码
import sys
import os
import uuid
import streamlit as st
import sqlite3
from dotenv import load_dotenv  # ✨ 新增:导入 dotenv

# ✨ 新增:在系统启动的最开始,加载 .env 文件中的监控配置
load_dotenv() 

sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
# ... 下面保持原样 ...

相关推荐
桃西西呀28 分钟前
LangChain 之七:回调与可观测
人工智能·langchain·llm
桃西西呀30 分钟前
LangChain 之六:记忆与历史
人工智能·langchain·llm
打工仔折腾 AI3 小时前
把AI Agent托管在家用电脑:UU远程终端与端口映射实测记录
人工智能·后端·python·langchain·ai agent 实战
打工仔折腾 AI5 小时前
LLaMA 1 到 LLaMA 3 架构演进拆解:从 RoPE、GQA 到词表扩张
人工智能·后端·python·深度学习·langchain·llama
打工仔折腾 AI8 小时前
把 AI Agent 托管到家里电脑:UU远程端口映射与CLI实测记录
人工智能·后端·python·langchain·电脑·ai agent 实战
染指111010 小时前
135.Agent-多Agent框架-LangChain多智能体(SubAgents子代理)
数据库·人工智能·设计模式·langchain·agent·agents
用户31346721435410 小时前
Agent相关 - agent_scratchpad 到底该放哪?一个隐蔽的顺序坑
langchain·llm·agent
逆风飞翔的小叔11 小时前
【AI大模型】Langchain 多类型对话消息使用实战操作详解
langchain·langchain 消息类型·langchain 消息使用·langchain 消息详解·langchain 消息·langchain 消息总结
染指11101 天前
134.Agent-多Agent框架-LangChain多智能体
人工智能·中间件·langchain·agents
打工仔折腾 AI1 天前
从 Demo 到生产级 Agent:8 个关键设计机制与 Python 实现拆解
java·jvm·人工智能·后端·python·langchain·ai agent 实战