LangChain Core 1.6.11 发布：追踪器支持地址配置

LangChain Core 1.6.11 发布说明

LangChain 核心库 langchain-core 发布了 1.6.11 版本，这是继 1.6.10 之后的一次小版本迭代。从 GitHub 官方 Release 页面可以看到，本次更新由 github-actions 机器人于 15 日自动发布，提交记录带有 GitHub 验证签名，属于例行维护型更新。

虽然版本号只跳动了最后一位，但这次改动触及了 LangChain 的追踪（Tracing）基础设施，对正在使用 LangSmith 做可观测性的开发者来说值得留意。

本次更新的两项核心改动

根据官方变更日志，1.6.11 自 1.6.10 以来包含两个提交：

1. 版本发布提交

release(core): 1.6.11 (#41260) 是常规的版本号提升与打包发布流程，对应 PR #41260。

2. 功能增强：LangChainTracer 支持传入地址

feat(core): accept address inside LangChainTracer (#41006) 是本次唯一的功能性改动，对应 PR #41006。它让 LangChainTracer 在初始化时可以接受一个 address 参数。

LangChainTracer 是什么

LangChainTracer 是 langchain-core 中负责把链、工具调用、LLM 请求等运行时事件上报到 LangSmith 的组件。开发者通常在调试复杂 Agent 流程或排查线上问题时启用它，用来查看每一步的输入输出、耗时和 token 消耗。

在此之前，追踪数据的上报目标地址往往依赖环境变量或全局配置。1.6.11 把 address 提升为构造参数，意味着可以在实例化 Tracer 时直接指定端点，代码层面的控制粒度更细。

LangSmith 是 LangChain 官方提供的可观测性与评估平台，用于记录、可视化并分析大模型应用的运行轨迹。当应用开启追踪后，每次链式调用、工具执行或 LLM 请求都会生成一条 trace，其中包含输入、输出、延迟、token 用量以及父子调用关系。这些 trace 默认被上报到 LangSmith 的托管端点。对于有数据合规要求或需要降低延迟的企业，LangSmith 也支持以自托管方式部署，此时上报目标就是一个自定义地址。

LangSmith SDK 通过一组环境变量来确定上报端点，最关键的包括 LANGCHAIN_ENDPOINT（或 LANGSMITH_ENDPOINT）用于指定服务地址，LANGCHAIN_API_KEY 用于鉴权，LANGCHAIN_TRACING_V2 用于开关追踪。因为这些都是进程级变量，一旦设置，整个进程内的所有追踪行为都会共享同一目标。这正是此前只能靠环境变量切换端点的原因。

这个改动解决了什么问题

在多环境或自托管场景下，开发者可能需要把不同链路的数据发送到不同的 LangSmith 端点——比如测试流量打到一个项目、生产流量打到另一个，或者对接企业自建的追踪服务。把 address 作为构造参数传入后，这类分流逻辑可以写在代码里，而不必反复切换环境变量。

对于需要在同一进程内并行管理多个追踪目标的场景，构造参数化的方式也比全局配置更安全，避免了环境变量被意外覆盖导致的数据串流。

LangChain 生态由多个独立发版的包组成，理解它们的分层有助于判断升级影响。langchain-core 是最底层的抽象层，定义 Runnable、消息类型、工具接口以及追踪等基础协议；langchain 在其上提供链与 Agent 的高层封装；langgraph 则专注于基于图的状态机式工作流。三者版本号各自独立，并不强制对齐，因此只升级 langchain-core 而不动上层包通常是可行的。

不过这种解耦也意味着：底层新增的 API 若不显式暴露，上层框架未必能直接使用。langchain-core 负责把 LangChainTracer 提供出来，但 langchain 的 traceable 装饰器或 langgraph 的运行时是否把 address 透传出来，取决于各自的维护节奏。所以这类底座改动的价值往往要等到上层跟进后才会完全释放。

升级建议

langchain-core 采用独立版本线，与 langchain、langgraph 等上层包的版本并不强制绑定。如果你正在使用 LangSmith 追踪功能，并且有以下诉求，建议升级到 1.6.11：

需要在代码中动态指定追踪上报地址
需要在同一进程内对接多个追踪端点
希望减少对环境变量的隐式依赖

如果当前追踪配置完全依赖默认环境变量且运行稳定，这次升级的紧迫性不高，可以在下次常规依赖更新时一并处理。

安装或升级命令：

pip install -U langchain-core==1.6.11

小结

1.6.11 是一次典型的“小步快跑”式更新：一个版本发布提交加一个追踪器增强。改动面窄，但命中了可观测性配置灵活性的真实痛点。langchain-core 作为整个 LangChain 生态的底座，这类细粒度 API 的开放往往会逐步被上层框架吸收，值得关注后续 langchain 与 langgraph 是否会跟进暴露对应的配置入口。