可通过四种方式设置Agent默认参数:一、Agent编辑页配置字段级默认值;二、JSON Schema声明default属性;三、环境变量注入全局参数;四、上下文变量传递会话级参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在多次调用同一Agent时反复输入相同参数(如固定API端点、默认语言、预设用户角色等),则可通过设置默认参数避免重复操作。以下是实现该目标的多种配置路径:
一、在Agent编辑页配置字段级默认值
该方法适用于静态、确定性参数,如固定URL、枚举型状态、默认时间偏移量等,直接在参数定义层绑定初始值,新调用时自动填充且支持手动覆盖。
1、进入MuleRun控制台,导航至目标Agent的编辑页面。
2、在“输入参数”区域找到需设默认值的字段(如base_url),点击其右侧的铅笔图标进入编辑。
3、勾选“启用默认值”,在输入框中填入https://api.example.com/v2或zh-CN等具体值。
4、若字段类型为布尔型,下拉选择true或false;若为数字型,直接输入30等整数。
5、保存Agent配置后,所有后续调用该Agent的表单中,该字段将预填所设值,用户可随时修改。
二、通过JSON Schema声明required与default属性
该方法面向结构化输入(如Webhook接收的JSON载荷),利用标准Schema语法强制字段存在性并赋予默认值,运行时由MuleRun引擎自动注入,无需前端干预。
1、在Agent设置页切换至“高级配置”标签,定位“输入Schema定义”文本域。
2、粘贴符合Draft-07规范的Schema片段,其中包含"default"关键字,例如:
{ "type": "object", "properties": { "timeout_sec": { "type": "integer", "default": 60 }, "retry_count": { "type": "integer", "default": 3 } } }
3、点击“验证Schema语法”按钮确认无误,确保default字段未被标记为"required"(二者逻辑互斥)。
4、启用“强制Schema校验”开关并保存,此后缺失字段将按Schema默认值补全,完整JSON输入始终满足结构约束。
三、利用环境变量注入全局默认参数
该方法适用于跨多个Agent复用的统一配置项,如认证密钥、服务域名、灰度开关等,修改一次即全局生效,避免逐个维护。
1、进入MuleRun控制台左侧导航栏,点击“环境配置”。
2、在“自定义变量”区域点击“新增变量”,输入变量名API_TIMEOUT,值设为120;再添加SERVICE_ENV,值设为prod。
3、返回各Agent脚本中,在DataWeave表达式内引用vars.API_TIMEOUT或vars.SERVICE_ENV,无需重复声明。
4、当需切换测试环境时,仅需在环境配置中将SERVICE_ENV改为staging,所有引用该变量的Agent立即生效。
四、使用上下文变量传递会话级默认值
该方法适用于单次会话内多步骤联动场景,如用户首次输入客户ID后,后续所有子任务自动继承该ID作为查询依据,避免每步重复填写。
1、在流程起始节点(如HTTP触发器)后插入“Set Variable”操作,变量类型选context,名称设为customer_id,值设为payload.customer_code。
2、在后续任意节点的参数配置中,点击输入框右侧的变量图标,从上下文变量列表中选择context.customer_id。
3、确认该变量在流程图中未被同名覆盖,且生命周期覆盖全部依赖节点。
4、执行该流程时,只要首步传入customer_code,后续所有含customer_id参数的节点将自动填充对应值。

















