更新智能体模板并验证现有实例
更新智能体模板后，请检查由该模板创建的现有实例。显示 智能体模板更新，实例需手动更新 的实例需要逐个编辑并保存；无论是否出现该提示，都应通过实例的实际使用方式验证变更结果。
修改智能体模板和修改共享能力实例可能影响不同范围。修改智能体模板后检查由该模板创建的实例；修改共享能力实例前确认引用范围。涉及生产环境时，先在独立测试实例中完成验证。
修改智能体模板配置
- 打开 智能体模板。
- 选择目标智能体模板，再选择 编辑。
- 在团队变更记录中保存准备修改的配置、变更前的值、预期结果和受影响的智能体实例。
- 修改 模型、系统提示词、工具权限、渠道配置或插件配置。
- 选择 保存修改。
对于生产智能体实例，先在独立测试或预发布实例中应用相同配置，并使用代表性输入验证预期回复、工具调用、能力访问和实际接入方式。测试通过后再处理生产实例。
识别需要更新的实例
打开 智能体实例，检查由已修改智能体模板创建的实例。
如果实例显示 智能体模板更新，实例需手动更新，请编辑并保存该实例，使实例按照智能体模板当前开放的参数重新应用配置。智能体模板保存成功不表示这些实例已经完成更新。
即使实例没有显示更新提示，生产变更后也应验证受影响的实例。更新提示不能代替对回复、工具、能力和实际接入方式的检查。
手动应用新配置
- 打开显示更新提示的智能体实例。
- 选择 编辑。
- 检查页面中显示的所有可配置参数，确认其值符合本次变更计划。
- 选择 保存修改。
- 返回实例列表或详情页，确认该实例不再显示更新提示。
- 在 Playground 中运行代表性输入，检查回复和预期的工具或能力调用。
- 检查 Trace，确认对应调用已经完成，并且没有非预期错误。
- 如果实例通过 API 或渠道提供服务，再完成一次代表性 API 调用或渠道消息往返。
如果多个生产实例使用同一智能体模板，完成一个实例的验证后再处理下一个。发现异常时停止后续更新，避免扩大影响范围。
处理共享能力配置变化
智能体模板的插件配置可以直接引用现有能力实例。多个智能体模板和智能体实例可能共享同一个 MCP、知识库组、记忆库、技能组或沙箱资源。修改共享资源前：
- 确认引用该资源的智能体模板和智能体实例。
- 在测试智能体实例中验证修改后的参数和实际运行结果。
- 通过受影响实例的实际接入方式检查回复、工具调用和能力访问。
- 确认所有目标实例均通过验证后，再完成生产变更。
不同能力类型需要分别验证资源准备和更新结果。不要仅根据智能体实例是否显示更新提示判断共享资源的影响范围。参见模板和实例如何影响资源。
恢复变更前的配置
如果验证失败，停止处理其余实例。根据变更记录，在智能体模板、智能体实例或共享能力资源中恢复变更前的值，保存后重新执行验证。控制台不提供一键回滚到历史版本的操作。
生产变更前至少记录：
- 准备修改的模型、系统提示词、参数和模板级审批处理规则。
- 智能体模板及各目标实例的能力引用。
- 代表性测试输入和预期结果。
- 与本次变更相关的渠道绑定和 Token 标识、负责人及状态。
不要在变更记录中保存 Token、渠道密钥或其他凭证的明文值。