必须启用function calling并声明工具定义，否则模型不会触发外部api调用；需在控制台勾选启用、提供符合json schema的工具描述、将工具放入functions数组，并通过user/system消息引导调用意图，最后解析function_call字段执行真实http请求并回传结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让MiniMax Agent在运行中自动调用天气查询、数据库或自定义业务API等外部服务，必须显式启用Function Calling能力并正确声明工具结构，否则模型只会生成文字而不会触发任何HTTP请求。
启用Function Calling并声明工具
这一步是整个外部调用的起点，不配置functions字段，后续所有步骤都无效。
第一步：在开发者控制台打开已发布的Agent详情页，点击【编辑】→【高级设置】→勾选“启用函数调用（Function Calling）”。【未勾选此项，即使JSON里写了functions，模型也完全忽略】
第二步：准备一个符合JSON Schema规范的工具定义，例如调用天气接口：
{"name": "get_weather", "description": "根据城市名和单位获取实时天气", "parameters": {"type": "object", "properties": {"location": {"type": "string", "description": "城市名称，如北京"}, "unit": {"type": "string", "enum": ["celsius", "fahrenheit"], "description": "温度单位"}}, "required": ["location"]}}
第三步：将该工具定义放入请求体的functions数组中，与messages同级；每个工具name必须唯一，且不能含空格或特殊符号。
构造含工具调用意图的请求
用户提问必须隐含或明示需要调用外部服务，否则模型不会生成function_call字段。
方法一：直接提问带参数意图
在messages中提交user消息：“查一下上海的天气，单位用摄氏度。”
方法二：用system消息引导行为
智能订单处理助手，帮助用户快速创建WMS发货单。 当用户请求以下操作时使用： 1. 采购/下单/创建发货单（如"帮我采购一本书"、"帮我下单"） 2. 批量处理订单（如"帮我完成这个表格中所有订单的发货"） 3. 从Excel/CSV文件导入订单 支持从标准格式的Excel表格中提取：商品名称、数量、ISBN、收...
在messages首位插入system角色：“你必须严格按需调用get_weather工具，禁止自行编造天气数据。”
方法三：混合多工具场景
若同时声明了get_weather和search_db两个工具，用户问“上海天气怎样？再查下订单号ORD-789”，模型可能生成两个function_call，也可能只调一个——取决于它对意图的理解强度，【不要依赖模型自动拆解复合问题，应由前端做意图预判并分次请求】
解析响应并执行真实HTTP调用
模型返回的是指令，不是结果；你必须自己把指令转成真实请求。
检查响应体是否含function_call字段：如果不存在，直接取content字段作为回复；如果存在，提取其中的name和arguments。
用Python requests库发起真实调用：
requests.post("https://your-api.com/weather", json=arguments, headers={"Authorization": "Bearer xxx"})
注意：arguments是字符串，需json.loads()转换后再传入；若arguments为空对象{}，说明模型没提取出有效参数，应拒绝执行并提示用户补充信息。
拿到外部API返回后，必须封装成role: "function"消息，内容为原始响应体字符串（非JSON对象），追加进原messages末尾，再提交一次请求让模型生成最终回答。
