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__)))
# ... 下面保持原样 ...

---