要在生产环境让MiniMax Agent自动执行跨应用复杂任务，必须通过API创建结构化JSON指令，先获取API Key和Group ID两把凭证钥匙，再调用/v1/tasks接口提交任务，并轮询task_id获取结果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在生产环境中让MiniMax Agent自动执行跨应用、多步骤的复杂任务（比如“从飞书拉取上周销售数据→用Python清洗→生成可视化图表→发邮件给主管”），必须通过API创建结构化任务指令，而非在网页端手动输入。
获取必要凭证
第一步不是写代码，而是拿到能证明你身份的两把钥匙：API Key和Group ID。没有它们，任何请求都会被直接拒绝。
打开浏览器，访问 https://platform.minimaxi.com（注意域名结尾是 minimaxi.com，不是 minimax.com）。
使用已完成实名认证的手机号登录控制台 → 左侧菜单点击【接口密钥】→ 点击【创建新密钥】→ 输入名称（如“sales-automation”）→ 点击确认。
【API Key仅显示一次，关闭页面即永久丢失】
在同一页下方找到【Group ID】字段，复制那串16位十六进制字符串（例如：a1b2c3d4e5f67890）。
构造任务创建请求
MiniMax Agent不接受自然语言描述的任务，只认JSON格式的结构化指令。你必须明确告诉它：要做什么（task_type）、交给哪个Agent执行（agent_id）、输入数据长什么样（input）、以及超时时间（timeout_seconds）。
方法一：用curl命令行调用（适合调试）
在终端中执行以下命令，将其中 sk-xxx 替换为你自己的API Key，grp_xxx 替换为你的Group ID，agt_xxx 替换为你已发布的Agent ID：
curl -X POST https://api.minimaxi.com/v1/tasks \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"group_id": "grp_xxx",
"agent_id": "agt_xxx",
"task_type": "run",
"input": {"query": "生成一份包含销售额、环比增长率、TOP3产品明细的周报"},
"timeout_seconds": 120
}'
方法二：用Python requests发送（适合集成进业务系统）
确保已安装requests库：pip install requests。然后运行：
import requests
url = "https://api.minimaxi.com/v1/tasks"
headers = {
"Authorization": "Bearer sk-xxx",
"Content-Type": "application/json"
}
payload = {
"group_id": "grp_xxx",
"agent_id": "agt_xxx",
"task_type": "run",
"input": {"query": "提取附件PDF中的客户联系方式并存入CRM"},
"timeout_seconds": 300
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
验证任务是否成功创建
第一步：检查HTTP状态码。返回 201 Created 表示任务已进入队列，此时响应体中会包含一个 task_id 字符串（如 task_abc123）。
第二步：用这个task_id轮询结果。向 https://api.minimaxi.com/v1/tasks/{task_id} 发送GET请求，直到 "status" 字段变为 "completed" 或 "failed"。
第三步：若 status 为 completed，读取 output 字段内容；若为 failed，则查看 error_message 字段——常见错误是 agent_id 不存在或 input 结构不符合该Agent的schema定义。
这一步操作起来很简单，直接把文件拖进去就行。
