Skip to main content
POST
创建 Hook

请求

string
内置 Hook 预设的 ID(例如 share.accepted.welcome、task.overdue.summary)。与 event_pattern 互斥。
string
要匹配的自定义事件模式。支持精确匹配(share.accepted)、通配符(order.*.completed)、前缀匹配(share)或全匹配(*)。与 hook_preset_id 互斥。
string
必填
Hook 触发时要执行的技能 slug。
number
两次触发之间的最短间隔时间(分钟,1–1440)。省略时将应用服务端默认值。

响应

string
该 Hook 的唯一 UUID。
string
解析后的事件模式(来自预设或自定义)。
string
目标技能 slug。
boolean
创建时始终为 true。
number
两次触发之间的冷却周期。

身份验证

需要具有 completions 权限范围的 API 密钥。

示例

护栏

  • 每次自主执行前进行预检信用额度检查
  • 自主操作单独设有每日上限
  • 对工具调用次数和总支出设有单次运行上限
  • Hook 在连续失败后会自动暂停
  • 强制执行两次触发之间的冷却时间