MINARA

觸發 Team 例行任務

POST /v1/team/routine-hooks/:triggerId: 接收外部 JSON 事件,將指令加入 Team 佇列。

POST /v1/team/routine-hooks/:triggerId

接收外部 JSON 事件,將設定的指令作為使用者訊息加入對應 Team 的佇列。Team Coordinator 使用現有流程執行排隊輪次。服務需處於執行狀態,並可透過本地網路存取;不提供雲端中繼。

方法POST
路徑/v1/team/routine-hooks/:triggerId
驗證不使用閘道層級驗證
分類sessions

請求本文

{ "event": "changed", "evidence": { "source": "https://example.com/item" } }

回應本文

{ "automation_run_id": "run_123", "duplicate": false }

說明

此介面需要觸發器專用密鑰。JSON 物件不得超過 64 KiB。啟用的例行任務最多接受 100 個排隊輪次。

相同冪等鍵與等價 JSON 會傳回原始執行 ID,duplicate=true,HTTP 狀態碼為 202。同一鍵對應的 JSON 發生變更時傳回 409。未提供鍵時,每次呼叫獨立處理。

HTTP 202 表示訊息與輪次已持久化,Team 的工作可能尚未完成。原始 JSON 保留在伺服器端輪次上下文中,所有 Agent 均可存取;公開訊息與歷史回應不包含該資料。

暫停後拒絕新觸發,已接受的輪次繼續執行。輪換密鑰後,舊密鑰立即失效。

本頁目錄