langchain-ai于上海时间2026年10月23日01时57分通过GitHub Release发布JS包@langchain/xai正式版1.5.0,对应接口published_at为2026-10-22T17:57:46Z,prerelease为false且draft为false,标签与名称均为@langchain/xai@1.5.0。仓库归属为langchain-ai组织下的公开仓库langchainjs,项目定位为LangChain.js生态中对接xAI模型的客户端封装,中国开发者可通过公开仓库查看发布页并经npm包@langchain/xai升级验证。本次发布说明未提及许可证变更与安全修复,仓库LICENSE页面显示为MIT条件,按许可不变处理。本次为同批次@langchain/openai 1.7.0联动的xAI适配版本,聚焦Responses工具调用流式传输一致性,对通用对话主流程无直接功能变更。本次均以当日发布页与发布接口核验,不补发往日版本动态。
核心变化:Responses工具调用改增量切片
本次实质变化为feat(xai): stream Responses tool-call args as tool-call-delta slices,对应编号11986与提交2caf64d。在Responses模式下,工具调用参数流式事件由原来的块快照改为增量切片,通过@langchain/openai转换器实现。过去每个block-delta事件都会携带截至目前的参数全量快照,大工具调用会反复传输重复字节;现在改为tool-call-delta事件,只携带新增的参数分片,大调用在网络上的传输量降至与同长度文本相当。配套将@langchain/core对等依赖提升至^1.3.0,若将core锁定在1.3.0以下则继续保持快照行为。依赖同步更新至@langchain/openai@1.7.0,保持与主通道一致。
适用对象与兼容性
该版本面向使用LangChain.js对接xAI模型构建智能体、工具调用与流式输出的中国前端与全栈开发者,尤其是有长参数、大工具调用与Responses模式的项目。常规的await stream、toolCalls取值与组装后消息行为不变,一般业务无需改业务逻辑。但直接读取原始事件中block-delta的fields.args,或自写智能体流转换器的项目属于破坏性影响范围,必须改读tool-call-delta。客户端兼容有硬要求:旧客户端无法正确处理新事件,需先升级客户端再升级该包,配套要求为@langchain/langgraph-sdk 1.12.6及以上、react、vue、svelte或angular相关包1.2.6及以上。仓库公开,许可证仍为MIT,正式发布非预发布,可通过npm正常安装。
- 先将客户端矩阵升级至上述最低版本并在测试环境验证流式解析;再将@langchain/xai升级至1.5.0并同步@langchain/openai至1.7.0与core至1.3.0以上;如直接处理原始事件,将block-delta快照读取改为tool-call-delta增量拼接;全量回归Responses工具调用与多模型路由;需暂缓时将@langchain/core锁定在1.3.0以下以保持快照行为。
迁移与访问条件
升级通过npm进行,国内用户可使用本地镜像源加速,但版本与完整性仍以GitHub官方Release与npm官方元数据为准。建议先在隔离或预发布环境验证,再进入生产,尤其要覆盖大参数工具调用与自定义流转换器。如需暂缓,官方给出的保持方法是固定@langchain/core在1.3.0以下,这会同时保持xAI及相关包停留在发送快照的旧行为,适合发布窗口紧张的团队作为短期策略,但不应作为长期停留方案。
限制与必要下一步
本次未涉及许可证变化、安全修复与维护状态变化,MIT条件不变,也未声明性能以外的准确性提升,不应将其理解为模型能力增强。跨通道行为差异需注意,同批次主包说明Google与Ollama通道仍为完整快照,依赖统一解析的项目需保留分支处理。官方未提供中国区单独说明,网络与镜像差异需自行验证。下一步是检查自有代码是否读取block-delta,升级客户端矩阵后在测试环境对比升级前后工具调用组装结果,确认无截断、无重复后再全量发布;正式版用户按上述顺序常规升级验证即可。