MiniMax Agent代码生成工作流配置操作步骤

需配置完整工作流链路：创建绑定M2.5模型的Agent实例→启用Code Generator与File System Writer工具→本地CLI对接验证→提交明确技术约束的生成指令，缺一不可。

用MiniMax Agent自动生成可运行的前后端代码，需要配置完整的工作流链路，而不是只填个API密钥就完事。你得让Agent理解任务边界、调用正确工具、生成结构化输出、并支持本地调试验证——漏掉任一环节，生成的代码可能缺路由、少依赖、跑不起来。

创建Agent实例并绑定M2.5模型

这一步决定后续所有代码生成的质量基线。MiniMax M2.5是当前唯一支持完整工具调用+结构化输出的代码专用模型，abab6.5-chat等对话模型无法可靠触发代码生成功能。

登录Minimax开发者控制台→进入「Agent」模块→点击「创建Agent」→模板类型选「通用对话型」→在系统提示词框中粘贴以下内容：

你是一个全栈开发智能体，专精React + TypeScript前端 + Supabase后端架构。每次响应必须包含三部分：1）自然语言说明；2）JSON格式的文件清单（含路径、用途、是否必需）；3）可直接保存为文件的完整代码块。禁止生成伪代码或省略import语句。

Model name必须设为【MiniMax-M2.5】，不是abab6.5-chat，也不是M2。该字段错误会导致工具调用失败，且控制台不报错，只返回空响应。

配置工具集启用代码生成能力

Agent默认不带任何工具，必须手动添加「Code Generator」和「File System Writer」两个核心插件，否则它连“生成一个package.json”都做不到。

方法一：在Agent配置页点击「添加工具」→搜索「Code Generator」→启用→设置参数：language=typescript, framework=react, backend=supabase；

方法二：同页面继续添加「File System Writer」→勾选「允许写入本地磁盘」→指定根目录为./output（注意路径末尾不能有斜杠）；

【关键提醒】两个工具必须同时启用，且顺序不能颠倒——Code Generator必须在File System Writer之前执行，否则生成的代码不会落地为文件。

本地CLI环境对接Agent ID

终端里执行以下命令链，把云端Agent能力映射到本地开发流：

第一步：安装Minimax CLI工具：npm install -g @minimax/cli；

第二步：登录并绑定项目：minimax login --api-key sk-xxx --group-id g-yyy；

第三步：关联Agent实例：minimax agent link --agent-id agt_zzzzzz --alias jay-site；

第四步：验证连通性：minimax agent run jay-site --prompt "生成首页组件，含轮播图和歌曲列表"；

如果返回结果里出现"file_path": "src/components/HomePage.tsx"且代码块语法高亮正常，说明工作流已打通。若卡在“正在思考…”超30秒，大概率是Agent配置页没启用工具或模型名填错。

触发真实代码生成任务

现在可以提交生产级指令了。不要用模糊描述，必须明确技术约束：

在终端输入：minimax agent run jay-site --prompt "创建周杰伦歌曲 ，要求：1) 前端用React+TS，路由分Home/Login/Member三页；2) 后端用Supabase，含用户认证、支付状态查询API；3) 输出所有文件，包括supabase/migrations/和src/api/下的完整代码"；

Agent会先输出JSON格式的任务分解计划，确认无误后按Enter继续；

生成过程自动调用Code Generator生成代码→File System Writer写入./output目录→CLI自动执行npm install && npx supabase start验证依赖与数据库服务；

最后输出本地预览地址：http://localhost:3000，直接打开浏览器即可看到可交互 。