MiniMax Agent API任务指令调用操作步骤
要让MiniMax Agent按指令执行任务，需三步：一是在messages中用“场景+动词+约束+交付物”结构化指令并正确引用file_id；二是同级声明functions数组启用工具调用，name须小写无空格；三是处理两阶段响应，首次调用后将function返回结果作为role为"function"的消息追加并重发请求。
要让MiniMax Agent按指定任务指令执行操作，比如生成周报、解析Excel或调用天气API，必须通过API请求体中的messages字段注入结构化指令，并确保agent_id与function调用配置正确匹配，否则模型会忽略任务要求直接闲聊。
第一步：构造含任务指令的messages数组
这一步决定Agent是否理解你要它做什么。不能只写“帮我写周报”，必须明确角色、动作、输入源和输出格式。
在JSON的messages字段中，至少包含一条role为"user"的消息，content内容需套用“场景+动词+约束条件+交付物”结构。例如：【你是一名财务助理，请根据附件中的销售数据表（CSV格式），统计各区域Q2销售额并生成带柱状图的Markdown表格，最后用中文总结增长TOP3原因】。
若指令中提及文件（如Excel、PDF），必须先完成文件上传并获得file_id，再在content里写成“请分析file_id:xxx中的数据”。不这样做，Agent会返回“未检测到可分析文件”。
这一步操作起来很简单，直接把指令字符串填进messages[0].content就行。
第二步：启用Function Calling并声明外部工具
当任务需要调用真实API（如查天气、发邮件、读数据库）时，仅靠自然语言指令不够，必须显式声明可用函数。
方法一：在请求体根层级添加functions数组，每个元素是标准JSON Schema定义的工具，包含name、description和parameters。name值必须全小写且无空格，例如"get_weather"而非"GetWeather"。
方法二：若使用MiniMax-M3模型，可在functions中加入"m2_search"作为内置联网工具——只需声明，无需提供endpoint，系统自动路由至M2.5-Search服务。
【functions字段必须与messages同级，不能嵌套在messages内部，否则整个函数列表被忽略】。
第三步：发送请求并处理两阶段响应
1、向https://api.minimax.chat/v1/text/chatcompletion发起POST请求，携带Authorization头与完整JSON体。
2、检查响应状态码：200表示请求成功，但不等于任务完成；若返回中含function_call字段，则说明模型决定调用工具。
3、提取function_call.name和function_call.arguments，用HTTP客户端调用对应外部API，将返回结果构造成role为"function"的新消息，追加到原messages末尾。
4、用更新后的messages数组再次请求同一接口，这次响应中choices[0].message.content即为最终交付文本。
注意：第二次请求必须复用第一次的agent_id、same session_id（如有），否则上下文断裂，Agent无法关联前序动作。
-
08.15
如何撰写保密工作汇报？一份详尽的保密工作汇报范文与提示词供你参考！
-
08.15
异环月光当铺通关攻略异环月光当铺全流程图文详细说明与隐藏结局触发方法
-
08.15
领主契约盟约系统详细说明领主契约盟约系统机制与玩法全解析
-
08.15
你在用什么工具，深入探讨AI图表工具的未来设计与应用
-
08.15
Midnight Apartment Cooking Scene
-
08.15
《奶妈修炼场技能顺序攻略》（细说技能搭配，助你成为顶级奶妈）
-
-
下载
- |
-
-
下载
- 《行尸走肉第一章》免安装中文汉化硬盘版下载
- 单机|436 MB
- 一款以动作冒险为主题的游戏
-
-
下载
- 《街头霸王X铁拳》免安装中文汉化硬盘版下载
- 单机|111MB
- 一款非常好玩的格斗游戏
-
-
下载
- |
-
-
下载
- 《暗黑破坏神3》免安装繁体中文正式版下载
- 单机|7630 MB
- 一款以角色扮演为主题的游戏
-
-
下载
- 《马克思佩恩3》免安装硬盘版下载
- 单机|27033 MB
- 一款以第三人称射击为主题的游戏