用途:为 LangChain 1.0 链与 LangGraph 1.0 智能体接入 LangSmith 追踪和自定义指标回调,解决追踪不生效、子图指标缺失等问题。
主要能力:使用 1.0 规范环境变量启用追踪(LANGSMITH_TRACING、LANGSMITH_API_KEY、LANGSMITH_PROJECT),可用 LANGSMITH_SAMPLING_RATE 采样;提供 BaseCallbackHandler 指标回调模板,记录 token_in、token_out、cache_read、latency_ms、tool_calls、error 并按 tenant_id 打标;通过 RunnableConfig 的 tags 与 metadata 标注追踪;给出 LangSmith、Prometheus、StatsD/Datadog、OTEL 的选型决策树;支持将生产运行样本送入标注队列与评测数据集。
使用方式:安装 langchain-core 1.0.x、langgraph 1.0.x 与 langsmith;设置环境变量后可用 langsmith.Client().list_projects(limit=1) 验证;回调须在调用时通过 config={"callbacks": [...]} 传入,而非用 with_config 绑定,否则子图与 create_react_agent 工具调用不会触发。
适用场景:多租户 SaaS 按租户统计成本、排查追踪缺失、用生产流量构建评测集。
限制:需 Python 3.10+ 与 LangSmith API Key;OTEL 重度场景应改用 langchain-otel-observability;高基数 tenant_id 标签可能导致 Prometheus 基数爆炸;重试可能重复计数需去重;LANGSMITH_PROJECT 在 Client 初始化时读取一次。具体收费与价格暂未提供。