・複数のAPIを呼ぶ処理が途中で失敗して困る
・数日後のメール送信や承認待ちを作りたい
・QueuesとWorkflowsの違いを知りたい
Cloudflare Workflows は、Workers の上で複数の手順(ステップ)を順に進め、結果を保存しながら、失敗した手順だけを自動でやり直す仕組みです。数日後に続きを実行する処理や、Webhook・人の承認を待つ処理も、キューや cron を自分で組み合わせずに書けます。Workers の無料プランでも使えます。
この記事では、ステップの仕組み、待つ・取り消す機能、Queues・Cron Triggers との違い、料金と無料枠、始め方、注意点を扱います。数値は Workflows の公式ドキュメント などで2026年11月に確かめたものです。
この記事のゴール(読了目安 約8分)
Workflowsの仕組みと料金を知り、Queuesと比べて自分の処理に使うか判断できるようになる
Workflowsとは?手順を確実に進める仕組み
Workflows は、処理が途中で止まっても、保存しておいた状態から続きを実行するための仕組みです。インフラの管理は要りません。
複数の手順をつなぎ、失敗した処理を自動でやり直し、状態を数分から数週間まで保てます。この作り方を Durable Execution(途中で止まっても、保存した状態から続きを実行する作り方)と呼びます。
公式ブログは、数日たっても購入されないカートへのリマインドメールを例にしています。ふつうはキュー、cron ジョブ、データベースの定期検索を組み合わせる処理です。Workflows なら、カートごとに Workflow を1つ起動し、3日待ってからカートを確かめるだけで作れます。
公式が挙げる用途は次の4つです。
- AI を使ったアプリ
- データパイプライン(データを順に加工して流す処理)
- 自動メールやトライアル期限の管理
- 人の承認を挟む仕組み
Workflows は、Workers の無料プランと有料プランのどちらでも使えます。
仕組み:ステップごとに結果を保存する
Workflows の動きは、次の4つの用語で説明できます。
ステップは step.do(名前, 処理) で書き、処理の結果を保存します。中断や再試行のときは、最後に成功したステップから再開します。完了したステップの処理は、再開しても実行し直しません。
Workflow は WorkflowEntrypoint を継承したクラスで作ります。公式の Get started のコードを短くすると、次の形です。
import { WorkflowEntrypoint } from "cloudflare:workers";
export class MyWorkflow extends WorkflowEntrypoint {
async run(event, step) {
// 1つ目のステップ:API からデータを取る(結果は保存される)
const data = await step.do("fetch data", async () => {
const res = await fetch("https://api.cloudflare.com/client/v4/ips");
return res.json();
});
// 20秒待つ
await step.sleep("pause", "20 seconds");
// 2つ目のステップ:再試行の設定を付けて処理する(中身は省略)
return await step.do(
"process data",
{ retries: { limit: 3, delay: "5 seconds", backoff: "linear" } },
async () => {
// data などから name と ipCount を作って返す
},
);
}
}
状態はステップの戻り値で残します。待つ間にインスタンスが休止して、メモリ上の状態を失うことがあるためです。
Workflows は Workers の上に作られ、内部では SQLite を使う Durable Objects を利用しています。Durable Objects そのものは Durable Objectsとは?状態を1か所に集める仕組みと料金 で解説しています。

できること:待つ・やり直す・取り消す
ステップの中で使える主な機能は「待つ」「やり直す」「取り消す」の3つです。2026年11月時点の公式ページの既定値と上限は次のとおりです。
イベント待ちは、Webhook や人の承認を受けて続きを進めるときに使います。時間切れになるとインスタンスは失敗します。
再試行の回数や間隔は、ステップごとに変えられます。認証の失敗のように、やり直しても直らないエラーは NonRetryableError ですぐ失敗にします。
2026年6月から使えるロールバック(失敗したときに、済んだ手順を取り消す処理)は、在庫の確保や支払いの承認のように、外部のシステムに触れる処理に向きます。
待っている(waiting の)インスタンスは同時実行数に入らないので、多くのインスタンスを待たせておけます。
Queues・Cron Triggersとの違い
1件ずつ確実に届けるなら Queues、時刻で動かすなら Cron Triggers、手順を状態ごと進めるなら Workflows が向きます。
再試行の既定は、Queues がメッセージごとに3回、Workflows がステップごとに5回です。

3つは組み合わせても使えます。
- キューのコンシューマー(受け取る側)から Workflow を起動する
- Workflow の開始・エラー・完了の知らせをキューで受け取る
- Workflow の設定の
schedulesで、決まった時刻に起動する
schedules は2026年6月からの機能で、scheduled ハンドラーを持つ Worker を別に作らずに済みます。cron 式(動かす時刻を決める書き方)は Cron Triggers の解説記事 で扱います。キューの仕組みは Cloudflare Queuesとは?非同期処理の仕組みと無料枠・料金 で解説しています。
料金と無料枠:4つの数え方
料金は、CPU 時間・リクエスト(起動の回数)・保存量・ステップ数の4つで数えます。2026年11月時点の公式ページの数字は次のとおりです。
起動は新しいインスタンスを作ることで、ステップは起動に数えません。GB-月は、日ごとの最大の保存量を30日で平均した単位です。
API の応答待ちや step.sleep の間は、CPU 時間に数えません。 ただし課金の告知は、sleep やイベント待ちもステップに含めるとしています。保存量には、休止中や完了したインスタンスの状態も入ります。再試行とロールバックは、ステップ数に含みません。
ステップ数と保存量の課金は、公式の料金ページでは2026年8月10日から適用です。無料プランは枠を超えても請求されませんが、保存量の上限に達すると、状態を保存しようとしたインスタンスがエラーになります。細かい条件は Workflows の料金ページ で確認してください。

始め方:最初のWorkflowを動かす
公式の Get started は、プロジェクトを作り、Workflow のクラスと設定を足して、手元で試してから公開する流れです。用意するものは Cloudflare のアカウントと Node.js です。
- プロジェクトを作る(TypeScript を選ぶ)
src/workflow.tsに Workflow のクラスを書くwrangler.jsoncに設定を足し、型を作るsrc/index.tsの fetch ハンドラーでenv.MY_WORKFLOW.create()を呼ぶ- 手元で動かして、起動を試す
- 公開する
- 各ステップの結果を見る
npm create cloudflare@latest -- my-workflow # 1. プロジェクトを作る
npx wrangler types # 3. 型を作る
npx wrangler dev # 5. 手元で動かす
curl http://localhost:8787 # 5. 起動を試す
npx wrangler deploy # 6. 公開する
npx wrangler workflows instances describe my-workflow latest # 7. 結果を見る
設定には name・binding・class_name を書きます。class_name は書き出したクラス名と同じにします。 binding はコードから使う名前になります。
{
"workflows": [
{ "name": "my-workflow", "binding": "MY_WORKFLOW", "class_name": "MyWorkflow" }
]
}
完成形から始めるなら、公式のテンプレートも使えます。
npm create cloudflare@latest workflows-starter -- --template "cloudflare/workflows-starter"
使う前の注意点:手順の分け方
ステップは再試行されることがあるため、公式は書き方の決まり(Rules of Workflows)を示しています。
- ステップは冪等(何度実行しても結果が同じになること)にする。例:課金の前に課金済みかを確かめる
- 外部 API やデータベースの呼び出しごとにステップを分ける
- ステップの外に状態や副作用を置かない
- ステップ名に日時や乱数を使わない
- 戻り値は1MiBまで。大きなデータは R2 などに置く
- タイムアウトは30分以下にし、長く待つなら
step.waitForEventを使う
区切りに迷ったら、公式の勧めどおり「一部が失敗したら、全部やり直したいか」と考えます。
インスタンス ID と自社のユーザー ID の対応は、D1 などのデータベースに保存するよう公式は勧めています(Cloudflare D1 の解説記事)。
2026年11月時点の公式ページの主な上限は次のとおりです。なお、Workers for Platforms では使えません。
よくある質問
途中で止めたり、やり直したりできますか?
できます。一時停止・再開・停止・やり直しができ、状態は status() で確かめられます。停止したインスタンスは再開できません。
実行の記録はいつまで残りますか?
2026年11月時点の公式ページでは、完了・エラーの状態とログは無料プランで3日、有料プランで既定7日・最長30日です。2026年9月10日より前に有料プランで作った Workflow は、既定30日のままです。
Pythonでも書けますか?
書けます。Python Workflows SDK が、2025年8月にオープンベータとして公開されました。ダッシュボードの Workflow の図(ベータ版)は、公式ページでは Python を対象外としています。
Pagesのサイトから呼び出せますか?
Workflow を入れた Worker を別にデプロイし、サービスバインディングか fetch で呼べます。公式は、Pages より Workers の Static Assets を使う構成を勧めています。
AIエージェントの処理にも使えますか?
使えます。公式には、LLM の呼び出しとツールの呼び出しをそれぞれステップにするチュートリアルがあります。途中で落ちても、最後に成功したステップから再開します。
この記事のポイント
- Workflowsは手順ごとに結果を保存し、失敗した手順から再開する
- 待つ・やり直す・取り消すを、キューやcronを組まずに書ける
- 料金はCPU時間・起動回数・保存量・ステップ数の4つで数える
- 1件ずつ届けるならQueues、手順を進めるならWorkflows
まとめ
Cloudflare Workflows は、ステップごとに結果を保存し、失敗した手順だけを自動でやり直しながら、複数の手順を進める仕組みです。最長365日待てて、Webhook や人の承認も待てます。1件ずつ届けるなら Queues、手順を進めるなら Workflows と使い分けます。
料金は4つの項目で数え、無料プランにも1日3,000ステップなどの枠があります。まずは公式のテンプレートか Get started どおりに作り、wrangler dev で手元で動かし、ステップの結果を確かめてみてください。






