minimax agent工具调用不准确源于工具定义、配置或反馈机制问题，需检查description三要素、json schema合规性、tool_choice锁定、错误示例补充及启用x-debug-filter调试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent工具调用结果不准确，说明模型选错了工具、填错了参数，或返回结果没被正确解析——这不是模型“变笨”了，而是工具定义、调用配置或反馈机制出了问题。
检查工具描述是否具备三要素
第一步：打开你注册工具时写的 description 字段，逐句对照三要素是否齐全。
它做什么：必须用一句话说清功能，比如“查询指定城市未来24小时天气实况及体感温度”，不能只写“获取天气信息”。
什么时候用它：明确写出触发条件和排除条件。例如：“当用户问‘现在热不热’‘体感如何’‘要带伞吗’时使用；但用户问‘明天航班几点’‘酒店有没有空房’时禁止调用。”
【缺少任一要素，模型就会靠猜，准确率立刻掉到60%以下】
第二步：把所有工具的 description 放在一起读一遍。如果两个工具开头都写“获取……信息”，中间都带“根据用户请求”，结尾都写“返回结果”，那它们在模型眼里就是同一个工具。
验证 tools 数组是否符合 JSON Schema v7 规范
方法一：用在线校验器（如 jsonschemavalidator.net）粘贴你的 tools 定义，检查是否通过。
重点核对三项：name 必须是合法标识符（只能含字母、数字、下划线，不能以数字开头）；parameters 下的 properties 每个字段必须声明 type；required 数组里列出的字段，在 properties 中必须存在且不可为空。
方法二：在 MiniMax 控制台「模型服务→调试工具」中粘贴 tools 定义，点击“语法检查”。若提示 “Invalid schema: missing required field”，就说明 required 里写了字段名，但 properties 里漏定义了该字段。
强制模型少做选择，用 tool_choice 锁定调用路径
第一步：把原本设为 "tool_choice": "auto" 的请求，改成显式指定：
AI代理参加摇滚演唱会——低音频率、能量曲线、节拍、观众反应。此类场景测试递归处理与升级感知。
"tool_choice": {"type": "function", "function": {"name": "get_weather"}}
第二步：如果业务逻辑允许，直接在 system prompt 末尾加一句：“用户问题涉及天气时，只准调用 get_weather 工具，禁止尝试其他工具。”
第三步：上线后观察日志——若发现模型仍尝试调用 search_web 或 get_stock_price，说明前两步没生效，立刻回查 tools 数组里是否混入了名字相似的冗余工具。
给工具加真实错误示例，不止给正确用法
方法一：在 tools 定义的 description 结尾追加一行：“常见误用示例：用户问‘北京明天热不热’，却传参 {\"location\": \"北京明天\"} —— 正确 location 应为纯地名，不含时间词。”
方法二：若 SDK 支持 examples 字段（如 MiniMax Python SDK v3.2+），直接在 tool 对象里加：
"examples": [{"user_query": "上海现在多少度？", "parameters": {"location": "上海"}}, {"user_query": "查一下北京明天热不热", "parameters": {"location": "北京"}}]
注意：第二个例子故意不写“明天”，因为模型会自动剥离时间词——你要让它知道，你不需要它把时间词塞进 location 参数里。
启用 X-Debug-Filter 查看工具调用决策过程
在 HTTP 请求头中加入：X-Debug-Filter: true。
发起一次工具调用请求，捕获响应体。如果返回内容里有 "tool_decision" 字段，里面会明确写出模型选了哪个工具、依据哪句话判断、location 参数是从用户输入的第几个字提取的。
如果响应里没有 tool_decision，说明你调用的是旧版接口或未开通调试权限——登录控制台，在「项目设置→高级选项」中开启 “Tool Calling Debug Mode”。
