AI应用链路追踪 - LangSmith

1. 什么是 LangSmith？

LangSmith 是一个专为大模型（LLM）应用设计的全链路工程化运维与评估平台，核心提供可观测性链路追踪（Tracing）、可视化黑盒调试（Debugging）以及自动化质量评估（Evaluation），帮助开发者将 AI 应用从原型高效推向生产环境。

核心能力

核心能力	作用与核心记录
全量追踪 (Observability)	自动记录底层细节： 捕获 Prompt、回复、耗时及 Token 消耗。
可视调试 (Debugging)	树状图破除“黑盒”： 清晰展现 Agent 步骤、工具调用与错误卡点。
性能评估 (Evaluation)	量化 AI 输出质量： 依靠数据集与评估器，精准检测正确率与幻觉率。

2. 如何集成到项目？

• 方案一：云服务 (SaaS 推荐)

  • 特点： 开箱即用，免运维。

  • 步骤： 注册账号 获取 LANGSMITH_API_KEY配置环境变量，日志自动上云。

    2.1 api_key:

    

    2.2 配置环境变量

    # ============================================================
    # 3. LangSmith / LangChain 可观测性
    # ============================================================
    LANGSMITH_PROJECT=new-agent
    LANGSMITH_API_KEY=lsv2_pt_11719c41d96c44f1ae3f9fd8029064e9_*******
    LANGSMITH_TRACING=true
    

    新建项目-与环境变量项目名需一致

    

• 方案二：自托管 (Self-Hosted)

  • 特点： 数据不出内网，高安全。
  • 步骤： 部署 Docker/Helm 镜像配置 LANGSMITH_ENDPOINT 指向私有服务。

  3 效果展示