在MiniMax平台开发Agent时,必须用特定JSON格式声明工具调用意图,否则模型不会触发函数执行;需在messages末尾添加空content的user消息,再添加含tools和tool_choice字段的assistant消息,tools为工具定义数组且parameters需符合JSON Schema规范,tool_choice须精确匹配tools中某name;单工具调用可写全定义或复用已注册tool_id;多工具并行调用须将所有工具写入同一tools数组并将tool_choice设为{"type": "any"}。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在MiniMax平台开发Agent时,必须用特定格式的JSON结构声明工具调用意图,否则模型不会触发函数执行,也不会返回tool_calls字段。
基础工具调用指令结构
第一步:在messages数组末尾添加一条role为"user"的消息,content字段值为空字符串""。
第二步:紧接着追加一条role为"assistant"的消息,其content字段必须为JSON字符串,且顶层包含tools字段和tool_choice字段。
第三步:tools字段是工具定义数组,每个对象含name、description、parameters三字段;parameters必须是合法JSON Schema(type、properties、required缺一不可)。
第四步:tool_choice字段值设为{"type": "function", "function": {"name": "tool_name"}},其中tool_name必须与tools数组中某项的name完全一致,【大小写和下划线都不能错】。
单工具调用的精简写法
方法一:直接在assistant消息中写全tools+tool_choice,适合只调一个工具的场景。这一步操作起来很简单,直接把工具定义粘贴进去再配好tool_choice就行。
方法二:复用已注册的tool_id(如平台支持),此时tools字段可省略,仅保留tool_choice并指定id。注意:若tool_id未提前在bot配置中启用,请求会直接报错400。
多工具并行调用写法
当需要同时触发多个工具时,不能靠多次发送assistant消息实现。必须在单条assistant消息的content中,将所有待用工具定义全部写入tools数组,并把tool_choice设为{"type": "any"}。
这会告诉模型:从tools列表里选一个或多个执行。模型返回的tool_calls字段可能包含1~n个调用项,顺序由模型自主决定,【不保证与tools数组中的排列顺序一致】。


















