---
{
  "id": "platform.workflow.overview",
  "topic": "workflow",
  "title": "用圖狀步驟編寫 Workflow",
  "locale": "zh-TW",
  "version": "2026-09-01.1",
  "summary": "使用 Agent、Message、Sleep、Delivery 與 owner 通知步驟編寫有界 Workflow 圖，支援循序分支、樣板值，並把 graph 版面 metadata 留給 UI 管理。",
  "content": "Workflow 含 1–50 steps，首項為 entrypoint。`agent`、`message`、`sleep`（1–3600 秒）、`delivery`、`notify` 各有必填欄位；ID 為 1–64 個 ASCII 字元。`next` 最多列五個現有 step；全部省略時才依陣列形成舊版線性鏈。\n\n`agent` 可指向 external Agent 或租用 platform persona。Persona 使用隔離的 `space_api` 受限回合：無工具／Actions、ambient memory、附件脈絡；費用由 Workflow owner 錢包支付。完成文字可由 `{{steps.step-id.output}}` 取得，JSON object／array 保留結構。\n\n執行採循序 BFS，不平行；diamond 無 join barrier，共用下游按 traversal 執行。迴圈 visit 使用 zero-based iteration；`maxVisitsPerStep` 預設 25（1–1000），達限只丟棄該 traversal。\n\nTemplate 支援 trigger payload、巢狀欄位、`{{variables.key}}` 與先前輸出；缺值預設警告並輸出空字串，strict templates 則失敗。教學樣板涵蓋 Cron 摘要通知、Webhook delivery、Sleep polling 與雙 Agent handoff；啟用前填妥 resource IDs。\n\nDelivery queued/billed，上限 262,144 bytes；通知寫入或 push 失敗不會使 run 失敗。修改 active graph 前先 pause；activate/run/delete/cancel 需確認。Cron、Webhook、通用 Trigger 可啟動 Workflow；事件指示包在不可信 trigger 信封。預設每 rolling hour 建立 10 runs；`graph.layout` 是 UI 專用 opaque metadata。\n",
  "aliases": [
    "工作流程",
    "有序步驟",
    "多步流程",
    "依序執行",
    "Agent 步驟",
    "訊息步驟",
    "workflow",
    "ordered steps",
    "分支流程",
    "迴圈流程",
    "Sleep 步驟",
    "Delivery 步驟",
    "通知步驟"
  ],
  "tags": [
    "workflow",
    "overview",
    "ordered-steps",
    "branching",
    "loops",
    "sleep",
    "delivery",
    "notification",
    "templates",
    "layout-metadata"
  ],
  "relatedActions": [
    "arinova.workflow.create_workflow",
    "arinova.workflow.list_workflows",
    "arinova.workflow.get_workflow",
    "arinova.workflow.update_workflow",
    "arinova.workflow.delete_workflow",
    "arinova.workflow.activate_workflow",
    "arinova.workflow.pause_workflow",
    "arinova.workflow.run_workflow",
    "arinova.workflow.list_runs",
    "arinova.workflow.get_run",
    "arinova.workflow.cancel_run"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/workflow/overview/"
}
---

Workflow 含 1–50 steps，首項為 entrypoint。`agent`、`message`、`sleep`（1–3600 秒）、`delivery`、`notify` 各有必填欄位；ID 為 1–64 個 ASCII 字元。`next` 最多列五個現有 step；全部省略時才依陣列形成舊版線性鏈。

`agent` 可指向 external Agent 或租用 platform persona。Persona 使用隔離的 `space_api` 受限回合：無工具／Actions、ambient memory、附件脈絡；費用由 Workflow owner 錢包支付。完成文字可由 `{{steps.step-id.output}}` 取得，JSON object／array 保留結構。

執行採循序 BFS，不平行；diamond 無 join barrier，共用下游按 traversal 執行。迴圈 visit 使用 zero-based iteration；`maxVisitsPerStep` 預設 25（1–1000），達限只丟棄該 traversal。

Template 支援 trigger payload、巢狀欄位、`{{variables.key}}` 與先前輸出；缺值預設警告並輸出空字串，strict templates 則失敗。教學樣板涵蓋 Cron 摘要通知、Webhook delivery、Sleep polling 與雙 Agent handoff；啟用前填妥 resource IDs。

Delivery queued/billed，上限 262,144 bytes；通知寫入或 push 失敗不會使 run 失敗。修改 active graph 前先 pause；activate/run/delete/cancel 需確認。Cron、Webhook、通用 Trigger 可啟動 Workflow；事件指示包在不可信 trigger 信封。預設每 rolling hour 建立 10 runs；`graph.layout` 是 UI 專用 opaque metadata。