要在MiniMax Agent中实现客服自动查订单等操作，必须启用Function Calling并预先定义工具：创建Agent时配置JSON Schema工具（name全小写）、通过API批量注册、构造含订单号的用户请求、设置functions和tool_choice字段、解析响应区分function_call或content返回、微信对接需XML-JS转换及严格格式校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在MiniMax Agent中实现客服场景下的自动查订单、退换货、查物流等操作，必须让Agent能动态调用企业后端API，不能只靠静态提示词硬编码回答。
启用Function Calling功能并定义客服工具
这一步必须在创建Agent时完成，发布后无法修改tools字段，改了要重新发布才能生效。
方法一：在控制台Agent配置页直接填写JSON Schema
1、进入Agent详情页→点击“编辑”→下滑到【函数调用（Function Calling）】区域→开启开关。
2、在“工具定义”文本框中粘贴以下JSON（注意替换your-domain.com为真实域名）：
【name字段必须全小写且不含下划线，否则模型无法识别调用意图】
{ "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同级
Agent Security DLP - 企业级数据防泄漏系统 功能: 入口防护、记忆保护、工具管控、出口过滤、审计日志 规则: 170条，覆盖金融、医疗、汽车、销售、人力资源、物流等25+行业 触发: check-output(对话出口) / check-input(对话入口) / check-tool(工具执...
不要把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"消息，content填入error信息（如{"error": "物流接口暂时不可用，请稍后再试"}），再将该消息追加进原messages末尾，重新提交给MiniMax API——这是多轮工具调用的闭环关键。
微信公众号客服对接中的特殊处理
微信服务器转发用户消息到你的后端时，XML格式需先转成JSON，再喂给MiniMax API。
① 解析微信POST来的XML，提取Content节点值作为user.content；
② 构造请求时，【agent_id必须显式传入，不能省略或用model替代】；
③ 得到MiniMax响应后，若含function_call，立即调用你自己的订单系统接口，拿到结果后再封装成微信要求的XML返回；
④ 若微信返回“xml格式错误”，大概率是响应体开头多了空格或换行，用trim()清理后再输出。
