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 在連續失敗後會自動暫停
  • 強制執行兩次觸發之間的冷卻時間