必须手动开启工具调用开关，否则工具请求被静默忽略；工具调用由用户自然语言隐式触发，无需额外字段；成功时响应含tool_calls字段；需按步骤处理工具结果并二次请求获取最终content。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认Agent已启用工具权限
登录MiniMax Agent控制台后，必须手动开启工具调用开关，否则所有工具请求都会被静默忽略——这是新手最常踩的坑，【未开启权限时API返回无报错但content为空】。
进入Agent详情页→点击右上角“设置”图标→在“工具权限”区域找到“联网搜索”“代码执行”“浏览器操作”等开关→全部切换为开启状态。
注意：部分工具（如M2.5-Search）需绑定已发布的Agent实例才可激活，未发布状态下开关呈灰色不可点。
构造含工具调用意图的用户消息
工具调用不是靠额外字段触发，而是由用户输入内容隐式驱动——模型根据语义自主判断是否需要调用工具。
直接在messages数组中提交自然语言提问，例如：[{"role":"user","content":"查一下截至今天上午10点的上海实时气温，并生成一张带图标的小图"}]。
这一步不能写成“请调用天气API”，也不能加任何标记符或指令前缀；模型若未在训练中见过该工具能力，或提示词中未赋予对应权限，将退回纯文本回复。
验证响应中是否包含tool_calls字段
成功触发工具调用时，API响应体不再只返回content，而会在choices[0].message中新增tool_calls数组。
检查JSON结构是否存在"tool_calls": [{"id": "call_abc123", "type": "function", "function": {"name": "weather_search", "arguments": "{...}"}}]。
若缺失该字段，说明模型未识别出工具需求，需检查：① 用户问题是否含明确时效/执行类动词（查、生成、运行、打开）；② Agent系统提示词是否允许使用外部工具；③ 模型版本是否支持该工具（M2.5及以上才原生支持M2.5-Search）。
处理工具调用结果并获取最终回复
第一步：提取tool_calls中的function.name与arguments，按工具文档格式发起二次请求（如调用weather_search需传入location="上海"和unit="celsius"）。
第二步：拿到工具返回的原始数据（如JSON格式天气数据）后，构造新的messages数组，追加两条消息：
① role="assistant"，content为空，但携带完整的tool_calls字段；
② role="tool"，content为工具返回的原始字符串，且必须带上对应的tool_call_id。
第三步：再次POST请求至同一API端点，此时模型将融合工具结果生成自然语言终稿，【content字段即为面向用户的最终输出，无需再解析tool_calls】。
