MiniMax Agent客服场景工具调用教程

要在MiniMax Agent中实现客服自动查订单等操作，必须启用Function Calling并预先定义工具：创建Agent时配置JSON Schema工具（name全小写）、通过API批量注册、构造含订单号的用户请求、设置functions和tool_choice字段、解析响应区分function_call或content返回、微信对接需XML-JS转换及严格格式校验。

要在MiniMax Agent中实现客服场景下的自动查订单、退换货、查物流等操作，必须让Agent能动态调用企业后端API，不能只靠静态提示词硬编码回答。

启用Function Calling功能并定义客服工具

这一步必须在创建Agent时完成，发布后无法修改tools字段，改了要重新发布才能生效。

方法一：在控制台Agent配置页直接填写JSON Schema

1、进入Agent详情页→点击“编辑”→下滑到【函数调用（Function Calling）】区域→开启开关。

2、在“工具定义”文本框中粘贴以下JSON（注意替换your-domain.com为真实域名）：

{ "name": "query_order_status", "description": "按订单号查询当前的物流进度，以及预计送达时间", "parameters": { "type": "object", "properties": { "order_id": { "type": "string", "description": "16位纯数字的订单编号，例如 2026081212345678" } }, "required": ["order_id"] } }

3、再换行添加第二个工具：

{ "name": "initiate_return_request", "description": "为指定订单发起退货申请，返回受理编号", "parameters": { "type": "object", "properties": { "order_id": { "type": "string" }, "reason": { "type": "string", "enum": ["商品破损", "发错货", "不想要了"] } }, "required": ["order_id", "reason"] } }

方法二：用API方式批量注册（适合已有多个工具的团队）

向https://api.minimax.chat/v1/agents/{agent_id}/tools发送PUT请求，Body为包含全部tool对象的数组，需携带Authorization头。每次更新会全量覆盖，不是追加。

构造含工具调用的用户请求

客服对话中，用户问题必须明确到可触发工具的程度，模糊提问如“我的东西怎么还没到”不会触发query_order_status。

第一步：准备原始消息数组

messages字段至少包含一条user消息，内容需含具体订单号或可提取的关键参数，例如：“订单2026081212345678现在到哪了？”

第二步：确保functions字段与messages同级

不要把functions塞进messages里，它必须是请求体的根级字段；缺少该字段，模型即使看到订单号也只会文字推测，不会发起真实查询。

第三步：设置tool_choice为auto（默认）或指定name

如果只想让模型在必要时才调用，保持tool_choice: "auto"；若强制走某工具，设为{"type": "function", "function": {"name": "query_order_status"}}。

解析响应并执行真实API调用

模型返回结果分两种路径，必须用代码区分处理，不能统一取content字段。

方法一：检测function_call字段存在

检查响应JSON中是否含function_call对象，若有，立刻提取name和arguments——arguments是字符串，需JSON.parse()转为对象，再校验字段类型是否匹配Schema中定义的required项。

方法二：收到HTTP 200但无function_call

说明模型判断无需调用外部服务，直接取choices[0].message.content作为客服回复，例如：“请提供您的订单号以便查询。”

方法三：调用失败后的重试逻辑

如果后端 API 返回的不是 200 状态码，比如库存服务超时，这一步就不能直接跳过。代码里需要先把错误捕获下来，再构造一条 role: "function" 的消息，把 error 信息写进 content，例如{"error": "物流接口暂时不可用，请稍后再试"}，然后把这条消息追加到原 messages 的末尾，重新提交给 MiniMax API。这样处理，才算把多轮工具调用的闭环真正补齐。

微信公众号客服对接中的特殊处理

微信服务器转发用户消息到你的后端时，XML格式需先转成JSON，再喂给MiniMax API。

① 解析微信POST来的XML，提取Content节点值作为user.content；

② 构造请求时，

③ 得到MiniMax响应后，若含function_call，立即调用你自己的订单系统接口，拿到结果后再封装成微信要求的XML返回；

④ 若微信返回“xml格式错误”，大概率是响应体开头多了空格或换行，用trim()清理后再输出。