已生成完整MiniMax Agent工程化模板：含目录结构、dotenv环境配置、@minimaxi/agent-core依赖验证、工具注册机制及CLI/HTTP双调试入口，确保ReActLoop正常运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要用Node.js快速生成一个可运行的MiniMax Agent项目，不是只写几行调用代码，而是包含完整目录结构、环境配置、核心Agent逻辑和本地测试能力的工程化模板。
初始化项目并安装核心依赖
在空文件夹中执行：npm init -y → 创建package.json → 运行npm install minimax-js-sdk @minimaxi/agent-core dotenv。
注意：必须使用@minimaxi/agent-core而非@minimax/agent，后者是旧版SDK，缺少ReActLoop和ToolRegistry支持，会导致后续工具调用失败。
安装完成后检查node_modules/@minimaxi/agent-core是否存在lib/loop.js文件，这是验证是否装对版本的关键依据。
配置MiniMax API密钥与基础环境
创建.env文件，写入：
MINIMAX_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxMINIMAX_GROUP_ID=g-xxxxxxxxxxNODE_ENV=development
【MINIMAX_GROUP_ID不可省略】——这是MiniMax控制台「项目管理」中新建的Group ID，不是用户ID或模型ID。漏填会导致403 Forbidden: group not found错误，且该错误不会在SDK报错信息中明确提示。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
在index.js顶部添加：require('dotenv').config();，确保环境变量加载早于任何SDK调用。
编写可运行的Agent核心逻辑
创建src/agent.js，内容如下：
第一步：导入必要模块
第二步：从环境变量提取MINIMAX_API_KEY和MINIMAX_GROUP_ID
第三步：实例化MinimaxAgent，传入{ model: 'mini-max-m2.5', temperature: 0.3 }
第四步：注册一个最简工具函数getSystemTime，返回new Date().toISOString()
第五步：调用agent.run("现在几点？")并打印结果
这一步操作起来很简单，直接把上面五步写进文件就能跑通。但要注意：工具函数必须用agent.registerTool显式注册，不能只定义函数；否则Agent会忽略工具调用请求，直接走LLM兜底回答。
添加本地调试与HTTP服务入口
方法一：命令行交互模式
在package.json的scripts中添加："dev": "node src/cli.js" → 新建src/cli.js，用readline监听用户输入 → 每次输入后调用agent.run(input)并输出响应。
方法二：启动HTTP服务
安装express → 创建server.js → 定义POST /chat接口 → 解析请求体中的message字段 → 调用agent.run(message) → 返回JSON格式响应。
运行node server.js后，用curl测试：curl -X POST http://localhost:3000/chat -H "Content-Type: application/json" -d '{"message":"你好"}'。
