操作场景
实例模板用于将一套实例配置(Skill + SOUL)保存为快照,用户端创建实例时可直接选用模板,实现标准化创建。本文介绍如何新建、编辑和删除实例模板。
背景信息
实例模板是管理员为团队预设的标准化配置方案。模板分为预置模板与自定义模板:
预置模板(DBA 专家):系统开箱即用的标准化模板,默认绑定系统级预置 Skill 和预置 SOUL,开箱即用,不可编辑和删除。
自定义模板:由管理员根据团队实际运维需求自主创建、配置并发布的模板,支持编辑和删除。
用户端创建实例时选择使用模板方式,即可一键复用预设配置(包含绑定的预置 Skill 和预置 SOUL),无需逐一手动选择。
DBA 专家预置模板说明
系统预置模板 DBA 专家 是平台开箱即用的标准化模板,默认绑定了预置 SOUL 和预置 Skill,无需管理员额外配置。
关联 SOUL
DBA 专家模板默认关联预置 SOUL:DBA 专家助手。该 SOUL 定义了 AI 助手作为资深全引擎 DBA 的角色,覆盖 MySQL、分布式缓存数据库(兼容 Redis)、MongoDB、TDSQL-C、MariaDB、PostgreSQL、SQL Server 等腾讯云全线数据库产品。详细信息请参见 管理 SOUL。
关联 Skills
说明:
DBA 专家模板作为系统预置模板,具有以下特点:
默认绑定预置 SOUL(DBA 专家助手)和多项预置 Skill,开箱即用。
不可编辑、不可删除、不可禁用,持续为团队用户提供服务。
内置了严格的安全红线规则(DDL 禁止执行、破坏性操作永久禁止等),确保生产环境安全。
实现机制
模板的创建与使用流程如下:

模板快照:模板存储的是 Skill ID 列表和 SOUL ID 的引用关系,不存储实际内容。
实例创建时复制:用户选择模板创建实例时,系统读取模板引用的 Skill 和 SOUL 的当前内容,复制到实例级别。
模板与实例解耦:创建完成后,模板的后续修改或删除不影响已创建的实例。
使用限制
限制项 | 限制说明 |
模板名称长度 | 1-128个字符。 |
SOUL 要求 | 自定义模板必须关联一个已发布的 SOUL。 |
Skill 要求 | 自定义模板必须关联至少一个已启用的 Skill。 |
可见范围 | 当前版本模板对所有有创建实例权限的用户可见。 |
注意事项
模板引用的 Skill 或 SOUL 被禁用/删除后,模板仍可使用,但创建实例时对应的 Skill 将不会被安装。
建议定期检查模板引用的 Skill 和 SOUL 是否仍处于可用状态。
删除模板不可恢复,请确认不再需要后再执行删除。
系统预置模板(DBA 专家)由于默认绑定了高安全性的系统级预置 SOUL 和预置 Skill,因而不可编辑、不可删除。
前提条件
已被授予
QcloudDatabaseClawAdminFullAccess CAM 策略。操作步骤
查看模板列表
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 Database 实例 > 后台管理。
3. 选择能力配置 > 实例模板页面。
4. 页面以卡片形式展示所有模板,包括系统预置模板(DBA 专家)和自定义模板。每张卡片包含模板名称、模板类型标识、关联的 SOUL、关联的 Skill 数量信息和描述信息。
新建模板
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > 实例模板页面。
4. 在页面上方单击新建模板,在弹窗中填写以下信息。

参数 | 是否必填 | 说明 |
模板名称 | 是 | 1 - 128个字符,如慢查询诊断专家。 |
模板描述 | 否 | 描述模板适用场景。 |
SOUL 选择 | 是 | 从已发布的 SOUL 模板中选择一个 SOUL。 |
Skill 选择 | 是 | 单击添加技能,从已启用的 Skill 池中选择需要包含的 Skill(可多选)。 |
5. 单击确定,完成创建。
新建的实例模板默认为已开启状态,开启后用户端可见。创建 DatabaseClaw 实例时可选择使用模板创建。
启用/禁用模板
启用:单击模板卡片上的开关启用模板。启用后用户端创建或编辑实例时可选择该模板。
禁用:单击模板卡片上的开关禁用模板,阅读删除注意事项,确认无误后,单击确认禁用。禁用后新创建的实例不可选择该模板。
编辑/复制/删除模板
编辑:在模板卡片右下方单击
,单击编辑,修改模板的名称、描述或头像,修改完成后,单击确定。

复制:在模板卡片右下方单击
,单击复制,可复制已有模板的配置信息。

删除:在模板卡片右下方单击
,单击删除,阅读删除注意事项,确认无误后,单击确认删除。

注意:
仅自定义类型模板可编辑和删除。系统预置模板(DBA 专家)不可编辑、不可删除。
删除自定义模板后不可恢复。如仅需临时停用,建议使用禁用功能(系统预置模板不支持禁用,会持续且安全地向团队用户提供诊断和运维服务)。
相关操作
管理 SOUL
常见问题
删除模板后已基于该模板创建的实例会受影响吗?
不会。实例创建时已将模板中的 Skill 和 SOUL 配置复制到实例级别,删除模板仅影响后续新建实例时的模板选择列表。
模板可以设置可见范围吗?
当前版本模板对所有有创建实例权限的用户可见。