腾讯云数据库 AI 服务 接入 Webhook

TencentDB Agent 的 Webhook 能力用于定时任务结果投递:定时任务执行完成后,系统将执行结果以 HTTP POST 请求方式推送至你指定的 Webhook 地址。Webhook 地址可以指向企业微信、飞书、钉钉的群机器人,也可以指向任意支持接收 HTTP 回调的自有系统(如告警平台、工单系统、值班系统等)。

相关产品
腾讯云数据库 AI 服务 产品页,含版本规格、价格与购买入口。

一、操作场景

注意:说明:

注意:Webhook 不是独立的 Channel 接入类型,而是在创建定时任务时配置的“结果投递”方式之一。Channel 仅支持接入飞书、企业微信、钉钉三种 IM 机器人,用于双向对话;Webhook 仅用于定时任务执行结果的单向推送,无法用于 IM 对话。

二、前提条件

·已创建 TencentDB Agent 实例,且实例处于运行中状态。

·当前操作账号为该 TencentDB Agent 实例的 Owner。

·已准备一个可公网访问、支持接收 HTTP POST 请求的 Webhook 地址。

三、配置方式

Webhook 结果投递在创建或编辑定时任务时配置,操作入口与完整步骤请参见 管理定时任务。核心配置如下:

1. 在定时任务配置的“结果投递”中,选择 Webhook。

2. 填写接收执行结果的 Webhook 地址。

3. 保存时,系统自动校验地址格式并发送连通性探测请求,校验通过后方可保存成功。

四、消息体格式

系统会根据 Webhook 地址自动识别目标平台类型,并按该平台的标准格式构造消息体:

·企业微信:识别到 qyapi.weixin.qq.com 域名后,按企业微信群机器人格式推送。

·飞书:识别到 open.feishu.cn 域名后,按飞书群机器人格式推送。

·钉钉:识别到 oapi.dingtalk.com 域名后,按钉钉群机器人格式推送。

·自定义:未识别到已知平台时,按通用 JSON 格式推送。

各平台默认消息体格式预览请参见 管理定时任务。

五、自定义消息体模板

如需自定义推送内容,可在配置时提供消息体模板。模板支持 ${summary} 占位符,实际推送时将被替换为 Agent 生成的执行结果内容;未配置模板时,系统使用默认格式推送。

六、连通性校验

保存配置时,系统会对 Webhook 地址执行以下校验:

·地址格式校验:地址必须以 http:// 或 https:// 开头。

·安全防护:系统使用安全网络组件对目标地址执行 SSRF 防护,拦截内网、回环及元数据地址,避免被恶意地址利用。

·连通性探测:系统向目标地址发送一次探测请求。对已识别的平台(企业微信、飞书等)会进一步校验响应中的业务返回码;对自定义地址仅校验网络可达性。

·模板校验:若配置了自定义消息体模板,探测时使用替换占位符后的真实请求体。

七、相关操作

·管理定时任务

·接入 Channel 功能简介

·管理 Channel

赞 (0)
上一篇 4天前
下一篇 4天前