必须在workflow.json根对象中variables字段声明变量且置于nodes前，再通过MINIMAX_VAR_前缀环境变量覆盖，节点内用{{key}}引用并确保input_mapping正确映射。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在MiniMax Agent中让工作流动态读取不同环境下的参数（比如开发时连测试API、上线后自动切正式地址），必须正确配置工作流变量，否则每次改环境都要手动编辑JSON或重写提示词。
在工作流JSON中声明变量
打开工作流定义文件（如workflow.json），在根对象下添加variables字段。
填写一个键值对结构，例如{"api_base_url": "https://test.api.example.com/v1", "timeout_ms": 5000}。
这一步必须放在"nodes"数组之前，否则MiniMax Agent启动时会忽略该声明，【variables字段位置错误将导致所有变量无法注入】。
保存后重新加载工作流，变量即刻生效，无需重启Agent服务。
通过环境变量覆盖工作流变量
当同一套工作流需在多台机器上运行不同配置时，优先使用环境变量方式覆盖，避免修改源文件。
方法一：Linux/macOS终端中执行export MINIMAX_VAR_api_base_url="https://prod.api.example.com/v1"，再启动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 到空字符串。
