必须亲手搭建端到端工作流才能让minimax agent稳定运行：先注册账号并创建agent实例，再配置系统提示词、获取agent id与token，通过curl或postman验证基础响应，接着用flask接入微信公众号，最后通过agent team或n8n实现多步任务协同。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让MiniMax Agent真正跑起来，自动响应用户消息、执行多步任务、不卡顿不掉链，必须亲手搭一条端到端可验证的工作流，而不是只点几下控制台就以为部署完成了。
注册账号并创建首个Agent实例
这一步是所有后续操作的前提，跳过会导致后续所有API调用返回401错误。
1. 打开浏览器，访问 https://platform.minimax.io，点击右上角“登录”，用手机号完成注册并短信验证。
2. 登录后进入控制台首页，点击“新建项目”，填写名称为“auto-reply-workflow”，描述写“公众号/企微自动应答主干流程”，确认创建。
3. 左侧导航栏点击“Agent”→“创建Agent”，模板选“通用对话型”，命名填“客服应答Agent”，系统提示词框中粘贴以下内容：
你是一名专注售后问题的客服助手，只回答退货流程、发货时间、订单查询三类问题；遇到其他问题统一回复“请描述具体订单号和问题，我将为您转接人工”。【必须严格限定范围，否则Agent会自由发挥导致回复失控】
4. 点击“保存并发布”，页面跳转后立即复制顶部显示的Agent ID和测试Token——这两个值5分钟后会在控制台列表页隐藏，且无法二次查看。
本地调试：用curl验证Agent基础响应能力
不写代码也能确认Agent是否按预期理解指令，这是排查“模型没反应”“回复乱码”等问题的第一道关卡。
方法一：终端直接调用（推荐Mac/Linux）
打开终端，执行以下命令（把YOUR_AGENT_ID和YOUR_API_KEY替换成上一步拿到的真实值）：
curl -X POST "https://api.minimax.chat/v1/text/chatcompletion" \<br>-H "Authorization: Bearer YOUR_API_KEY" \<br>-H "Content-Type: application/json" \<br>-d '{"agent_id":"YOUR_AGENT_ID","messages":[{"role":"user","content":"我的订单还没发货，能查一下吗？"}]}'
方法二：用Postman（Windows用户友好）
新建POST请求，URL填https://api.minimax.chat/v1/text/chatcompletion，Headers加两行：Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json，Body选raw→JSON，填入包含agent_id和messages的完整JSON。
看到返回里choices[0].message.content字段含“请提供您的订单号，我将为您查询发货状态”这类内容，说明Agent已通电启动。
接入微信公众号：配置服务器与消息路由
微信服务器只会把消息推送到你指定的URL，且该URL必须通过Token校验，否则连第一条消息都收不到。
第一步：准备Flask后端服务
在云服务器（推荐腾讯云轻量应用服务器，8核16G够用）上新建目录wechat-agent，执行：pip install flask requests python-dotenv，然后创建.env文件，写入：
MINIMAX_GROUP_ID=your_group_id<br>MINIMAX_API_KEY=your_api_key<br>WECHAT_TOKEN=abc123xyz（这个
WECHAT_TOKEN需与公众号后台填写的一致）
第二步：编写app.py核心逻辑
路由/wechat必须同时处理GET（微信Token验证）和POST（接收用户消息）两种请求。GET请求需用echostr、timestamp、nonce和token四者拼接SHA1校验；POST请求需解析XML中的MsgType和Content，仅对text类型调用MiniMax API。
第三步：配置公众号后台
登录微信公众号平台→开发管理→基本配置，把服务器地址填为https://your-domain.com/wechat（必须HTTPS），Token填abc123xyz，EncodingAESKey留空或自动生成，点击“提交”后微信会立即发起GET校验——若失败，检查Flask日志里是否打印出“signature check passed”。
升级为Agent Team处理复杂任务
单个Agent应付不了“先查订单→再判断是否超时→超时则自动补偿”的链路，这时必须启用Team模式，让多个Agent分工协作。
方法一：用Minimax桌面客户端快速组建（适合验证阶段）
下载安装agent.minimaxi.com客户端，登录后在首页右侧点击“Agent Team”→“新建Team”，添加两个Agent：
• 订单查询Agent（系统提示词：“从用户输入中精准提取16位数字订单号，只输出纯数字，无任何其他字符”）
• 补偿决策Agent（系统提示词：“若订单发货时间晚于承诺时间24小时，输出'补偿5元红包'；否则输出'暂无补偿'”）
设置执行顺序为“订单查询Agent → 补偿决策Agent”，保存后即可在聊天框中输入“订单1234567890123456发货了吗？”测试全流程。
方法二：用n8n搭建可视化工作流（适合生产环境）
部署n8n（Docker一键启动），添加HTTP Trigger节点接收微信消息→Function节点提取文本→两个HTTP Request节点分别调用两个Agent的API→最后用Set节点拼装最终回复XML。n8n会自动生成执行日志，每一步成功或失败都清晰可见，比硬编码更容易定位哪一环断了。
