34. 常用配置的维护与变更

完整版章节。内容按 2026.10 主线代码核对；具体入口以当前许可、账号权限和交付环境为准。

返回概览 · 完整版目录 · 下载完整 PDF

本章内容：本章面向租户管理员、系统管理员与运维人员，说明平台上线后如何安全地修改和维护配置：变更前后的通用检查与生效时机；常用对象的维护要点；流量规则的导出、导入与模板；热更新时延；修改记录与回退；变更审批；授权许可与品牌的维护。读完后，你可以按同一套方法完成任何一次配置变更，并在出错时退回。

34.1 变更前后的通用检查

适用场景：任何一次影响调用结果、成员可见范围或智能体行为的配置修改。

操作步骤

1. 记录变更对象、原因、影响范围、原值与预期结果。
2. 保存变更。流量规则保存时会弹出「确认变更」，逐项列出字段差异、关联对象与命中顺序的影响，核对无误后点「确认并应用」。
3. 用获授权的账号完成一次正向操作（模型调用、对话或智能体任务），再用未授权账号或不满足条件的请求验证拒绝结果，并在「运行总览 › 请求」确认真实结果。
4. 在「操作审计」或对象详情的「操作审计」页签核对操作人、对象、结果与时间（见第 32.7 节）。
5. 结果异常时改回原配置，保留请求 ID 与页面提示供排查。

生效时机参考

注意：以上是量级参考，不是承诺值。核对是否生效时，用一条最小请求在目标调用方下反复探测，而不是刷新页面看状态。

34.2 维护常用对象

适用场景：日常调整供应商、模型、模型分组、能力、组织或智能体，需要知道各自的维护要点。

注意：多个同类对象请使用能区分环境、用途与数据边界的名称，避免成员在模型广场、应用市场或智能体配置中选错。

34.3 导出、导入与规则模板

适用场景：流量规则的备份、评审、跨环境迁移，或从常用场景快速起步。

导出

1. 在「流量 › 流量规则 › 规则清单」右上角点「导出」。
2. 对话框列出已剔除敏感值的规则与字段，并提示「导入前请补齐这些字段；缺少必填值时将无法导入」。
3. 点「下载」，得到包含全部规则的 YAML 文件。

导入：点「从文件导入」选择 YAML 文件，补齐导出时被剔除的敏感值，按提示核对并保存。导入的规则同样经过配置检查与「确认变更」。

使用规则模板：点「导入规则模板」，从五十余条常用场景模板中选一条（按路径、请求头、模型、模型分组、数据来源、敏感信息、调用类型、时间窗、灰度、网段等条件，与转发、放行、拒绝等动作组合），填写高亮的必填字段后点「导入这条」。

注意

• 导出文件不含任何密钥明文，被剔除的位置以注释标明。
• 规则对模型、模型分组、上游、API 密钥、调用方等对象的引用以对象 ID 记录，文件不包含这些对象本身。跨环境导入前，先在目标环境建好同样的对象并改好引用；引用不存在时导入会失败。
• 导出导入只覆盖流量规则；模型供应商、模型、模型分组、告警规则、智能体等需在目标环境逐项配置，网关扩展可单独导出扩展包。

34.4 用「验证规则」做单次模拟

适用场景：想知道某个请求会被哪条规则命中，或验证某条规则改动是否符合预期。

操作步骤

1. 进入「流量 › 流量规则 › 验证规则」。
2. 手工填写调用类型、模型等字段，构造一次模拟请求。
3. 提交后查看命中结果与最终处置。

你会看到：页面给出这一次模拟请求会被哪条规则命中、执行什么动作。

注意：「验证规则」针对单次请求，不扫描全量规则。要了解配置全貌，按 34.1 的方法逐项核对关键规则，或导出 YAML 后离线审阅（见 34.3）。

34.5 热更新的生效时延与在途请求

适用场景：改完规则想立刻确认生效；或担心改配置会打断正在进行的流式回答。

操作步骤

1. 记下改动前的判定结果（例如用一条超限请求确认当前返回 413）。
2. 在「规则清单」中切换状态开关，或在编辑页保存并「确认并应用」。
3. 每隔几秒用同一请求探测一次，记录第一次出现新结果的时间。

你会看到

• 停用规则后，后续请求很快不再命中；重新启用后，从操作到新规则重新生效通常在 15～20 秒的量级。
• 在途的流式响应不会被打断：流进行中停用规则，这条流仍以正常的 finish_reason=stop 结束，客户端无需重试。

注意：一次改多条规则时，按最后一条生效的时间安排验证。不要在生效前反复点保存，那会让每次下发重新排队。

34.6 查看修改记录与回退

适用场景：确认某条规则改过几次、改了什么；或改错了需要退回之前的形态。

查看修改记录

1. 打开流量规则详情，点「修改记录」。
2. 列表按时间列出该规则的每一次新建、修改、启停与排序调整。
3. 点一行进入对应的操作审计详情，以「字段 / 变更前 / 变更后」三列对照（见第 32.7 节）。

你会看到：修改记录能准确回答「这条规则改过几次、每次改了什么、谁改的、什么时候」。

回退步骤

1. 先判断是否需要立即止血：需要时在规则清单中关闭该规则的状态开关，停用即时生效。
2. 在「修改记录」中打开目标版本对应的审计详情，记下「变更前」的值。
3. 点「编辑」，把这些字段改回目标值。
4. 保存并在「确认变更」中逐项核对差异，点「确认并应用」。
5. 用一条请求验证行为已恢复，并在「运行总览 › 请求」确认新记录符合预期。

注意

• 「载入此版本」用于在只读视图中查看历史版本内容，回退仍以编辑并重新保存为准。
• 模型、模型分组、可用范围、配额、智能体等对象没有版本回退，变更前请记录原值，必要时手工改回。
• 编辑复杂规则时，建议一次只改一类字段，改完先保存再做下一类，便于核对与回退。

34.7 变更审批

适用场景：确认哪些操作必须走审批、哪些配置变更由管理员直接生效。

入口：管理后台 › 护栏 › 审批中心 › 「策略」页签。

你会看到：可配置审批的动作包括发布技能、发布网页、发布到注册表、申请 API 密钥、发布插件到插件源、申请智能体 API 密钥、技能安装准入线。智能体执行中的工具审批在智能体的审批设置中配置（第 14 章）。

流量规则、模型、模型分组、模型供应商、护栏等配置变更不在审批清单中，在「确认变更 › 确认并应用」后立即生效。对这类变更，建议这样控制：

• 用「确认变更」的差异预览做事前控制，把预览内容留存到变更单或工单中；
• 用角色管理把关键配置的修改权收窄到少数账号（第 3 章）；
• 用操作审计做事后追溯，按「按操作筛选」定位资源类别，核对谁在何时改了什么；
• 多人协作时约定变更窗口，并在变更前后各留一条验证请求。

34.8 授权许可

适用场景：确认已开通的模块；导入、更新或移除许可。

前提：租户管理员账号；已从供应商取得签名的许可证文件。

操作步骤

1. 进入「管理后台 › 系统设置 › 全局设置 ›「授权许可」页签」。
2. 查看「高级模块」：模型护栏、动态路由、全链路审计、用量与成本、知识库，以及各自的开通状态。
3. 查看「授权状态」与「许可来源」：未导入许可时显示「社区版（未导入许可）」；已导入时显示「已导入商业许可」，以及授权对象、许可 ID 与导入时间。
4. 需要升级商业授权时，按页面「升级商业授权」的三步操作：选择授权绑定方式（「绑定安装实例」或「绑定加密钥匙」）后点「导出授权请求 (.json)」，交供应商换取签名许可，再点「导入 .lic 文件」。

你会看到：导入成功提示「许可导入成功」，各模块状态即时更新。授权状态可能为「授权有效」「社区版」「授权已到期，请续期」或「授权已到期」。

注意

• 许可按租户生效，导入与移除只影响当前租户；许可与部署绑定，开发、测试、生产等多套部署需要各自的许可证。
• 许可在本地验签，整个流程不需要访问互联网。
• 绑定加密钥匙的许可需要保持设备连接：拔出或检测过期会暂停授权，插回同一把钥匙后自动恢复；可在「加密钥匙」区点「重新检测」。
• 「移除许可」需在确认框中确认，移除后部署回落到无导入许可状态，对应模块的菜单与接口不再可用，基础功能不受影响。移除或更换许可前，先确认没有业务依赖相关模块，并在维护窗口内进行、提前通知使用者。
• 可选能力的安装与启用在平台控制台的「系统更新」中维护；许可未包含的能力显示「许可证未包含此能力」（见第 33.9 节）。

34.9 品牌与外观

适用场景：把控制台、工作台与登录页换成企业自己的名称、标识与主题色。

操作步骤

1. 进入「管理后台 › 系统设置 › 全局设置 ›「品牌与外观」页签」。
2. 在「产品显示名」填写显示的产品名称；在「标志」点「更换图片」上传标志图片；在「网站图标」点「更换」上传浏览器标签图标（可选，未设置时使用系统默认）。
3. 在「主题色」中选择色块。可选「经典蓝」「靛青」「紫罗兰」「青碧」「翠绿」「琥珀」「玫红」「石墨」八种，默认为「经典蓝」。选择后当前页面立即按所选颜色预览，此时设置尚未生效；未保存即离开页面时，预览还原为已保存的主题色。
4. 点「保存」。保存后产品显示名、标志、网站图标与主题色对本租户全部成员和登录页生效。
5. 需要清除自定义品牌时点「恢复默认」，在确认框中确认后，产品显示名、标志、网站图标和主题色一并恢复为系统默认（主题色回到「经典蓝」），并立即对本租户全部成员生效。未做过任何自定义时「恢复默认」不可选。

你会看到：保存后，产品名、标志、标签图标与主题色随之改变，登录页的标题、站点名与描述等信息同步更新。

注意

• 品牌配置对全租户生效，改动前先与业务方确认。
• 未登录用户打开登录页时，在地址后附加 ?tenantSlug=<租户标识> 即可显示对应租户的品牌；登录后按账号所属租户显示。
• 需要向成员发布维护通知时，使用「系统设置 › 通知横幅」。

能力说明

---

上一章：33. 平台运行与日常维护 · 下一章：35. 分阶段上线