訂閱以接收新文章的通知:

重新架構 Workflows 控制平面以迎接智慧體時代

2026-04-15

閱讀時間:8 分鐘
本貼文還提供以下語言版本:English日本語한국어简体中文

當我們最初建構 Workflows(我們用於多步驟應用程式的持久性執行引擎)時,它是為一個工作流程由人類操作觸發的世界而設計的,例如使用者註冊或下訂單。對於像是新使用者上線流程這類用例,工作流程只需支援「每人一個執行個體」的模式——而且人類點擊的速度有限。

隨著時間推移,我們實際觀察到工作負載和存取模式發生了數量上的轉變:由人類觸發的工作流程變少,而由智慧體觸發、以機器速度建立的工作流程大幅增加。

隨著智慧體成為持久且自主的基礎架構,代表使用者運作數小時甚至數天,它們需要一個持久、非同步的執行引擎來處理其工作。Workflows 正能提供此功能:每個步驟都可以獨立重試,工作流程可以暫停等待人工介入核准,且每一個執行個體都能在遭遇故障時倖存下來,而不會遺失任何已取得的進度。

此外,工作流程本身正被用於實現智慧體循環,並作為管理和維持智慧體運作的持久性框架。我們的 Agents SDK 整合加速了這一進程,使智慧體能輕鬆產生工作流程執行個體並獲得即時進度回饋。一個智慧體工作階段現在可以啟動數十個工作流程,而多個智慧體同時執行意味著在幾秒鐘內可以建立數千個執行個體。隨著 Project Think 的推出,我們預計這一速度只會進一步提升。

為了協助開發人員在 Workflows 上擴展他們的智慧體和應用程式,我們很高興地宣布,我們現在支援:

  • 50,000 個並行執行個體(同時執行的工作流程數量),原為 4500 個

  • 每個帳戶每秒可建立 300 個執行個體,原為 100 個

  • 每個工作流程 200 萬個佇列執行個體(指已建立或喚醒並等待並行槽位的執行個體),原為 100 萬個

我們根據使用資料和第一原理,重新設計了 Workflows 控制平面以支援這些增長。對於控制平面的 V1 版本,單個 Durable Object (DO) 可以作為整個帳戶的中心註冊表和協調器。對於 V2,我們建立了兩個新元件來幫助系統水平擴展,並緩解 V1 引入的瓶頸。隨後,我們在保持現有流量不中斷的前提下,將所有客戶無縫遷移到了這一全新的版本之上。

V1:Workflows 的初始架構

如我們在公開測試版部落格文章中所述,我們完全在自己的開發人員平台上建構了 Workflows。根本上來說,工作流程是一系列持久性步驟,每一步都可以獨立重試,它們可以執行任務、等待外部事件,或是休眠直到預定時間。

export class MyWorkflow extends WorkflowEntrypoint {

  async run(event, step) {
    const data = await step.do("fetch-data", async () => {
      return fetchFromAPI();
    });

    const approval = await step.waitForEvent("approval", {
      type: "approval",
      timeout: "24 hours",
    });

    await step.do("process-and-save", async () => {
      return store(transform(data));
    });
  }
}

為了觸發每個執行個體、執行其邏輯並儲存其中繼資料,我們利用以 SQLite 為後盾的 Durable Objects,這是在分散式系統中用於協調與儲存的簡單但強大的基礎元件。

在控制平面中,某些 Durable Objects(例如 Engine,它負責執行實際的工作流程執行個體,包括其步驟、重試和休眠邏輯)會以每個執行個體 1:1 的比例啟動。另一方面,Account 是一個帳戶層級的 Durable Object,負責管理該帳戶的所有工作流程和工作流程執行個體。

BLOG-3116 2

若要進一步瞭解 V1 控制平面,請參閱我們的 Workflows 發佈公告部落格文章

在 Workflows 進入測試階段後,我們很高興看到客戶迅速擴展他們對該產品的使用,但我們也意識到,使用單個 Durable Object 來儲存所有帳戶層級資訊會帶來瓶頸。許多客戶每分鐘需要建立和執行數百甚至數千個工作流程執行個體,這在原架構中很容易使 Account 不堪負荷。最初的速率限制——4,500 個並行槽位和每秒 100 個執行個體建立數——就是此限制的結果。

在 V1 控制平面上,這些限制是硬性的上限。任何依賴 Account 的操作,包括建立、更新和列表,都必須透過那個單一的 DO。擁有高並行工作負載的使用者,任何時刻都可能有數千個執行個體啟動和結束,每秒對 Account 發出數千個請求。為了解決這個問題,我們重新架構了 workflow 控制平面,使其能夠水平擴展以達到更高的並行度和建立速率限制。

V2:水平擴展以獲得更高輸送量

對於新版本,我們從頭開始重新思考每一個操作,目標是針對高流量工作負載進行最佳化。最終,Workflows 應該要能擴展以支援開發人員的任何需求——無論是每秒建立數千個執行個體,還是同時執行數百萬個執行個體。我們也希望確保 V2 能夠允許靈活的限制,讓我們可以調整並持續增加,而不是像 V1 那樣有硬性的上限。經過多次設計迭代,我們為新架構確立了以下幾個支柱:

  • 特定執行個體存在性的真實來源應是其 Engine,而非其他。

    • 在 V1 控制平面架構中,我們在將執行個體排入佇列之前,沒有檢查它的 Engine 是否真的存在。這導致了一種錯誤狀態:執行個體可能已被排入佇列,但其對應的 Engine 卻尚未啟動。

    • 執行個體的生命週期和存活機制必須能夠按工作流程水平擴展,並分散在多個區域。

  • 新的 Account 單例應僅儲存最必要的中繼資料,並具有不變的最大並行請求量。

BLOG-3116 3

在 V2 控制平面中有兩個新的關鍵元件,使我們能夠提升 Workflows 的可擴展性:SousChefGatekeeper。第一個元件 SousChefAccount 的「二把手」。回想一下,先前 Account 管理著給定帳戶內所有工作流程中所有執行個體的中繼資料和生命週期。引入 SousChef 是為了追蹤給定工作流程中一部分執行個體的中繼資料和生命週期。在一個帳戶內,一群 SousChefs 能夠以更有效率、更易於管理的方式向 Account 回報。(這種設計還有一個額外的好處:我們不僅已經有了每個帳戶的隔離性,還意外地在同一個帳戶內獲得了「每個工作流程」的隔離性,因為每個 SousChef 只負責一個特定的工作流程)。

第二個元件 Gatekeeper 是一種機制,負責將並行「槽位」(源自並行限制)分配給帳戶內的所有 SousChefs。它就像一個租賃系統。當一個執行個體被建立時,它會被隨機分配給該帳戶內的一個 SousChef。然後該 SousChefAccount 發出請求以觸發該執行個體。此時要麼獲得一個槽位,要麼執行個體被放入佇列。一旦槽位獲得核准,SousChef 就會觸發該執行個體的執行,並承擔確保該執行個體永遠不會卡住的責任。

Gatekeeper 的存在是為了確保 Engines 永遠不會讓它們的 Account 過載(這是 V1 版本的一個迫切風險),因此 SousChefs 與其 Account 之間的每次通訊都以週期性的方式進行,每秒一次——每個週期也會批次處理所有槽位請求,確保只發出一次 JSRPC 呼叫。這確保了執行個體建立速率永遠不會壓垮或影響最重要的元件 Account(附帶一提:如果 SousChef 數量過高,我們會對呼叫進行速率限制,或將它們分散到不同時段的不同 SousChef)。此外,這種週期性特性使我們能夠保持對較舊執行個體的公平性,並透過眾多 SousChef 確保最大最小公平性,讓它們都能繼續進展。例如,如果一個執行個體被喚醒,它應該比一個新建立的執行個體更優先獲得槽位,但每個 SousChef 都會確保它自己的執行個體不會卡住。

這種架構更加分散,因此更具可擴展性。現在,當一個執行個體被建立時,請求路徑如下:

  1. 檢查控制平面版本

  2. 檢查在該位置是否有工作流程和版本詳細資料的快取版本可用

    1. 如果沒有,檢查 Account 以取得工作流名稱、唯一 ID 和版本,並快取該資訊

  3. 僅將必要的中繼資料(執行個體負載、建立日期)儲存到其自身的 Engine

那麼,Engine 如何告訴控制平面它現在已經存在?這發生在執行個體中繼資料設定之後的背景作業中。由於 Durable Object 上的背景作業可能因驅逐或伺服器故障而失敗,我們也在建立流程的熱路徑 (hot-path) 上為 Engine 設定了一個「鬧鐘」(alarm)。這樣一來,如果背景任務沒有完成,鬧鐘就會確保該執行個體將會啟動。

Durable Object 鬧鐘允許一個 Durable Object 執行個體在未來的某個精細時間點被喚醒,採用至少執行一次的模型,並內建自動重試機制。我們廣泛使用這種背景「任務」與鬧鐘的組合,將操作移出熱路徑,同時仍然確保一切都將按計畫發生。這就是我們在不影響可靠性的前提下,保持像建立執行個體這樣的關鍵操作快速執行的方式。

除了釋放擴展能力之外,這個版本的控制平面還意味著:

  • 執行個體列表的效能更快,並且與游標分頁 (cursor pagination) 保持一致;

  • 對執行個體的任何操作只需一個網路躍點(因為它可以直接前往其 Engine,確保終端使用者請求的延遲盡可能小);

  • 我們可以確保更多執行個體能夠同時正常運作(按時執行),並在運作異常時進行修正(確保 Engines 永遠不會延遲繼續執行)。

V1 → V2 遷移

現在我們有了新版本的 Workflows 控制平面,能夠處理更大量的使用者負載,接下來我們需要做「枯燥無味」的部分:將我們的客戶和執行個體遷移到新系統。在 Cloudflare 的規模下,這本身就變成了一個問題,因此「枯燥無味」的部分反而成了最大的挑戰。在滿一週年之前,Workflows 就已經累積了數百萬個執行個體和數千名客戶。此外,V1 控制平面上的一些技術債意味著,一個排隊中的執行個體可能還沒有建立自己的 Engine Durable Object,這讓情況更加複雜。

這樣的遷移非常棘手,因為客戶可能隨時都有執行個體在執行;我們需要一種方法,將 SousChefGatekeeper 元件加入到較舊的帳戶中,而不造成任何中斷或停機時間。

我們最終決定將現有的 Accounts(以下稱之為 AccountOld)遷移,讓它們像 SousChefs 一樣行事。透過保留 Account DO,我們維持了執行個體的中繼資料,並簡單地將該 DO 轉換為一個 SousChef「DO」:

// You might be wondering what's this SousChef class? This is the SousChef DO class!
import { SousChef } from "@repo/souschef";

class AccountOld extends DurableObject {
  constructor(state: DurableObjectState, env: Env) {
    // We added the following snippet to the end of our AccountOld DO's
    // constructor. This ensures that if we want, we can use any primitive
    // that is available on SousChef DO
    if (this.currentVersion === ControlPlaneVersions.SOUS_CHEFS) {
      this.sousChef = new SousChef(this.ctx, this.env);
      await this.sousChef.setup()
    }
  }

  async updateInstance(params: UpdateInstanceParams) {
    if (this.currentVersion === ControlPlaneVersions.SOUS_CHEFS) {
      assert(this.sousChef !== undefined, 'SousChef must exist on v2');
      return this.sousChef.updateInstance(params);
    }

    // old logic remains the same
  }

  @RequiresVersion<AccountOld>(ControlPlaneVersions.V1)
  async getMetadata() {
    // this method can only be run if 
    // this.currentVersion === ControlPlaneVersions.V1
  }
}

我們可以在 AccountOld 中實例化 SousChef 類別,因為追蹤執行個體中繼資料的 SQL 表格,在 SousChefsAccountOld DO 上都是相同的。因此,我們可以決定使用哪個版本的程式碼。如果情況不是這樣,我們將被迫遷移數百萬個執行個體的中繼資料,這會使每個帳戶的遷移更加困難且耗時更長。那麼,遷移是如何進行的呢?

首先,我們準備將 AccountOld DO 切換為像 SousChefs 一樣運作(這意味著建立一個包含上述程式碼片段的版本發佈)。然後,我們按帳戶啟用控制平面 V2,這大致在同一時間觸發了接下來的三個步驟:

  • 所有新執行個體建立請求現在都被路由到新的 SousChefsSousChefs 在收到第一個請求時被建立),新的執行個體不再傳送到 AccountOld

  • AccountOld DO 開始遷移自身,使其像 SousChefs 一樣行事;

  • 新的 Account DO 隨對應的中繼資料一起啟動。

在所有帳戶都遷移到新的控制平面版本之後,我們就能在 AccountOld DO 的執行給保留期到期後將其淘汰。一旦 AccountOld 上所有帳戶的所有執行個體都完成遷移,我們就可以永久地關閉這些 DO。遷移過程在零停機的情況下完成,感覺就像在行駛中更換汽車的輪胎一樣。

試用

如果您是 Workflows 的新手,請嘗試我們的入門指南,或使用 Workflows 建立您的第一個持久性智慧體

如果您的使用案例需要比我們新的預設值更高的限制(50,000 個槽位的並行限制,以及每個帳戶每秒 300 個、每個工作流程每秒 100 個執行個體的建立速率限制),請透過您的客戶團隊或 Workers 限制申請表單與我們聯絡。您也可以在我們的 Discord 伺服器上提供回饋、提出功能請求,或者分享您使用 Workflows 的心得。

我們保護整個企業網路,協助客戶有效地建置網際網路規模的應用程式,加速任何網站或網際網路應用程式抵禦 DDoS 攻擊,阻止駭客入侵,並且可以協助您實現 Zero Trust

從任何裝置造訪 1.1.1.1,即可開始使用我們的免費應用程式,讓您的網際網路更快速、更安全。

若要進一步瞭解我們協助打造更好的網際網路的使命,請從這裡開始。如果您正在尋找新的職業方向,請查看我們的職缺
Agents Week代理程式Durable ObjectsCloudflare Workers開發人員平台開發人員

在 X 上進行關注

Cloudflare|@cloudflare

相關貼文

2026年4月30日

Agents can now create Cloudflare accounts, buy domains, and deploy

Starting today, agents can now be Cloudflare customers. They can create a Cloudflare account, start a paid subscription, register a domain, and get back an API token to deploy code right away. Humans can be in the loop to grant permission, but there’s no need to go to the dashboard, copy and paste API tokens, or enter credit card details. ...

2026年4月22日

讓 Rust Workers 更加可靠:wasm‑bindgen 中的 panic 與 abort 復原

過去,Rust Workers 中的 panic(恐慌)是致命的,會損毀整個執行個體。透過與上游的 wasm‑bindgen 專案合作,Rust Workers 現在支援了具韌性的關鍵錯誤復原,包括使用 WebAssembly 異常處理 (WebAssembly Exception Handling) 進行 panic unwind(恐慌展開)。...