一、背景信息
TencentDB Agent 实例是 AI DBA 助手的运行载体。每个实例拥有独立的 Skill 配置和 SOUL 配置。实例的生命周期由用户自主管控,支持隔离(暂停服务)、重启(恢复异常)和下线(终止服务)三种管理操作。
二、实现机制
TencentDB Agent 实例的生命周期状态机制如下。
·隔离操作:暂停实例的所有服务,实例配置数据完整保留,可随时解除隔离恢复服务。
·重启操作:重新初始化实例的 AI 助手运行环境,用于恢复实例异常状态。
·下线操作:永久终止实例服务,并清除实例的全部配置与关联数据。
三、使用限制
| 限制项 | 限制说明 |
| 实例搜索 | 支持按实例名称或实例 ID 进行模糊搜索。 |
| 状态筛选 | 支持按全部、运行中、创建中、已隔离、异常五种状态筛选。 |
| 下线操作 | 下线为终态操作,执行后不可恢复。 |
四、注意事项
·隔离实例后,该实例将暂停所有服务,但配置信息保留,可随时解除隔离恢复服务。
·下线实例后,所有配置(Skill、SOUL、定时任务等)和历史会话记录将被永久清除,操作不可恢复。
·每个管理操作均需二次确认,请仔细核对操作对象后再确认执行。
五、前提条件
·已创建至少一个 TencentDB Agent 实例。如尚未创建,请参见 创建 TencentDB Agent 实例。
·已被授予 QcloudDatabaseClawUserFullAccess 或 QcloudDatabaseClawAdminFullAccess CAM 策略。
六、查看实例列表
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 实例管理。
3. (可选)在实例管理页面,搜索和筛选实例。
·在实例管理页面顶部的搜索栏中,输入实例名称或实例 ID 进行搜索。
·单击状态筛选下拉框,按全部、运行中、创建中、已隔离、异常筛选实例。
4. 查看 TencentDB Agent 实例。
页面顶部展示当前地域及实例数量。你可以通过地域选择器切换查看不同地域的实例。
每个实例卡片展示以下信息:
| 参数 | 说明 |
| 实例名称 | 实例的自定义名称。 |
| 实例状态 | 实例当前运行状态,包括创建中、运行中、已隔离、异常、重启中和已下线。创建中:实例正在创建,尚未就绪。此状态下不可执行任何操作。运行中:实例正常运行,可接受对话请求。已隔离:用户主动隔离实例,暂停所有服务。实例配置保留,可随时解除隔离恢复服务。异常:实例运行异常(Agent 崩溃、连接中断等)。可执行重启或重新安装操作。重启中:实例正在进行重启操作,重启完成后将恢复运行。已下线:实例已下线,不可服务。为终态,实例将从列表移除。 |
| 实例 ID | 实例的唯一标识,格式为 clawins-xxxxxxxx,如 clawins-y5bv7133。 |
| 地域 | 实例所在地域,如广州。 |
| 描述 | 实例的描述信息。 |
| 最近活跃 | 实例最近一次活跃的时间信息。 |
| 创建时间 | 实例的创建时间。 |
七、体验版多实例选择
体验版仅支持保留1个存活实例。若你的账号下出现多个存活实例(如计费规则调整等历史原因),系统将在实例管理页面顶部展示通知横幅,提示你在1天内选择要保留的实例,其余实例将被隔离。
1. 在通知横幅中单击去选择,进入实例选择页面。
2. 在实例选择页面,查看各实例的对比信息(实例名称、实例 ID、地域、创建时间、最近活跃时间、状态),选择要保留的实例并确认。
3. 完成选择后,通知横幅将更新为已选择保留的实例及剩余实例的处理提示。
八、进入对话
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 实例管理。
3. 在实例管理页面,单击目标实例卡片,即可进入该实例的对话页面。
九、编辑/隔离/重启/下线实例
·编辑实例信息:在实例卡片右上方单击,单击编辑信息,修改实例名称或描述信息,修改完成后单击确定。
·隔离实例:在实例卡片右上方单击,单击隔离,在二次确认弹窗中,阅读隔离实例注意事项,确认无误后,单击隔离实例。
操作成功后,实例状态变为已隔离。
·重启实例:在实例卡片右上方单击,单击重启,在二次确认弹窗中,阅读重启实例注意事项,确认无误后,单击重启实例。
·下线实例:在状态为已隔离的实例卡片右上方单击,单击下线,在二次确认弹窗中,阅读下线注意事项,确认无误后,单击下线实例。
十、后续步骤
实例运行正常后,可 使用对话功能 开始 AI 运维。
十一、相关操作
·创建 TencentDB Agent 实例
·接入 Channel
·使用对话功能
十二、实例状态为“异常”该怎么办?
可尝试通过操作菜单执行重启操作恢复实例。如重启后仍为异常状态,请检查实例所在 VPC 网络是否正常,或联系技术支持。
十三、下线实例后数据会保留吗?
不会。下线操作为终态,实例的所有配置(Skill、SOUL、定时任务等)和历史会话记录将被永久清除,操作不可恢复。
十四、隔离和下线有什么区别?
隔离是暂停服务,实例配置保留,可随时解除隔离恢复;下线是终止服务,所有数据永久清除,不可恢复。