一个 null 如何让 Agent 工具调用失败:流式协议兼容性实战

作者:hpoenixf日期:2026/11/3

模型已经开始生成工具参数,流也在继续返回,Agent 却在真正调用工具之前失败了。排查到最后,触发拒绝的不是错误工具名,也不是非法参数,而是后续碎片里一个 id: null。

这类修复很容易走向两个极端:继续拒绝所有 null,或者看到 null 就宽松放行。我们最后采用的是第三种办法:只在同一索引已经建立非空调用身份时,把后续 null 解释为“不更新身份”。

这是 open-etf-agent v0.15.2 的一个窄范围兼容修复。它没有发明工具 ID,没有改变工具授权,也没有跳过完整调用的最终校验。

一、工具调用是增量事件,不是每帧一个完整对象

对流式 Chat Completions,一次工具调用可能分散在多个事件中。应用按本次响应里的 index 找到正在组装的调用,再拼接函数名和参数字符串,最后把完整提议交给校验与执行链。

下面是简化的合成碎片,省略了外层 SSE、choices 和结束事件,不是原供应商载荷:

1{"index":0,"id":"call-a","function":{"name":"read_page","arguments":"{\"page\":"}}
2{"index":0,"id":null,"function":{"arguments":"1}"}}
3

第二片段仍然属于索引 0。函数参数从 {"page": 继续变成 {"page":1};真正需要决定的是,后面的 null 是否应该推翻前面已经确定的 call-a。

旧实现的判断接近“只要提供了 id 字段,就必须是字符串,且不能冲突”。这对完整对象校验很直观,却把增量事件中的“没有身份更新”也当成了新的身份值。

关键不在 null 本身,而在 输入值与已有状态的组合。

二、先画清允许的状态转移

修复的前提是相同响应内的同一工具索引,而不是碰巧工具名相同,也不是上一轮请求曾经用过某个 ID。

已有状态与新片段本次处理
已有非空 ID,后续省略 id保留原 ID
已有非空 ID,后续 id 为 null保留原 ID,这是本次新增兼容
已有非空 ID,后续给出相同字符串保留原 ID
已有非空 ID,后续给出不同字符串或空字符串拒绝身份冲突
首片段或新索引没有既定非空 ID,却给出 null拒绝,不能凭空创建身份
id 为数字、布尔值、数组或对象继续拒绝

原实现允许早期空字符串在后续被有效字符串补齐,这条既有行为不因本次修复改变。但空字符串不算“已建立的非空身份”,不能拿它为 null 续片开绿灯;完整提议仍须通过最终验证。

把新增例外单独表达,判断就很小:

1const hasEstablishedId = typeof call.id === 'string' && call.id.length > 0;
2const keepsEstablishedId = part.id === null && hasEstablishedId;
3if (part.id !== undefined && !keepsEstablishedId) {
4  validateOriginalIdRules(call.id, part.id);
5  call.id = part.id;
6}
7

这是提炼后的教学伪代码,validateOriginalIdRules 代表原有的类型和冲突检查。它不是可单独替换整个流解析器的实现,也没有承担参数、权限或执行验证。

三、兼容发生在组装层,信任不能跟着扩大

如果把“允许 null”写成通用清洗规则,例如给缺失 ID 自动补随机值,程序可能不再报错,却会制造一个供应商没有提供过的调用身份。后续结果关联、去重和诊断就失去了原始依据。

另一个危险做法是拿上一条调用的 ID 填补当前片段。并行工具可能交错返回,这会把不同索引的参数拼到错误调用上。

正确的位置是本次响应、当前索引对应的组装状态:只保留已建立的那个 ID,不跨索引借用,不跨请求继承,也不在冲突时选择一个“看起来更合理”的值。

流程依次定位本次响应索引、检查已有身份:已建立身份的 null 续片保留该身份;其他输入继续原身份校验,非法身份被拒绝。通过后才累积参数、校验完整提议,并交由原 Host 授权;非法提议不派发。

只有后续 null 且已有非空 ID,才走保留身份分支;其余情况继续原检查。最终校验仍检查组装后的参数与调用身份,随后由原 Host 决定工具是否获准执行。兼容片段不是执行许可。

流是否完整结束,也是另一条条件。这个修复没有把半段响应、异常结束或超出支持范围的协议伪装成一个可执行调用。

四、怎样证明修好的是问题,而不是删掉了保护

最小单元测试可以直接喂两个片段,断言 ID 仍为 call-a。但这样还不够:我们真正关心的是,这条调用能不能通过原网关进入运行时,并完成原本的用户任务。

因此,回归使用一条合成的完整链路:读取资料,保存报告,再通过原运行时结束任务。对照组的续片省略 ID,目标组的续片携带 null;两边最终保留相同调用身份,并得到相同的报告内容。

同时要覆盖拒绝分支:首次 null、新索引 null、不同字符串、非法类型,不能因为正例修好了就开始被接受。即使 ID 续片合法,参数拼接后不是有效 JSON,或者最终出现重复调用 ID,也仍然必须失败。

这是一类非常适合用状态转移测试的兼容问题。单测输入不只是“字段有哪些值”,还要包含“这一值到达时已经积累了什么状态”。

后续独立的真实模型任务验证了集成后的正常读取、发布与恢复路径,但不能据此证明那一批流里实际出现过 null 续片。目标边界由受控的 null 反例与正例证明,真实任务验证的是集成没有破坏其他行为。 两种证据不能互相冒充。

五、错误诊断不必保留原始参数

之前多个身份问题都可能被归到一个复合错误里。只看到 TOOL_FRAGMENT_ID,还无法分清是首片段没有身份、后续 ID 冲突,还是类型不受支持。

但为了区分这些情况,并不需要把真实工具参数、用户资料或完整模型输出写进日志。受限诊断可以只保留错误类别、输入 ID 类型、此前是否已有非空 ID,以及字符串是否为空等有限信息。

例如,“输入类型为 null,已有身份为真”有助于定位本次兼容问题;“输入为字符串,已有身份为真且冲突”则应继续走原拒绝路径。它们不是同一个修复理由。

诊断越能描述状态关系,越不需要依赖泄露原始内容来还原现场。

六、一个修复不能包办所有历史故障

这次调查拿到了一次真实资格验证中“已有 ID 后出现 null”的受限诊断证据,足以提出并验证这个具体修复。

更早的复合身份错误没有同样完整的分类信息,不能回头宣布它们也都是 null 引起的。旧失败仍是旧失败,不因为新版本任务通过就改写记录。

同样,某个供应商出现过这种流形态,不等于所有供应商的协议都承诺 null 续片合法。这里实现的是一个有前置条件、保持既有身份的兼容规则,不是对任意响应的普遍放行。

结语:好的兼容修复,增加的是一个有条件的解释

这次源码变更很小,真正需要想清楚的是哪种状态转移可以保留不变量:已有身份不被清除,不同调用不被混合,缺失身份不被伪造,完整提议仍要校验。

遇到下一次协议差异,可以先问:它是完整对象字段,还是增量更新?什么已有状态使它安全?在哪一层解释它,才不会把权限、执行或恢复规则一起放宽?

兼容不是把校验关掉,而是在不改变原事实的前提下,准确接受一种原先未覆盖的表示。

实现与回归可阅读公开仓库中的流组装代码、null 续片回归及版本验证说明。

延伸阅读:从工具调用到模型输入 · 可观测全景中的 Trace 完整性

欢迎为 open-etf-agent 点一个 Star,结合源码阅读这些边界。

原文阅读:一个 null 如何让 Agent 工具调用失败。


参考文档


《一个 null 如何让 Agent 工具调用失败:流式协议兼容性实战》 是转载文章,点击查看原文。


相关推荐


Linux网络学习【深入理解应用层HTTP协议、Cookie与Session机制及HTTPS协议原理】
承渊政道2026/10/26

🔥承渊政道:个人主页 ❄️个人专栏: 《C语言基础语法知识》 《数据结构与算法》 《C++知识内容》 《Linux系统与网络知识》 《算法刷题指南》 《测评文章活动推广》 《大模型语言路线学习》 《MySQL数据库学习》 《Python知识内容》 《cpolar知识学习》 ✨逆境不吐心中苦,顺境不忘来时路!✨ 🎬 博主简介: 打开网页、登录账号、提交表单,这些日常操作背后,涉及三个紧密相关的问题:浏览器与服务器如何交换数据?为什么登录一次后


AI 流式传输工程指南:模型吐出半截 JSON,前端如何边收边渲染?
猫头_2026/10/18

本文是通俗实战版。保留全部工程精华、性能实测对比与跨框架(原生 JS / Vue 3 / React)开箱即用代码,8 分钟即可读完并直接落地到项目中。 一、为什么不能等 JSON 吐完再解析? 做普通 AI 聊天时,模型吐出的是纯文本或 Markdown,前端收到一个字就往屏幕上追加一个字(打字机效果)。 但现在越来越多的 AI 功能要求模型直接返回 JSON 结构化数据,让前端渲染成交互组件: 典型业务场景模型输出的 JSON


Android签名算法还原:Xposed/LSPosed实战
深蓝电商API2026/10/16

在 Android 应用逆向与安全分析领域,应用签名校验是抵御二次打包、篡改破解的第一道防线。绝大多数正规应用都会在 Java 层或 Native 层植入签名校验逻辑,一旦检测到 APK 签名与官方签名不一致,便会触发闪退、功能禁用、账号封禁等防护机制。而 Xposed 及其演进框架 LSPosed 凭借运行时方法 Hook 能力,成为绕过签名校验、还原签名算法的主流工具。本文将从 Android 签名机制底层原理出发,结合实战案例讲解如何基于 Xposed/LSPosed 完成 Java 层、


一条审批流的数据库账:5 张核心表、3 张扩展表、0 张表单表
mldong2026/10/8

要在一套系统里加审批流,第一个绕不过去的问题是:要动多少数据库? 答案决定了这件事的难度。如果每个引擎都要你先建二十张表、跑三个迁移脚本、再请一位懂它内部编码的人来解释每张表在干什么,那这件事在评审会上就永远过不了。我们把这套引擎用八种语言各写了一遍,表结构反而是一个可以当面数清楚的东西: 建表 SQL 一共 128 行,8 张表、81 列; 其中真正参与流程裁决的是 5 张(54 列),另外 3 张(27 列)是设计稿台账和委托窗口这类管理能力; 表单表 0 张。你的表单数据不建新表,它进的


把 bug tracker 塞进 git 仓库,同步和冲突怎么解决?我把 git-bug 拆开实测了一遍
Flynt2026/9/30

上周五(9 月 25 日)Hacker News 首页出现了一个讲 git-bug 的帖子——"嵌在 git 里的分布式 bug tracker",这两天涨到了 353 分。它能翻红有个前置事件——9 月 22 日发了 v0.11.0,这是项目 16 个月来的第一次发版,一口气带上了近 300 个 commit。更硬的背书来自 kernel.org 那边:b4 的维护者 Konstantin Ryabitsev 在今年的 Kernel Recipes 上演示了 b4 和 cgit 对 git-b


MCP 到底接在了哪一层?从“Agent 调工具”说起
杨杨杨大侠2026/9/24

“最后不还是 Agent 在调工具吗?那 MCP 多做了什么?” 这个问题比背定义有用。因为第一次看 MCP,很容易把模型、Agent、Harness、Client、Server 都画成一团,然后得出一个模糊的结论:MCP 就是 Function Calling 的另一种写法。 先说结论:模型负责提出要做什么,应用负责把它做成一次真实调用;MCP 约定的是应用与外部服务之间怎么对接。 先从一次工具调用看起 假设我对一个代码助手说:“帮我看看 PR 123,有没有明显问题。”模型发现自己还没看到改


Vibe Coding 实战问答:从 Token 成本到线上 Bug 的避坑指南
ᕙ(•̤᷆ ॒ ູ॒•̤᷇)ᕘ.2026/9/15

Vibe Coding 与 AI 辅助编程 · 问答整理 主题:AI 辅助编程的定位认知、Token 成本控制、线上问题处理与实战经验。 1. Vibe Coding 到底是什么? Vibe Coding 与常规 AI 辅助编程的核心差异,在于人对代码的参与程度与责任归属: 维度Vibe CodingAI 辅助编程代码生成AI 生成AI 生成代码审查不看,直接 Accept逐行审查报错处理粘贴给 AI分析根因再决定对代码负责不负责完全负责 一句话概括:Vibe Coding 是"只管氛围、


【智能体】Agent的四种设计模式之:React(2026最新版)
Carl_奕然2026/9/7

ReAct 模式 —— 推理与行动交织的循环智能体 1、引言2、ReAct 到底怎么工作?3、ReAct 核心原理3.1 关键数据结构3.2 与 Chain-of-Thought 的区别 4、生产级实现(LangGraph + MCP)5、2026 年的关键改进点5.1 从 "字符串解析" 到 "结构化输出"5.2 步数预算与防循环5.3 KV-Cache 复用优化 6、适用场景与性能基准7、总结 1、引言 小屌丝:鱼哥,我最近写了个 Agent,让它查天气,结果你猜怎么着?它


Linux(一)Linux的基本指令操作和shell命令以及运行原理
在路上慢慢走2026/8/30

1. 引言 在正式学习 Linux 指令之前,先花几分钟了解一下 Linux 的来龙去脉,会帮助你更好地理解为什么指令是这样设计的、为什么系统是这样组织的。这一节作为「前传」,只讲最核心的背景知识,不涉及具体指令操作。 2. 什么是 Linux Linux 是一个开源的操作系统内核,最初由芬兰人林纳斯·托瓦兹(Linus Torvalds)于 1991 年发布。我们平时说的「Linux 系统」,实际上是 Linux 内核加上 GNU 工具集、各种应用软件共同组成的完整操作系统,通常称为 GNU/


Neo4j与Cypher入门:从图思维到多跳查询实战
桃酥不是桃2026/8/22

当写《RAG 没有死》那篇、写到 GraphRAG 那一节的时候,我心里是有点发虚的。多跳推理、知识图谱、社区发现,这些词都是从论文和官方文档里搬来的,我自己并没有真的建过一张图、跑过一条查询。引用式写作的账迟早要还,所以最近两个周末我把 Neo4j 和 Cypher 认真补了一遍,顺手把 Agent 场景下图的选型边界也想清楚了。 这篇是补课笔记的上篇,聊三件事,图数据库到底解决什么问题,Cypher 怎么写,什么时候值得为你的 Agent 引入一张图。先澄清一个容易混的点,之前写《从 Lo

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读