更新智能体模板并验证现有实例
更新智能体模板后，请检查由该模板创建的现有实例。显示 智能体模板更新，实例需手动更新 的实例需要逐个编辑并保存；无论是否出现该提示，都应通过实例的实际使用方式验证变更结果。
修改智能体模板和修改共享能力实例可能影响不同范围。修改智能体模板后检查由该模板创建的实例；修改共享能力实例前确认引用范围。涉及生产环境时，先使用独立的测试智能体模板和实例完成验证，避免测试时的模板重启影响正式服务。
修改智能体模板配置
在模板中修改默认设置，再通过测试实例验证。更新前记录原来的值，便于验证失败时恢复。
打开 智能体模板。
选择目标智能体模板，再选择 编辑。
在团队变更记录中保存准备修改的配置、变更前的值、预期结果和受影响的智能体实例。
修改 模型、系统提示词、文件系统、Todo、压缩方式、容错配置、工具权限、渠道配置或插件配置。
为已有模板添加技能组时，同时在 文件系统 中开启 启用文件系统，并保留
read_file。只需读取 Skill 和参考文件时，建议选择 仅只读。选择 保存修改。
对于生产智能体实例，先在独立的测试或预发布智能体模板和实例中应用相同配置，并使用代表性输入验证预期回复、工具调用、能力访问和实际接入方式。测试通过后再处理生产实例。
识别需要更新的实例
打开 智能体实例，检查由已修改智能体模板创建的实例。
如果实例显示 智能体模板更新，实例需手动更新，请编辑并保存该实例，使实例按照智能体模板当前开放的参数重新应用配置。智能体模板保存成功不表示这些实例已经完成更新。
即使实例没有显示更新提示，生产变更后也应验证受影响的实例。更新提示不能代替对回复、工具、能力和实际接入方式的检查。
手动应用新配置
修改了能力模板时，先编辑并保存引用它的智能体模板，再执行以下操作。编辑并保存智能体实例时，由能力模板生成的 MCP、mem0 记忆库、知识库组、技能组和沙箱配置也会按当前模板和实例参数重新应用。更新前记录这些资源的 ID 和必要配置；直接改过的生成资源配置可能被覆盖。直接关联的已有能力实例保持引用关系，按共享资源的变更流程处理。
打开需要应用新配置的智能体实例。只修改能力模板时，实例不一定显示更新提示。
选择 编辑。
检查页面中显示的所有可配置参数，确认其值符合本次变更计划。
模板开放容错配置后，实例可以保存自己的整份超时、重试和备用模型设置。检查实例回填的所有项，避免保留不符合本次变更的旧值。参见调整实例容错设置。
选择 保存修改。
返回实例列表或详情页，检查更新提示，再逐项核对关联能力资源的实际配置。保存成功后仍应确认每项能力均符合预期。
返回 智能体模板，对来源模板选择 重启，让运行中的实例重新读取已更新的配置。
注意
重启会影响同一模板下的多个实例
操作前确认受影响的实例，并安排好变更时间。需要先验证再逐步上线时，使用独立的测试模板和实例。重启不会重新生成能力资源，不能替代前面的实例保存。
按测试智能体实例选择网页版对话中的目标实例，运行代表性输入，检查回复和预期的工具或能力调用。
检查 Trace，确认对应调用已经完成，并且没有非预期错误。
如果实例通过 API 或渠道提供服务，再完成一次代表性 API 调用或渠道消息往返。
不要只凭重启成功判断配置已经全部更新。若某项能力仍使用旧值，先检查该能力的来源模板、实例参数和关联资源，再重新应用配置并测试；发现不一致时暂停更新其他生产实例。
修改以下配置时，还应完成对应检查：
- 文件系统：核对选中的文件工具，并分别测试读、写边界。选择只读工具预设会移除写入和编辑工具，但不能代替外部数据源的授权。
- Skill：确认文件系统已开启且保留了
read_file；更新目标实例后，用代表性请求检查它是否成功读取目标SKILL.md，不能只确认技能组已经关联。 - Todo：确认模型可以在当前任务中列出、更新和完成步骤。例如，把“收集输入、处理数据、检查结果”列成三步并逐项更新。如果开始新会话后仍要保留进度，或需要系统自动继续执行后续步骤，请交给组织已有的工单或工作流系统。
- 上下文压缩：开启后，智能体使用主模型自动摘要长会话。保存模板并更新测试实例后，用固定长会话检查事实保留、工具连续性和用量，再更新生产实例。
- 容错配置：已有模板显示的默认容错不会自动刷新旧运行实例，仍需编辑并保存实例。在测试环境验证超时、重试和备用模型，涉及业务写入时检查是否有重复操作。参见应用容错配置并验证。
- 工具权限：分别验证拒绝、自动批准和人工审批。没有规则、默认处理为未指定且未开启生成审批描述时，人工审批关闭；仅开启生成审批描述也会启用工具权限处理。
如果多个生产实例使用同一智能体模板，先确认本次需要更新的实例和模板重启的影响范围。保存目标实例后，安排模板级重启，并逐个验证受影响实例。需要分阶段上线时，使用独立的模板和实例；只更新一个实例不能隔离模板级变更。
处理共享能力配置变化
智能体模板的插件配置可以直接引用现有能力实例。多个智能体模板和智能体实例可能共享同一个 MCP、知识库组、记忆库、技能组或沙箱资源。修改共享资源前：
- 确认引用该资源的智能体模板和智能体实例。
- 在测试智能体实例中验证修改后的参数和实际运行结果。
- 通过受影响实例的实际接入方式检查回复、工具调用和能力访问。
- 确认所有目标实例均通过验证后，再完成生产变更。
不同能力类型需要分别验证资源准备和更新结果。修改共享 MCP 地址、Header 或知识库组检索配置后，重新保存引用它的智能体模板，并按应用新配置更新、重启和验证；不能只凭共享资源保存成功，就认定运行中的智能体已经使用新值。参见模板和实例如何影响资源。
恢复变更前的配置
如果验证失败，停止处理其余实例。根据变更记录，在智能体模板、智能体实例或共享能力资源中恢复变更前的值，保存后重新执行验证。控制台不提供一键回滚到历史版本的操作。
生产变更前至少记录：
- 准备修改的模型、系统提示词、文件系统、Todo、压缩方式、容错设置、参数和智能体级工具权限规则。
- 智能体模板及各目标实例的能力引用。
- 代表性测试输入和预期结果。
- 与本次变更相关的渠道绑定和 Token 标识、负责人及状态。
不要在变更记录中保存 Token、渠道密钥或其他凭证的明文值。