要让minimax agent按指令执行任务，需三步：一是在messages中用“场景+动词+约束+交付物”结构化指令并正确引用file_id；二是同级声明functions数组启用工具调用，name须小写无空格；三是处理两阶段响应，首次调用后将function返回结果作为role为"function"的消息追加并重发请求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让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"。
使用 dm.bot API 进行加密的智能体间消息传递。适用于向其他智能体发送私信、发布公开消息、查看收件箱、管理群组或设置 webhook。触发词包括 dm.bot、智能体消息或加密通信。
方法二：若使用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无法关联前序动作。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
