一、背景信息
实例模板是管理员为团队预设的标准化配置方案。模板分为预置模板与自定义模板:
·预置模板(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 专家模板预置安装了多项高频核心 Skill,完整 Skill 列表及说明请参见 预置 Skill 说明。
注意:说明:
注意:DBA 专家模板作为系统预置模板,具有以下特点:
五、实现机制
模板的创建与使用流程如下:
·模板快照:模板存储的是 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. 在左侧导航栏选择 TencentDB Agent > 后台管理。
3. 选择能力配置 > 实例模板页面。
4. 在页面上方单击新建模板,在弹窗中填写以下信息。
| 参数 | 是否必填 | 说明 |
| 模板名称 | 是 | 1 – 128个字符,如慢查询诊断专家。 |
| 模板描述 | 否 | 描述模板适用场景。 |
| SOUL 选择 | 是 | 从已发布的 SOUL 模板中选择一个 SOUL。 |
| Skill 选择 | 是 | 单击添加技能,从已启用的 Skill 池中选择需要包含的 Skill(可多选)。 |
5. 单击确定,完成创建。
新建的实例模板默认为已开启状态,开启后用户端可见。创建 TencentDB Agent 实例时可选择使用模板创建。
十一、启用/禁用模板
·启用:单击模板卡片上的开关启用模板。启用后用户端创建或编辑实例时可选择该模板。
·禁用:单击模板卡片上的开关禁用模板,阅读删除注意事项,确认无误后,单击确认禁用。禁用后新创建的实例不可选择该模板。
十二、编辑/复制/删除模板
·编辑:在模板卡片右下方单击,单击编辑,修改模板的名称、描述或头像,修改完成后,单击确定。
·复制:在模板卡片右下方单击,单击复制,可复制已有模板的配置信息。
·删除:在模板卡片右下方单击,单击删除,阅读删除注意事项,确认无误后,单击确认删除。
十三、相关操作
·管理 Skills
·管理 SOUL
·创建 TencentDB Agent 实例
十四、删除模板后已基于该模板创建的实例会受影响吗?
不会。实例创建时已将模板中的 Skill 和 SOUL 配置复制到实例级别,删除模板仅影响后续新建实例时的模板选择列表。
十五、模板可以设置可见范围吗?
当前版本模板对所有有创建实例权限的用户可见。