操作场景
实例模板用于将一套实例配置（Skill + SOUL）保存为快照，用户端创建实例时可直接选用模板，实现标准化创建。本文介绍如何新建、编辑和删除实例模板。
背景信息
实例模板是管理员为团队预设的标准化配置方案。每个模板包含一组 Skill 和一个 SOUL 配置，用户端创建实例时选择使用模板方式，即可一键复用管理员预设的配置，无需逐一手动选择。
实现机制
模板的创建与使用流程如下：
模板快照：模板存储的是 Skill ID 列表和 SOUL ID 的引用关系，不存储实际内容。
实例创建时复制：用户选择模板创建实例时，系统读取模板引用的 Skill 和 SOUL 的当前内容，复制到实例级别。
模板与实例解耦：创建完成后，模板的后续修改或删除不影响已创建的实例。
使用限制
限制项 | 限制说明 |
模板名称长度 | 1-128字符。 |
SOUL 要求 | 模板必须关联一个已发布的 SOUL。 |
Skill 要求 | 模板必须关联至少一个已启用的 Skill。 |
可见范围 | 当前版本模板对所有有创建实例权限的用户可见。 |
注意事项
模板引用的 Skill 或 SOUL 被禁用/删除后，模板仍可使用，但创建实例时对应的 Skill 将不会被安装。
建议定期检查模板引用的 Skill 和 SOUL 是否仍处于可用状态。
删除模板不可恢复，请确认不再需要后再执行删除。
前提条件
已被授予
QcloudDatabaseClawAdminFullAccess CAM 策略。已创建至少一个 SOUL 和一个已启用的 Skill。
操作步骤
查看模板列表
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 Database 实例 > 后台管理。
3. 选择能力配置 > 实例模板页面。
4. 页面以卡片形式展示所有模板，每张卡片包含模板名称、关联的 Skill 数量和描述信息。
新建模板
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 Database 实例 > 后台管理。
3. 选择能力配置 > 实例模板页面。
4. 在页面上方单击新建模板，在弹窗中填写以下信息。
参数 | 是否必填 | 说明 |
模板名称 | 是 | 1 - 128个字符，如 MySQL 生产运维模板。 |
模板描述 | 否 | 描述模板适用场景。 |
SOUL 选择 | 是 | 从已发布的 SOUL 模板中选择一个 SOUL。 |
Skill 选择 | 是 | 单击添加技能，从已启用的 Skill 池中选择需要包含的 Skill（可多选）。 |
5. 单击确定，完成创建。
新建的实例模板默认为已开启状态，开启后用户端可见。创建 DatabaseClaw 实例时可选择使用模板创建。
启用/禁用模板
启用：单击模板卡片上的开关启用模板。启用后用户端创建或编辑实例时可选择该模板。
禁用：单击模板卡片上的开关禁用模板，阅读删除注意事项，确认无误后，单击确认禁用。禁用后新创建的实例不可选择该模板。
编辑/复制/删除模板
编辑：在模板卡片右下方单击
复制：在模板卡片右下方单击
删除：在模板卡片右下方单击
注意：
仅自定义类型模板可编辑和删除，系统预设模板不可编辑、不可删除。
删除模板后不可恢复。如仅需临时停用，建议使用禁用功能。
相关操作
管理 Soul
常见问题
删除模板后已基于该模板创建的实例会受影响吗？
不会。实例创建时已将模板中的 Skill 和 SOUL 配置复制到实例级别，删除模板仅影响后续新建实例时的模板选择列表。
模板可以设置可见范围吗？
当前版本模板对所有有创建实例权限的用户可见。
