“参数解析失败”错误源于传入json不符合工具schema要求,需检查required字段完整性、type/format/enum等约束,验证json语法与嵌套结构,修正字符串引号、布尔字面量、null表示及数组类型一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

AgentKit智能体工具调用时出现“参数解析失败”错误,说明传入的JSON结构不符合工具定义的schema要求,导致底层无法反序列化或校验通过,必须立即修正输入格式才能继续执行。
检查工具定义中的parameters schema
打开AgentKit控制台→进入对应智能体→点击「工具管理」→找到报错工具→点击「编辑」,查看右侧显示的JSON Schema定义(通常为OpenAPI 3.0格式的parameters字段)。
重点核对required数组中声明的必填字段是否全部提供,以及每个字段的type(string/number/boolean/object/array)、format、minLength、enum等约束是否被严格满足。
验证传入参数的JSON语法与结构嵌套
方法一:使用在线JSON校验器(如jsonlint.com)粘贴你构造的parameters字符串,确认无语法错误、末尾无逗号、引号为英文双引号。
方法二:在代码中启用严格序列化——若用Python,确保调用json.dumps(obj, ensure_ascii=False, separators=(',', ':')),避免手动拼接JSON字符串;【手动拼接JSON极易因转义缺失或空格错位导致解析失败】。
UP 简历 AI 求职助手。创建专业简历、搜索校招/社招/实习岗位、JD 对照优化、简历诊断、每日求职监控、智能投递指导。当用户说"创建简历"、"编辑简历"、"搜索校招"、"找工作"、"优化简历"、"投递"、"监控校招"时使用。
方法三:对比schema中定义的object层级深度,检查是否多嵌套了一层。例如schema要求{"query": "text"},而你传了{"parameters": {"query": "text"}},就会因顶层多出parameters字段被拒绝。
处理常见类型不匹配问题
第一步:字符串值未加双引号——如写"age": 25是合法的,但"age": 25(无引号)在JSON中是number类型,若schema中定义为string则直接失败。
第二步:布尔值写成字符串——"is_active": "true" 不等于 "is_active": true;后者才是JSON标准布尔字面量。
第三步:null值未正确表示——需显式写为"field": null,不能写成"field": "null"或留空。
第四步:数组项类型混杂——schema若定义items: { "type": "string" },则["a", 123]会因第二项是number被拦截。










