Skip to content

fix(tools): 「阻止了无效的工具调用」误拦根因修复——嗅探器 rawArgs 契约 + 必填字段别名纠错 - #395

Merged
tall-1997 merged 1 commit into
mainfrom
fix/tool-call-habit-args
Nov 18, 2026
Merged

tall-1997 merged 1 commit into
mainfrom
fix/tool-call-habit-args

Conversation

@tall-1997

Copy link
Copy Markdown
Owner

用户报告:运行中频繁出现「运行工具失败 → 阻止了无效的工具调用」,集中在文件类工具。

根因(两个,均已修)

1. 内容嗅探路径静默替换空参数(GH#61/#83/#146 契约缺口)
ContentToolCallSniffer.argsOf 在 arguments 串解析失败时返回空 {} 且不携带原始串。GH#113 类网关(工具调用经 delta.content 下发)上,每次调用都被必填字段预检拦成「无效工具调用」。SSE 与非流式路径早已按契约携带 rawArgs,本 PR 把嗅探器补齐到同一契约:预检可尝试截断修复,修不了则给出带字节数的精确「参数流不完整」拒绝。

2. 必填字段别名纠错缺失(模型习惯名)
ToolJsonRepair 的字段名纠错只覆盖编辑距离 1 的拼写错(comand→command)。模型训练习惯名 file_path→path(距离 6)救不回来——完整合法的载荷被必填校验判死。新增策略 4:枚举别名表(path/command/content/pattern/query/url/code/action/name/title/question 的常见变体),仅在必填字段缺失、且变体键不是本工具 schema 字段时改名(防 stealing)。

验证

  • 全量 6662 测试 0 失败(新增 6 用例锁定两契约:rawArgs 携带、别名改名、schema 字段防抢占、端到端 file_path→Ready)
  • 9 项架构门禁全绿;OpenAIRawStream.kt 保持基线 1091 行

用户报告文件类工具频繁被拦 Blocked invalid tool call。两个根因:

1. ContentToolCallSniffer.argsOf 在 arguments 串解析失败时静默替换 {}
   且不带原始串——GH#113 类网关(工具调用经 content 流下发)上每次
   调用都被必填字段预检拦成「无效工具调用」。补齐 GH#61/#83/#146 契约:
   解析失败携带 rawArgs,预检可尝试截断修复或给出精确的「参数流不完整」
   拒绝,替代无上下文的笼统拦截。

2. ToolJsonRepair 字段纠错只覆盖编辑距离 1(comand→command 这类拼写
   错),模型训练习惯名 file_path→path(距离 6)救不回来——完整合法
   的载荷被必填校验判死。新增策略 4:枚举别名表(path/command/content/
   pattern/query/url/code/action/name/title/question 的常见变体),
   仅在必填字段缺失且变体键不是本工具 schema 字段时改名。

验证:全量 6662 测试 0 失败(新增 6 用例锁定两契约);9 门禁全绿;
OpenAIRawStream 保持基线 1091 行。
@tall-1997
tall-1997 merged commit 99413db into main Nov 18, 2026
1 check passed
@tall-1997
tall-1997 deleted the fix/tool-call-habit-args branch November 18, 2026 15:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant