Webhook

角色

Webhook 用于向外部系统投递 run 相关事件。

模型

v1 使用 run-scoped WebhookSubscription：

• 在创建 run 时声明
• 在 run 生命周期内生效
• 由平台异步投递

核心字段

• url
• eventTypes
• headers
• algorithm
• secretRef

规范要求

• Webhook 投递语义为“至少一次”
• 请求头 MUST 包含稳定的 eventId 与 eventType
• 如启用签名，服务端 MUST 基于原始 body 计算签名
• 下游 SHOULD 使用 eventId 和资源 version 做幂等