Trigger targets 與派送

Trigger 持久化三種 target：agent_wakeup、conversation_message、workflow_run。只支援 wakeup 的 Agent action 若省略 targetAgentId，就以 current Agent 為 target。明確 target 必須同 owner；handler 會拒絕不同 owner。conversation 與 Workflow target 由 owner REST/UI 建立。每個 target 都保留 Agent 作 quota 與 routing anchor。knowledge 不授予 Agent、conversation、Workflow 或 source resource 權限。

agent_wakeup 會把 systemMessage 當成排入 target Agent 的 task instruction；conversation_message 則在 fire 發生時把它貼進指定 H2A thread。fire-event ID 同時是 message ID，因此 retry 不會產生第二則貼文。可選的「讓 Agent 回應」會再排入 platform Agent，讓回覆串流進同一 thread。dispatch 時會重查權限與 Agent membership；每個 conversation 在 rolling 24 小時內最多接受 50 則 Trigger message。systemMessage 上限仍為 4,000 characters，且會從 action telemetry redact。

workflow_run 不等待 Agent online，直接啟動指定的 active owner Workflow。fire-event ID 是 Workflow run 的 idempotency key，fire chain depth 也會一路傳進 Workflow Agent steps。Workflow 若 paused、deleted、rate-limited 或不可用，fire 會記錄 workflow_unavailable。run 建立後就是 terminal delivery；因為沒有 Trigger result callback，Workflow target 刻意不寫 deliveredAt。

dedupeKey、10 秒 duplicate window 與 5 秒 debounce window 可抑制或合併 event burst，但不保證 exactly-once Agent execution。permission change、target 消失、quota 或 chain-depth guard 都可能造成 queued、skipped、delayed、failed；應查看 fire event 與穩定 status reason，不能猜測。

Related actions

arinova.trigger.create_trigger, arinova.trigger.update_trigger, arinova.trigger.get_trigger

Also known as

targetAgentId, Trigger task, systemMessage, 同 owner Agent, 事件派送, debounce, conversation message, workflow run, 讓 Agent 回應

---

Machine-readable Markdown · Knowledge index