必须启用Function Calling并声明工具定义，否则模型不会触发外部API调用；需在控制台勾选启用、提供符合JSON Schema的工具描述、将工具放入functions数组，并通过user/system消息引导调用意图，最后解析function_call字段执行真实HTTP请求并回传结果。

要让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消息引导行为

在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末尾，再提交一次请求让模型生成最终回答。