・CloudflareでAIエージェントを作りたい
・APIキーなしでAIを試したい
・Workers AIの料金の数え方を知りたい
Cloudflare で AI エージェントを作るときの部品が、Workers AI と Agents SDK です。Workers AI は Cloudflare の GPU でモデルを動かす推論(モデルに答えを出させる処理)のサービスです。Agents SDK は、エージェントに記憶・接続・予定を持たせて動かし続ける道具です。AI バインディング(キーを書かずにサービスを呼ぶつなぎ)を使えば、API キーなしで2つを組み合わせられます。
この記事では、役割分担・仕組み・できること・料金の数え方・始め方・注意点を扱います。料金と上限は2026年11月時点の公式ページの値で、AI Gateway などの製品そのものは各記事に任せます。
この記事のゴール(読了目安 約8分)
Workers AIとAgents SDKの役割と料金の数え方を知り、最初の一歩を選べるようになる
Workers AIとAgents SDKの役割
Workers AI は「考える部分」、Agents SDK は「覚えて動き続ける部分」を受け持ちます。組み合わせると、記憶を持ち、待っても途切れないエージェントになります。
Workers AI のモデルは Cloudflare のネットワーク上の GPU で動き、Workers・Pages・Cloudflare API から呼べます。GPU の用意や保守は要りません。
Agents SDK は、2025年2月に公開されたエージェントづくりのパッケージ(npm の agents)です。エージェントとは、道具の使い方や進め方を自分で決めて仕事をこなす AI の仕組みです。
普通の Worker は毎回ゼロから始めますが、エージェントは呼び出しの間も状態を持ちます。 WebSocket で利用者とつながり続け、利用者がいなくても自分の予定でモデルを呼べます。

エージェントが動く仕組み
1つのエージェントは1つの Durable Object として動きます。名前で呼び分け、4つの部品を組み合わせて作ります。
同じ名前(ID)を指定すれば、必ず同じエージェントに届きます。 利用者 ID やチケット番号を名前にすれば、セッションを別に保存する仕組みは要りません。URL は /agents/:agent-name/:instance-name の形で、Worker の routeAgentRequest() が振り分けます。名前ごとに世界で1つだけ動く仕組みは、Durable Objectsとはの記事で解説しています。
使われていない間は休止して計算資源を使わず、リクエストやメッセージ、予約、届いたメールで目を覚まします。状態は SQLite に残り、つながっている画面に同期されます。
部品は次の4つです。
- ランタイム:Durable Object と Lifecycle に、状態・WebSocket・予約などの機能を足したもの
- ハーネス:モデルを呼び、道具を動かし、続けるか止めるかを決めるループ
- ツール:エージェントが実際に作業するための道具
- 窓口:チャット・音声・メール・Slack・Webhook など、人やシステムが話しかける入口
ハーネスは、新しく作るなら Pi から始めるよう公式が勧めています。

できること:モデルと道具
Workers AI は呼べるモデル、Agents SDK はエージェントにさせられることで分けて見ます。
Workers AIで呼べるモデル
種類は、文章生成・要約・翻訳・埋め込み(文章を意味で比べられる数値にしたもの)・音声認識・画像生成などです。
glm-4.7-flash:100以上の言語に対応した文章生成plamo-embedding-1b:Preferred Networks の日本語の埋め込みモデル
2026年8月からは、同じ AI バインディングで外部の提供元のモデルも呼べます。 呼び出しの記録や回数の上限は、Cloudflare AI Gatewayとはの記事で紹介しています。
Agents SDKでできること
推論モデルは応答に30秒〜数分かかることがありますが、エージェントは接続が切れても動き続け、結果を保存して後で渡せます。
- 状態の同期:覚えた値を、つながっている画面すべてにそろえる
- 予約:秒数・日時・cron で仕事を予約する
- 連携:メールの受信、Workflows の実行と承認待ち
- チャット:
AIChatAgentがメッセージを保存し、続きから流す
エージェントに渡せる道具
AI が書いたコードを隔離して動かす仕組みはCloudflare Sandboxesとはの記事で整理しています。
料金と無料枠:2つの物差し
モデルを使った分は Workers AI の Neurons、エージェントが動いた分は Durable Objects の料金で数えます。 値は2026年11月時点の公式ページのものです。
Neurons は、リクエストに要った GPU の計算量の単位です。Workers AI の料金ページにはモデルごとのトークン単位の値も載っていますが、請求は Neurons です。上限は毎日 00:00 UTC(日本時間の午前9時)に戻り、超えるとエラーになります。kimi-k2.6 や glm-5.3 など一部のモデルは、Workers 有料プランか AI Gateway の前払いクレジットが要ります。
エージェント側には、Agents 専用の料金表がありません。各エージェントは Durable Object として動くので、Durable Objects の料金ページで見積もります。
- 休止できる状態で待つ間は、時間(duration)の料金がかからない
- 保存したデータの料金は、Durable Objects の記事と料金ページで確かめる
エージェントのトレース(動きの記録)は、2026年12月1日から Cloudflare Observability の料金で数えます。

始め方:画面から・コードから
入口は3つあり、どこまで作るかで選びます。
ダッシュボードで試す
「Workers & Pages」→「Create application」で、テンプレートの「LLM Chat App」を選びます。「Deploy」→名前を付けて「Create and deploy」と進むと、workers.dev のサブドメインでチャットを試せます。
Workerから呼ぶ
npm create cloudflare@latest -- hello-aiでプロジェクトを作る- Wrangler の設定に AI バインディングを足す
env.AI.run()でモデルを呼ぶコードを書くnpx wrangler devで手元で試すnpx wrangler loginの後、npx wrangler deployで公開する
"ai": { "binding": "AI" }
env.AI.run("@cf/google/gemma-4-26b-a4b-it", { messages: [...] })
エージェントまで作る
公式のチャットのチュートリアルは約15分です。次のパッケージを入れ、Wrangler の設定に AI バインディングと Durable Object を書きます。
npm install agents @cloudflare/ai-chat ai @ai-sdk/provider zod
AIChatAgent のサーバーと画面を書いたら、npx wrangler deploy で公開します。agents パッケージには、Wrangler の nodejs_compat フラグが要ります。 道具は、自動・ブラウザ側・人の承認つきの3種類を試せます。
使う前の注意点
動かしてから困りやすい点は5つです。
- 手元でも課金される:
wrangler devで試しても AI バインディングは Cloudflare 側で動き、料金と上限の回数に数えます - モデルは入れ替わる:2026年5月に古いモデルの廃止が予告され、kimi-k2.5 は単価の高い kimi-k2.6 へ自動で切り替えるとされました。名前はモデル一覧で確かめます
- 回数の上限が違う:文章生成は毎分300回ですが、有料が要るモデルは毎分20回(AI Gateway の前払いクレジットなら50回)です
- メモリの値は消える:休止や退避で変数やタイマーは消えるので、覚えることは状態か SQL に入れます
- 書き方が変わった:
workers-ai-providerとai-gateway-providerは2026年10月に非推奨になり、createAIに代わりました
createWorkersAI を使うネットの例は、2026年10月より前の書き方です。 Pi Durable や Think などのハーネスも実験的で、API が変わることがあります。
Agents の上限ページでは、CPU 時間はリクエストやメッセージごとに30秒とされ、LLM の応答を待つ時間には上限がありません。重い複数段の仕事や人の承認を挟む流れは、Workflows と組み合わせるのが公式の目安です。手順を確実に進める仕組みは、Cloudflare Workflowsとはの記事で解説しています。
よくある質問
無料プランだけで試せますか?
試せます。チャットのチュートリアルは無料のアカウントで進められ、Durable Objects も SQLite 型なら無料プランで動きます。ただし、サンドボックスの道具と1日10,000 Neurons を超える利用には Workers 有料プランが、一部のモデルには有料プランか AI Gateway の前払いクレジットが要ります。
Workerを書かずに使えますか?
使えます。REST API なら、Workers AI の Read と Edit の権限を持つ API トークンとアカウント ID で呼べます。OpenAI 互換の窓口を使えば、OpenAI の SDK の baseURL を差し替えるだけです。
入力した内容はAIの学習に使われますか?
使われません。通常の推論では、入力と出力を処理に要る間しか扱わず、その後は残しません。ただし R2 や Durable Objects に保存したり、AI Gateway のログを有効にしたりすると、その機能の決まりで残ります。
Anthropicなど外部のモデルも使えますか?
使えます。Agents SDK の createAI で anthropic/claude-opus-5.5 のような名前を指定すると、AI Gateway を通って呼ばれます。提供元のキーは AI Gateway が持ちます。
エージェントは何体まで動かせますか?
公式の上限では、同時に動かせるエージェントは数千万以上です。利用者やチケットごとに1体ずつ作れます。
この記事のポイント
- Workers AIはモデル、Agents SDKはエージェントを動かす
- エージェント1つが1つのDurable Object。名前で呼び分ける
- 料金はNeuronsとDurable Objectsの2つの物差しで数える
- 新しく書くならcreateAI。古い例と廃止モデルに注意
まとめ
Cloudflare の AI エージェントは、Workers AI が考え、Agents SDK が覚えて動き続ける形で組み立てます。エージェントは1つずつ Durable Object として動き、AI バインディングでモデルを呼べば API キーは要りません。
料金は、モデルの利用を Neurons(1日10,000まで無料)で、エージェントの稼働を Durable Objects の料金で数えます。まずは「LLM Chat App」のテンプレートか公式のチャットのチュートリアルで動かし、新しいコードは createAI で書いてください。






