操作场景
一、背景信息
·Skill 是 TencentDB Agent 的运维技能插件，决定了 AI 助手可以执行哪些运维操作。用户端可对已安装的 Skill 进行启用或禁用操作。TencentDB Agent 提供预置 Skill，详细说明请参见 预置 Skill 说明。
·SOUL 定义了 AI 助手的身份、行为准则和回答风格。用户端可微调当前实例的 SOUL 内容，修改仅影响当前实例，不影响管理端的 SOUL 模板。
二、实现机制
·Skill 启停：用户端的 Skill 启停操作修改的是实例级别的 Skill 配置（user_skill 表），不影响管理端全局 Skill 池。禁用 Skill 后，AI 助手在意图识别阶段不再将该 Skill 纳入候选匹配范围。
·SOUL 编辑：用户端编辑的 SOUL 内容存储在实例级别（覆盖从模板复制的初始内容），AI 助手在每次对话时加载实例级 SOUL 作为系统提示词。系统会自动在 SOUL 末尾注入安全红线规则，该部分对用户不可见、不可编辑。
三、使用限制
| 限制项 | 限制说明 |
| Skill 管理范围 | 用户端仅能启用或禁用已安装的 Skill，无法新增或删除。 |
| SOUL 内容大小 | 最大 100KB，支持 Markdown 格式。 |
| 安全红线 | SOUL 末尾的安全红线规则由系统自动注入，不可编辑。 |
四、注意事项
·禁用关键 Skill（如巡检、慢查询分析）将导致 AI 助手无法执行对应的运维任务。
·SOUL 内容直接影响 AI 助手的回答质量和行为边界，修改前建议与管理员确认。
·实例级 SOUL 修改不会同步回管理端模板，重新选择模板也不会自动覆盖已编辑的内容。
五、前提条件
已创建 TencentDB Agent 实例，且实例状态为运行中。
六、管理实例 Skill
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击 Skill。
5. 在 Skill 面板查看已安装的 Skill 列表，面板顶部显示统计摘要（总数、已启用数和禁用数）。
6. 通过开关启用或禁用 Skill。
·启用 Skill：开启开关后，AI 助手在对话中可调用该 Skill。
·禁用 Skill：关闭开关前，系统将弹出确认框提示禁用影响。禁用后 AI 助手将不再调用该 Skill。
注意：说明：
注意：用户端仅能启用或禁用已安装的 Skill，无法新增或删除 Skill。如需管理全局 Skill 池，请联系管理员在管理端操作，详见 管理 Skills。
七、自建 Skill
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击 Skill。
5. 在 Skill 列表底部单击自建 Skill。
6. 上传 Skill 包，解析成功后单击下一步。
Skill 包支持 .zip / .tar.gz 格式，最大50MB。
7. 单击确认导入。
新建的 Skill 默认为已启用状态。
八、从 SkillHub 导入
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击 Skill。
5. 在 Skill 列表底部单击从 SkillHub 导入。
6. 在弹出的对话框中浏览 Skill 市场，支持按分类（AI 智能、开发工具、效率提升、数据分析、内容创作、安全合规、通讯协作）和关键字搜索。
7. 在目标 Skill 所在行单击导入，确认无误后，单击确认导入。
注意：说明：
九、编辑实例 SOUL
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击 Soul。
5. SOUL 编辑弹窗中修改 SOUL 内容。SOUL 内容支持 Markdown 格式，最大100KB。
6. 单击保存，完成修改。
注意：说明：
十、后续步骤
SOUL 和 Skill 调整后，可通过 使用对话功能 验证效果。
十一、相关操作
·使用对话功能
·管理 Skills
·管理 SOUL
十二、对应的 API 接口
| API 名称 | 说明 |
| DescribeUserSkillList | 查询实例已安装的 Skill 列表。 |
| ModifyUserSkill | 修改实例 Skill 启用状态。 |
| DescribeInstanceSoul | 查看实例 SOUL 内容。 |
| ModifyInstanceSoul | 修改实例 SOUL 内容。 |
十三、Q1：用户端编辑 SOUL 后，管理端的 SOUL 模板会被修改吗？
不会。用户端对 SOUL 的编辑存储在实例级别，不影响管理端的 SOUL 模板。管理端模板变更也不会自动覆盖已有实例的 SOUL。
十四、Q2：禁用 Skill 后对正在执行的任务有影响吗？
禁用 Skill 后，新的对话请求将不再调用该 Skill。已在执行中的任务不受影响，会继续完成当前执行。