一、操作场景
这里说明如何在购买 TencentDB Agent 实例后，手动配置接入飞书机器人。
二、前提条件
·已创建 TencentDB Agent 实例，且实例处于运行中状态。
·当前操作账号为该 TencentDB Agent 实例的 Owner。
·你已经拥有一个飞书账号。
三、步骤一：请阅读 TencentDB Agent 实例接入 Channel 的功能说明
具体说明请参见 接入 Channel 功能简介。
四、步骤二：获取飞书平台凭证
1. 登录 飞书开放平台，在顶部导航栏，单击开发者后台，单击创建企业自建应用，填写应用名称、描述，选择应用图标，单击创建。
2. 进入应用详情页，在左侧导航栏选择凭证与基础信息，在页面中找到 App ID 和 App Secret 两个参数，分别单击右侧，将其保存到个人记事本或备忘录中（注意数据安全，勿泄露），后续步骤中需要使用。
3. 在左侧导航栏选择添加应用能力，选择按能力添加页签，在机器人卡片中单击添加。
五、步骤三：在 TencentDB Agent 配置 Channel 接入
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏，选择 TencentDB Agent > 实例管理。
3. 找到目标实例，在实例卡片右上方 …，选择 Channel 接入。
4. 在弹出的 Channel 页面中，单击 + 接入 Channel。
5. 选择需要接入的 IM 类型：飞书。
在接入飞书 Channel 对话框中，填写以下参数：
| 参数 | 是否必填 | 说明 |
| Channel 名称 | 是 | 自定义名称，用于在多个 Channel 间进行辨识。建议命名方式：飞书-使用角色-企业自建应用名称，后续方便 Channel 与企业自建应用一一对应。示例：feishu-dba-testzm。 |
| 绑定的数据库智能体 | – | 自动继承自入口实例，不可修改。 |
| App ID | 是 | 获取步骤请参见 步骤二：获取飞书平台凭证。 |
| App Secret | 是 | 获取方案请参见 步骤二：获取飞书平台凭证。提交后通过 KMS 信封加密存储，回显时脱敏显示。示例：cli****。 |
参数填写完成后，单击添加并应用。
六、步骤四：配置飞书机器人并发布版本
1. 继续进入飞书开放平台，在左侧导航栏选择事件与回调，选择事件配置页签，在订阅方式右侧单击 ，订阅方式选择使用长连接接收事件，单击验证，显示连接成功后，单击保存。
注意：如果这一步报错，请检查 在 TencentDB Agent 配置 Channel 接入 中的 App ID 和 App Secret 是否已正确配置。
2. 在事件配置页面单击添加事件。
3. 在弹出的对话框中，搜索并添加 im.message.receive_v1，单击添加，单击确认开通权限。
添加完成后，在当前页面查看已添加的事件。
4. 选择回调配置页签，在订阅方式右侧单击 ，订阅方式选择使用长连接接收事件，单击验证，显示连接成功后，单击保存。
5. 在左侧导航栏选择权限管理，单击开通权限，在弹出的对话框中，搜索并添加 im:chat、im:message，单击确认开通权限。
确认开通完成后，可在页面查看已添加的权限。
6. 在左侧导航栏选择版本管理与发布，单击创建版本，在可用范围单击编辑，选择使用人员，单击确定。配置完成后单击保存。
7. 在弹出的对话框中单击确认发布。
若创建版本后，提示“企业管理员正在审核应用发布申请”，请根据以下情况处理：
·登录账号非管理员：请在飞书内部联系你所属组织/公司的管理员进行审核。
·登录账号为管理员：登录 飞书管理后台，在左侧导航栏选择工作台 > 应用审核，在应用列表对应的操作列单击审核，在弹出的页面右上方单击通过。
如果你想后续免审发布机器人，可单击设置审核规则，开启默认规则即可开启全员免审（蓝色为开启状态）。
七、使用机器人与 TencentDB Agent 对话
完成 Channel 接入后，你的团队成员即可在飞书中与 TencentDB Agent 实例对话。
| 场景 | 使用方式 |
| 私聊 | 在飞书中搜索并打开与该机器人的私聊窗口，直接发送消息即可触发响应，无需 @机器人。 |
| 群聊 | 1. 将机器人添加至目标飞书群（群设置 > 群机器人 > 添加机器人，选择已创建的自建应用）。2. 在群聊输入框中输入 @，从弹出列表中选择该机器人。3. 输入问题后发送。仅 @ 机器人的消息会触发响应，群内其他普通消息不会被处理。 |
八、创建定时任务结果投递
1. 登录 数据库 AI 服务控制台，在左侧导航栏选择 TencentDB Agent > 实例管理。
2. 单击目标实例卡片，在对话页面顶部工具栏，单击定时任务。
3. 在右侧弹框上方单击创建任务，按照以下参数配置定时任务。
| 参数 | 说明 |
| 任务名称 | 定时任务的名称，用于标识和区分不同任务。建议命名方式：任务场景描述-群聊名称/机器人名称，后续方便定时任务与机器人（个人）或群聊一一对应。示例：个人：每日健康巡检-testzm群聊：每日健康巡检-CDB 巡检 |
| 频率 | 任务执行的重复周期，执行频率支持每小时、每天、每周或每月重复。 |
| 执行时间 | 任务每次触发的具体时间点，格式为 HH:mm。 |
| 执行内容 | 任务执行的具体操作描述，即发送给 AI 的指令内容。 |
| 结果投递 | 任务执行结果的投递方式，选择发布到 Channel。 |
| Channel 类型 | 结果投递的渠道类型，选择飞书。 |
| 投递目标 | 结果投递的具体目标，请填写个人或群聊的 ID。获取方式：个人：进入与机器人的对话窗口，输入：我的个人用户 ID 是多少？以“ou_xxxx”的格式返回。群聊：进入群聊后 @机器人输入：当前群聊 ID 是多少？以“oc_xxxx”的格式返回。 |
4. 单击确定。
创建成功后，定时任务默认开启。
九、查看定时任务执行结果和报告
任务执行完成后，系统会将执行结果自动推送至已配置的投递目标，并支持下载详细报告。
·个人：机器人会直接输出定时任务执行结果。
·群聊：打开群聊，机器人会直接输出定时任务执行结果。
示例：群聊
十、相关操作
·接入 Channel 功能简介
·管理 Channel
·管理定时任务