腾讯云数据库 AI 服务 创建 TencentDB Agent 实例

一、背景信息

TencentDB Agent 是面向 DBA 团队的 AI Agent 运维平台，支持通过自然语言对话完成数据库诊断、巡检、慢查询分析等日常运维任务。每个 TencentDB Agent 实例对应一个独立的 AI DBA 助手，具备独立的 Skill（运维技能）和 SOUL（行为规范）。

TencentDB Agent 支持以下两种部署形态：

注意：说明：

核心概念说明：

二、实现机制

创建 TencentDB Agent 实例时，系统执行以下流程（以企业版独立部署为例；体验版实例部署在平台共享容器集群上，不会在你的账号下创建集群）：

1. 参数校验：校验实例名称合规性、地域可用区合法性、VPC/子网存在性。

2. 用户角色代建：自动创建默认全局只读角色 TencentDBAgent_AI_GlobalReadOnly，角色说明请参见 用户角色策略说明。

3. 集群创建/复用：在目标地域和 VPC 下创建或复用容器服务（TKE）集群。

4. Agent 部署：在容器服务集群中部署 AI 助手运行环境，加载 Skill 与 SOUL 配置。

5. 能力初始化：根据选择的配置方式（快速创建/模板/自定义）初始化 Skill 列表和 SOUL 内容。

6. 状态流转：实例状态从 creating 变更为 running，部署完成后用户可进入对话。

注意：说明：

注意：整个部署过程通常需要3 – 5分钟，期间实例状态为创建中，不可执行任何操作。

三、使用限制

四、注意事项

·企业版实例：系统将在你所选地域和网络下自动创建容器服务集群并部署 TencentDB Agent 实例，相关资源费用按腾讯云标准计费，集群创建后将持续运行产生费用。

·企业版实例的容器集群归属于你的腾讯云账号下自主管理，创建完成后可在容器服务控制台查看和运维；体验版实例部署在平台共享容器集群上，不占用你账号下的容器集群资源。

·首次创建实例时，系统将自动在你的账号下创建默认全局只读角色 TencentDBAgent_AI_GlobalReadOnly，TencentDB Agent 以该角色身份调用云 API，默认仅具备只读权限。

五、前提条件

·已拥有腾讯云账号，并完成实名认证。

·已被授予 QcloudDatabaseClawUserFullAccess 或 QcloudDatabaseClawAdminFullAccess CAM 策略。

·创建企业版实例时，需已在目标地域创建私有网络（VPC）和子网；体验版实例无需创建。如尚未创建，请参见 创建私有网络。

六、操作步骤

1. 登录 数据库 AI 服务控制台。

2. 在左侧导航栏选择 TencentDB Agent > 实例管理。

3. 单击创建 TencentDB Agent，进入创建页面。

4. 配置基础信息，参数说明如下。

5. 配置地域与网络，参数说明如下。

6. 选择能力配置方式，参数说明如下。

注意：说明：

注意：选择使用模板时，仅展示管理端已上架且对当前账号类型可见的模板。选择模板后将自动带出对应的 Skill 和 SOUL 配置。

7. 单击创建服务。

8. 阅读服务授权信息和安全承诺，单击同意并创建。

注意：说明：

注意：主账号或其任一子账号完成一次授权后，同账号下的其他子账号无需再次授权。

9. 创建成功后，页面将自动跳转至实例列表页面。新实例初始状态为创建中，待部署完成后自动切换为运行中。

七、TencentDBAgent_AI_GlobalReadOnly用户角色策略说明

首次创建实例时系统代建的默认全局只读角色TencentDBAgent_AI_GlobalReadOnly 绑定以下14条只读策略：

注意：说明：

八、后续步骤

·实例创建完成后，即可使用对话功能开始 AI 运维。

·如需为特定实例配置更高权限，请参见 管理用户角色。

九、相关操作

·管理 TencentDB Agent 实例

·使用对话功能

·管理用户角色

十、创建实例时提示权限不足怎么办？

请联系主账号管理员为你授予 QcloudDatabaseClawUserFullAccess（用户权限）或 QcloudDatabaseClawAdminFullAccess（管理员权限）CAM 策略。

十一、创建实例后可以更改地域吗？

不可以。地域和可用区在创建实例时确定，创建成功后不支持切换。如需更换地域，请新建实例。

十二、默认角色 TencentDBAgent_AI_GlobalReadOnly 的权限可以修改吗？

可以。如果对默认策略的资源范围或特定权限有调整需求，允许前往 CAM 控制台 自行修改该角色的策略。