---
{
  "id": "platform.trigger.targets-and-delivery",
  "topic": "trigger",
  "title": "Trigger targets 與派送",
  "locale": "zh-TW",
  "version": "2026-08-31.1",
  "summary": "Trigger 可喚醒 Agent、在可存取的 H2A 對話恰好貼一次訊息，或直接啟動 owner 的 active Workflow。",
  "content": "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 權限。\n\n`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。\n\n`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`。\n\n`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，不能猜測。\n",
  "aliases": [
    "targetAgentId",
    "Trigger task",
    "systemMessage",
    "同 owner Agent",
    "事件派送",
    "debounce",
    "conversation message",
    "workflow run",
    "讓 Agent 回應"
  ],
  "tags": [
    "trigger",
    "delivery",
    "target"
  ],
  "relatedActions": [
    "arinova.trigger.create_trigger",
    "arinova.trigger.update_trigger",
    "arinova.trigger.get_trigger"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/trigger/targets-and-delivery/"
}
---

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，不能猜測。