You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
Webhooks
Webhook 事件结构参考
复制全文
下载 pdf
Webhook 事件结构参考
当 Agent 运行状态、资源变更或凭证刷新等订阅事件发生时,Managed Agents Webhook 会向接入点推送统一事件信封。本文列出当前可订阅的业务事件,并说明用于验证接收链路的 webhook.test 测试事件。Webhook 事件是独立通知,不等同于 Session Events 查询或 SSE 返回的原始事件。​
每个事件使用以下统一信封。外层 type 固定为 event,id 是以 whe- 开头的 Webhook 事件 ID;data.type 是业务事件类型,data.id 是触发事件的资源 ID。​
​
{​
"type": "event",​
"id": "whe-20261012080500-f6g7h",​
"created_at": "2026-10-12T08:05:00Z",​
"data": {​
"type": "session.status_idled",​
"id": "sesn-20261012080000-k1l2m"​
}​
}​
​
事件正文生成后保持不变;同一事件向多个接入点投递或重试时,外层 id、created_at 和正文均不变。​
说明​
  • Webhook 不保证严格顺序或恰好一次投递。接收端应按外层 id 去重,并通过资源查询接口读取当前状态。​
  • session.status_running 映射为 session.status_run_started;session.status_idle 映射为 session.status_idled。原 Session 事件名称不变。​
  • session.status_idled 只表示 Session 已进入空闲状态,不表示当前轮次正常结束。使用 data.id 查询该 Session 的历史事件,并根据业务侧记录的本轮边界定位对应的 session.status_idle;无法确认对应关系时,不要仅凭最近一条 end_turn 自动推进业务。Webhook 外层 whe- ID 不能作为 Session Event ID 使用。​
  • 线程事件的 data.id 是所属 Session ID,data.session_thread_id 是发生状态变化的线程 ID。​
  • 凭证事件的 data.id 是凭证 ID,data.vault_id 是所属 Vault ID;删除事件保留删除前的所属关系。​
服务端推送事件(响应)​
session.status_run_started​
Session 状态转换为运行中时触发。每次进入运行状态都会生成事件。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
session.status_idled​
Session 状态转换为空闲时触发。该事件不携带 stop_reason,也不表示当前轮次正常结束;需要按业务侧记录的本轮边界查询 Session 历史中的 session.status_idle 事件判断停止原因。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
session.status_terminated​
Session 进入终止状态时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
span.outcome_evaluation_end​
单次迭代的结果评估结束时触发,不表示整个 Session 已完成。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
session.error​
Session 执行过程中发生业务错误时触发,不表示投递失败或 Session 已终止。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
session.thread_status_running​
Session 线程开始处理任务并进入运行状态时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
session.thread_status_idle​
Session 线程处理完当前任务并进入空闲状态时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
session.thread_status_terminated​
Session 线程进入终止状态时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
session.updated​
通过 Session 更新接口成功修改 Session 时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
session.deleted​
通过 Session 删除接口成功删除 Session 时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
agent.created​
Agent 创建成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
agent.updated​
Agent 更新成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
agent.deleted​
Agent 删除成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
environment.created​
Environment 创建成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
environment.updated​
Environment 更新成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
environment.deleted​
Environment 删除成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
memory_store.created​
Memory Store 创建成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
memory_store.deleted​
Memory Store 删除成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
vault.created​
Vault 创建成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
vault.deleted​
Vault 删除成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
vault_credential.created​
Vault 凭证创建成功时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
vault_credential.deleted​
Vault 凭证被直接删除,或随所属 Vault 删除时触发。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
vault_credential.refresh_failed​
平台刷新 OAuth 凭证失败时触发;未执行刷新时不产生该事件。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
webhook.test​
调用发送 Webhook 测试事件接口时生成。该事件不可订阅,只向目标接入点投递一次。​
type string | 对象类型​
​
id string | 事件 ID​
​
created_at string | 发生时间​
​
data object | 事件数据​
​
​​
​
最近更新时间:2026.10.28 19:53:33
这个页面对您有帮助吗?
有用
有用
无用
无用