调试minimax agent工具调用有三种方法：一是通过agent调试界面查看实时日志，含工具名、参数、状态码及响应体；二是解析api响应中choices[0].message.tool_calls字段获取调用信息；三是导出全量审计日志（csv），支持控制台或命令行方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在调试MiniMax Agent时确认工具是否被正确触发、参数是否传入准确、执行结果是否返回成功，但控制台默认不展示完整工具调用链路与原始响应体。
通过Agent调试界面查看实时工具调用日志
该方法适用于开发阶段快速验证单次对话中工具是否被调用、参数是否符合预期，无需额外配置或导出操作。
第一步：登录MiniMax平台控制台，进入「Agent」模块 → 找到目标Agent → 点击右侧「调试」按钮。
第二步：在弹出的Web聊天窗口中，输入测试问题（例如：“查一下上海今天天气”），点击发送。
第三步：等待响应完成，在对话消息下方会出现一个灰色小标签「【工具调用】」，点击它即可展开本次调用的完整日志面板。
日志面板中会显示：工具名称、传入参数JSON、调用时间戳、HTTP状态码、原始响应体全文。若工具未触发，该标签不会出现——说明提示词未激活工具，或function schema定义有误。
从API响应体中提取工具调用记录
当Agent通过API被集成到自有系统时，工具调用过程全部封装在返回JSON中，需主动解析choices字段下的tool_calls数组。
向https://api.minimax.chat/v1/text/chatcompletion发起请求后，检查返回体中的choices[0].message.tool_calls字段。
若存在该字段，说明模型已生成工具调用指令；其下function.name和function.arguments即为实际调用的工具名与参数字符串。
【注意】arguments是JSON字符串而非对象，需二次JSON.parse()才能读取结构化参数，直接取值会报错。
若tool_calls为空数组或不存在，不代表工具没执行——可能模型判定无需调用，也可能工具未被正确注册到Agent配置中。
导出全量工具调用审计日志（CSV格式）
适用于需要回溯过去7天内所有工具调用行为、做失败率统计或合规存档的场景。
方法一：控制台导出
1. 登录console.minimax.tech → 进入目标项目 → 「设置」→「安全与审计」→「启用请求日志」（如未开启需先开通）。
2. 在「审计日志」页签中，将时间范围设为所需区间，勾选「包含请求体摘要」和「包含响应体摘要」。
3. 点击「导出CSV」，下载文件后用Excel打开，筛选tool_call列含非空值的行，即为工具调用记录。
方法二：命令行提取（需已安装mmx-cli）
在终端执行：mmx-cli logs --agent-id your_agent_id --from "2026-08-05T00:00:00Z" --to "2026-08-12T00:00:00Z" --filter tool_call > tool_logs.csv。
这一步会直接生成仅含工具调用事件的CSV，字段包括timestamp、tool_name、input_params、execution_status、duration_ms。
