MiniMax Agent客服场景工具调用教程-人工智能-PHP中文网

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

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

minimax agent客服场景工具调用教程

要在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同级

Larry — Autonomous TikTok Slideshow Agent

自动生成并安排6页TikTok幻灯片，搭配热门开头和图片，关联你的联盟文章，使用NVIDIA FLUX和Postiz。

下载

不要把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——这是多轮工具调用的闭环关键。