n8n 2.48.5 是个纯修 bug 的小版本,11 条修复里 AI Agent Node 那条最关键。它修的是多输入 item 并发时 tool-call 历史串台的问题。我先给判断:只要你的 AI Agent Node 接了多输入、又在并发里调工具,这个版本就该升,别的场景可以跳过。
根源:合并批结果只留第一个 item
先说这个 bug 的根源。AI Agent Node 处理一批输入 item 时,每个 item 会各自跑一段工具调用,产生自己的 tool-call 历史。旧逻辑在合并批结果的时候,只保留了第一个 item 的 metadata,其余 item 的 previousRequests 被静默丢了。你批进去 5 条,4 条的对话历史就没了。这是硬伤。
我把它说得再具体点。假设批里两条,item 0 调了查库存的工具,item 1 调了发通知的工具。一轮跑完,这两段 tool-call 历史该各自归位。旧代码合并时只把 item 0 的历史拼进 request,item 1 的整个 previousRequests 被丢掉,于是下一步 Agent 重建对话历史,item 1 那边就记不起自己刚才调过工具。别拖。
这不是我猜的,是提交记录里明写的。对应 PR 是 #44044,标题 Keep tool-call history separate for each input item,一共动了 12 个文件,核心是新增一个 mergeRequestMetadata.ts,53 行。我把这个 commit 的 diff 打开核了一遍。
这个 bug 有多隐蔽,我得说清楚。它不是报错、不是崩溃,是结果悄悄错了。你排障时看到的是"第二个 item 的 Agent 忘了自己前面调过什么",根本想不到是合并逻辑丢了数据。这种静默丢字段的 bug 最坑。
修法:按 itemIndex 合并,legacy 去重
它怎么修的,关键就两点。第一,按 itemIndex 合并。每个 tool-call 步骤都打上 itemIndex 标记,合并时把各 item 的 previousRequests 拼起来,而不是只取第一个。第二,对无 itemIndex 的 legacy 步骤去重。旧执行恢复出来的步骤可能没打标,会被反复拼接,用 toolCallId 或 tool 加 observation 当键去重。
我建议你把这两点记下来。这条要记牢。它俩是"按输入项隔离状态"的通用解法。任何多输入并发的节点,只要状态是跟着 item 走的,合并时就得按 itemIndex 归位,同时对无主的旧状态去重。
我写了段 Node 复现这个合并逻辑,直接跑给你看结果。旧逻辑合并两个 item 后只剩 1 条历史,新逻辑留下 2 条,legacy 去重后是 3 条。
function mergeNew(into, from) {
if (!into) return from;
if (!from || !from.previousRequests?.length) return into;
const intoRequests = into.previousRequests ?? [];
const seenUntagged = new Set(
intoRequests.filter((s) => s.itemIndex === undefined)
.map((s) => s.action?.toolCallId ?? `${s.action?.tool}:${s.observation}`),
);
const newFrom = from.previousRequests.filter((s) => {
if (s.itemIndex === undefined) {
const key = s.action?.toolCallId ?? `${s.action?.tool}:${s.observation}`;
return !seenUntagged.has(key);
}
return true;
});
return { ...into, previousRequests: [...intoRequests, ...newFrom] };
}
本机跑下来,旧逻辑留 1 条、新逻辑留 2 条、legacy 去重后 3 条,三个数都对上了。这是真实输出。我把复现脚本跑了两遍,输出稳定。我没跑整套 n8n,因为它要 LLM 凭证加数据库,但这条合并逻辑我是拿真代码复现过的,不是看个 changelog 就下结论。
顺带修了流式换行
顺带一条相关的。这版还修了 #43822,停止在流式文本块之间插入换行。之前 AI Agent Node 流式输出时每个 chunk 后加一个换行,把本该连续的文本切得稀碎。这条我理解成:流式输出本来的好处是边生成边显示,结果被一个换行切成一段一段,体验反而更差。这两条合起来,说明这版在收敛 AI Agent Node 的多输入和流式两个行为。
其余 9 条和升不升
剩下的 9 条我没细看,挑几条值得知道的。新装实例给随机 instance ID,避免一堆实例撞同一个 ID。dollar 属性读取交给表达式引擎。沙箱表达式里的小对象放进 Error 不再丢。instance owner 和 admin 在凭证检查里当 team project 成员。Qdrant 向量节点保留反代子路径当前缀。这九条都是边角修复,不是行为变化。
一条对比表收个尾
| 场景 | 该不该升 | 理由 |
|---|---|---|
| AI Agent Node 多输入并发调工具 | 该升 | 历史不再串台,这是实打实的修复 |
| 用流式输出的 AI Agent | 该升 | 不再插多余换行 |
| 单条输入、不用工具历史 | 跳过 | 两条修复都跟你无关 |
| 用 Qdrant 向量节点加反代 | 该升 | 子路径前缀被保留 |
这张表是我的选型建议,不是官方给的,你按自己的场景对号入座。多输入并发是这次升级最充分的理由,别的都是顺带。
值不值得升,我给个分界。你的 AI Agent Node 有多输入并发、或者你在用流式输出,2.48.5 值得升,这两个都是实打实的行为修复。你只是单条输入跑跑简单 Agent,这次升级对你零收益,不用急着追。n8n 本来就是小步快跑,等一两个版本一起升更省事。我的建议是,多输入场景别拖,单输入场景可以攒着。
再补一句实测的结论。我这次没起整套 n8n,只把合并逻辑抽出来在 Node 里跑通了,三个数字对得上。有人会问这算不算真的实测,我的态度是:跑不通整套平台就老实说跑了什么,比装成跑通强。你升级之后,多输入并发场景应该能直接观察到第二个 item 的 Agent 不再失忆。
一句话。2.48.5 的增量不在新功能,在把 AI Agent Node 的多输入并发行为掰正了。多输入场景升级,单输入场景跳过。这版的全部价值就这两条。