LangChain 于 2026-09-25 发布 LangSmith Python SDK 0.14.1(含 0.14.0 能力):run 与 feedback 可按 agent 而非仅按 project 寻址;沙箱创建时可授予委托 LangSmith 访问并支持登录服务 URL(JS 同步);ClaudeSDKClient.receive_messages() 纳入追踪,补 stop_reason / tool 与 response ID;OTel 导出补齐 tool_call_id、tool_definitions、finish_reasons。JS 侧同步至 0.10.5。

核心要点速览 (Key Takeaways)

  • ✓发版:Python v0.14.1(2026-09-25)/ JS 0.10.5;pip install -U langsmith
  • ✓寻址:run 与 feedback 可按 agent 定位(#3520、#3533),不再只绑 project
  • ✓沙箱:创建时授予委托 LangSmith 访问 + login/service URL(#3563、#3564、#3593)
  • ✓Claude:追踪 ClaudeSDKClient.receive_messages(),含 stop_reason 与 tool/response ID(#3558、#3576)
  • ✓OTel:导出补 tool_call_id / tool_definitions / finish_reasons(#3584、#3570);list_runs/list_threads 可选 s3_urls 附件
🔬

深度技术解析与实战评估

核心背景与行业痛点

多 Agent 产线里,一条 run 往往跨子代理、工具与沙箱。旧 LangSmith 客户端习惯按 project 寻址,难直接落到某个 agent;Claude SDK 流式消息与 OTel 字段(如 tool_call_id、finish_reasons)不全,排障要靠日志拼接。沙箱进程若不能安全委托登录 LangSmith,云端观测链路也会断,本地复现与线上对账更困难。

架构亮点与底层机制

langsmith-sdk Python 0.14.0→0.14.1(JS 0.10.5)把 run / feedback 寻址扩展到 agent 维度(#3520、#3533)。沙箱创建可授予委托 LangSmith 访问,并配置 login/service URL(Py/JS),0.14.1 再校验 service URL 用户令牌与代理回调(#3593)。追踪覆盖 ClaudeSDKClient.receive_messages(),带上 stop_reason 与 tool/response ID;OTel 导出补齐 tool_call_id、tool_definitions、finish_reasons。list_runs/list_threads 可选 s3_urls 以返回附件。

权威 Benchmark 与实测跑分对比

发行说明未给出吞吐或开销百分比,属于可观测性功能版。建议在自有 Claude SDK / 多 agent 流水线上对比:agent 维过滤是否命中、沙箱委托登录是否成功、OTel 后端是否出现新字段。不要臆造延迟数字。

开发者实战落地与开箱指南

pip install -U langsmith(或钉 langsmith==0.14.1)。查阅 LangSmith 文档 配置 API Key 与 tracing。使用 Claude Agent SDK 时确认 receive_messages 路径已出 span;沙箱场景按发行说明打开委托访问与 service URL,并在列表接口按需打开 s3_urls。完整变更见 v0.14.1 与 v0.14.0。