一、操作场景
这里说明如何在购买 TencentDB Agent 实例后，手动配置接入钉钉机器人。
二、前提条件
·已创建 TencentDB Agent 实例，且实例处于运行中状态。
·当前操作账号为该 TencentDB Agent 实例的 Owner。
·你已拥有一个钉钉账号，且具备在钉钉开放平台创建企业内部应用的权限。
三、步骤一：请阅读 TencentDB Agent 实例接入 Channel 的功能说明
具体说明请参见 接入 Channel 功能简介。
四、步骤二：获取钉钉凭证
钉钉凭证包括 Client ID 和 Client Secret，需在钉钉开放平台创建企业内部应用后获取。
1. 使用管理员账号登录 钉钉开发者平台。
2. 在顶部导航栏选择应用开发，在左侧导航栏选择企业内部应用 > 钉钉应用，单击创建应用。
注意：说明：
注意：若你已创建过企业内部应用，可直接选择目标应用，跳过创建步骤。
3. 填写应用名称、应用描述等基本信息，单击保存。
4. 在应用列表中单击目标应用，进入应用详情页。
5. 在左侧菜单选择基础信息 > 凭证与基础信息。在应用凭证区域，复制 Client ID 和 Client Secret，并妥善保存。
注意：说明：
注意：Client ID 即应用的 AppKey，Client Secret 即应用的 AppSecret。请确保应用已开通消息收发等所需权限，具体以钉钉开放平台的应用配置说明为准。
五、步骤三：在 TencentDB Agent 配置 Channel 接入
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏，选择 TencentDB Agent > 实例管理。
3. 找到目标实例，在实例卡片右上角单击 …，选择 Channel 接入。
4. 在弹出的 Channel 页面中，单击 + 接入 Channel。
5. 选择需要接入的 IM 类型：钉钉。
在接入钉钉 Channel 对话框中，填写以下参数：
| 参数 | 是否必填 | 说明 |
| Channel 名称 | 是 | 自定义名称，用于在多个 Channel 间进行辨识。建议命名方式：钉钉-使用角色-机器人名称，后续方便 Channel 与机器人一一对应。示例：dingtalk-dba-agenttest。 |
| 绑定的数据库智能体 | – | 自动继承自入口实例，不可修改。 |
| Client ID | 是 | 获取步骤请参见 步骤二：获取钉钉凭证。 |
| Client Secret | 是 | 获取步骤请参见 步骤二：获取钉钉凭证。提交后通过 KMS 加密存储，控制台回显时仅展示脱敏字符。 |
6. 参数填写完成后，单击添加并应用。
六、步骤四：配置钉钉机器人并发布版本
1. 在左侧导航栏选择添加应用能力，在机器人卡片中单击添加。
2. 打开机器人配置开关，配置机器人，注意消息接收模式一定要选 Stream 模式，配置完成后单击发布，确认无误后再次单击发布。
3. 在左侧导航栏选择权限管理，分别搜索 Card.Streaming.Write 和 Card.Instance.Write 权限并在操作列单击开通权限，或选择权限后单击批量申请。
4. 在左侧导航栏选择版本管理与发布，单击创建新版本。
5. 输入版本描述，选择机器人，设置应用可用范围，单击保存。
6. 在弹出的对话框中单击确认发布。
发布成功后展示如下。
七、使用机器人与 TencentDB Agent 对话
完成 Channel 接入后，你的团队成员即可在钉钉中与 TencentDB Agent 实例对话。
| 场景 | 使用方式 |
| 单聊 | 在钉钉中搜索并打开与该机器人的单聊窗口，直接发送消息即可，无需 @机器人。 |
| 群聊 | 1. 在钉钉中打开目标群聊，单击聊天窗口右上角的群设置图标。2. 单击机器人区域，单击添加机器人。3. 在搜索框中输入机器人名称，单击添加。4. 在群聊中 @ 该机器人并输入问题后发送。5. 仅 @ 机器人的消息会触发响应。 |
八、创建定时任务结果投递
1. 登录 数据库 AI 服务控制台，在左侧导航栏选择 TencentDB Agent > 实例管理。
2. 单击目标实例卡片，在对话页面顶部工具栏，单击定时任务。
3. 在右侧弹框上方单击创建任务，按照以下参数配置定时任务。
| 参数 | 说明 |
| 任务名称 | 定时任务的名称，用于标识和区分不同任务。建议命名方式：任务场景描述-群聊名称/机器人名称，后续方便定时任务与机器人（个人）或群聊一一对应。示例：个人：每日健康巡检-agenttestzm群聊：每日健康巡检-CDB 巡检 |
| 任务类型 | 任务的调度类型。支持以下两种：每隔：按固定间隔周期性执行，需设置执行间隔和单位（分钟/小时）。指定时间：仅在指定时间执行一次。Cron 表达式：配置任务的执行周期，遵循标准5段式 cron 语法。例如 0 9 * * * 表示每天 09:00 执行，还需选择时区。 |
| 执行内容 | 任务执行的具体操作描述，即发送给 AI 的指令内容。 |
| 结果投递 | 任务执行结果的投递方式，选择发布到 Channel，渠道类型，选择钉钉。结果投递的具体目标，请填写个人或群聊的 ID。获取方式：个人：进入与机器人的对话窗口，输入：我的个人 sender_id 是多少？群聊：进入群聊后 @机器人，输入：当前群聊 ID 是多少？以 “cidxxxx”的格式返回，以机器人返回结果为准。 |
4. 单击确定。
创建成功后，定时任务默认开启。
九、查看定时任务执行结果和报告
任务执行完成后，系统会将执行结果自动推送至已配置的投递目标，并支持下载详细报告。
·个人：机器人会直接输出定时任务执行结果。
·群聊：打开群聊，机器人会直接输出定时任务执行结果。
十、相关操作
·接入 Channel 功能简介
·管理 Channel
·管理定时任务