修改模型名称、推理参数或Prompt纯文本内容无需重新发布;但修改Schema契约定义或Prompt变量占位符结构必须重新发布,否则将导致ValidationError或HTTP 500错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Zion平台的函子(Functor)中修改模型配置后,是否需要重新发布取决于配置变更的类型和Zion当前的运行机制。
哪些模型配置变更不需重新发布
直接在Zion控制台的函子编辑页中修改以下三项,保存即刻生效,【无需触发重新发布流程】:
① 模型名称(如从 nano-banana-1 切换为 nano-banana-2);
② 温度(temperature)、top_p、max_tokens 等推理参数;
③ Prompt 模板中的纯文本内容(不含变量语法变动)。
这类变更由Zion运行时动态加载,底层调用的是同一套已部署的Agent执行器,仅刷新配置快照。若函子处于“已启用”状态,新请求会自动命中更新后的参数组合。
必须重新发布的模型配置场景
方法一:修改了函子的Schema契约定义
当你在YAML契约中增删字段、调整required列表、或变更zod校验规则(例如把 string() 改成 url()),Zion会检测到契约版本哈希值变化,强制要求重新发布。这一步不可跳过,否则运行时解析输出时会因Schema不匹配直接抛出ValidationError。
方法二:替换了Prompt中使用的变量占位符结构
比如原Prompt含 {{user_input}} 和 {{context}},你删掉后者并新增 {{history}}——即使只是改名,Zion也会判定输入契约断裂,拒绝热更新。
【注意】此时若强行保存不发布,函子将进入“配置异常”状态,所有调用返回HTTP 500且无有效错误提示,排查需查Zion后台日志。
验证配置是否已生效的快捷方式
打开函子详情页 → 点击「调试」→ 输入测试数据 → 查看右上角显示的「当前生效配置ID」(形如 cfg-7a3f9d2e)→ 对比你上次保存/发布的ID是否一致。
如果ID未变,说明刚做的修改未被接纳;如果ID已更新但结果异常,大概率是Schema或变量契约不兼容导致静默失败。











