MiniMax Agent工作流变量配置方法

这里有几个关键点别弄反了：变量需要先在workflow.json的根对象里通过variables字段声明，而且这个字段要放在nodes前面；如果要覆盖默认值，就用带MINIMAX_VAR_前缀的环境变量；到了节点内部，再通过{{key}}这种方式引用，同时别忘了把input_mapping里的映射关系配准确。

要在MiniMax Agent中让工作流动态读取不同环境下的参数（比如开发时连测试API、上线后自动切正式地址），必须正确配置工作流变量，否则每次改环境都要手动编辑JSON或重写提示词。

在工作流JSON中声明变量

打开工作流定义文件（如workflow.json），在根对象下添加variables字段。

填写一个键值对结构，例如{"api_base_url": "https://test.api.example.com/v1", "timeout_ms": 5000}。

这一步必须放在"nodes"数组之前，否则MiniMax Agent启动时会忽略该声明，

。

保存后重新加载工作流，变量即刻生效，无需重启Agent服务。

通过环境变量覆盖工作流变量

当同一套工作流需在多台机器上运行不同配置时，优先使用环境变量方式覆盖，避免修改源文件。

方法一：先在 Linux/macOS 的终端里执行

，把这个环境变量设好，然后再启动 Agent 进程。

方法二：Windows PowerShell中运行$env:MINIMAX_VAR_timeout_ms="8000"，然后双击启动脚本。

注意：环境变量名必须以MINIMAX_VAR_为前缀，且后续部分与workflow.json中声明的变量名完全一致（大小写敏感）。

在节点内引用变量

第一步：进入任意Node的parameters配置项（如HTTP Request节点的url字段）。

第二步：输入{{api_base_url}}/users/{{user_id}}，其中api_base_url来自variables声明，user_id可来自上游节点输出。

第三步：确保该Node的input_mapping中已将user_id字段映射为有效路径，例如{"user_id": "$.trigger.payload.id"}。

若未做input_mapping而直接写{{user_id}}，运行时会报错“variable not found”，且不会 fallback 到空字符串。