記憶を持ち、自律的に考え、ツールを使うエージェントを、エッジで。
Agents SDK 入門 ／ 仕様・ユースケース・拡張性・Workers AI との違い
Worker は「応答して消える」。Agent は「覚えて・考えて・動き続ける」。
1エージェント=1 Durable Object。ユーザーごと・部屋ごとに 独立して存在する。
各インスタンスに 専用ストレージ。状態も会話履歴もその場に永続化。
330+ 都市のエッジで動き、利用者の近くで 無限にスケール。
/agents/{種類}/{インスタンス名} に届く。名前を指定すれば、その実体に必ずつながる。
useAgent({ agent, name }) で WebSocket 接続。状態は自動同期。
import { Agent, callable, routeAgentRequest } from "agents"; export class Counter extends Agent<Env, { count: number }> { initialState = { count: 0 }; // 永続化される状態 @callable() // クライアントから直接呼べる increment() { this.setState({ count: this.state.count + 1 }); // 即、全端末へ同期 return this.state.count; } } export default { fetch: (req, env) => routeAgentRequest(req, env) };
setState / 自動クライアント同期 / 内蔵 SQL（this.sql）
クライアントから型安全に呼び出し / ストリーミング対応
遅延・繰り返し・cron で 自分を起こす
多段処理を再試行つきで / DO 退避を越えて継続
内蔵 FIFO キュー / 指数バックオフ再試行
AIChatAgent・MCP・Email・Webhook・Push・音声(実験)
部品は前からあった。Agents はそれを「実体」として一体化する上位レイヤー。
| Workers AI | Developer Platform | Agents SDK | |
|---|---|---|---|
| 役割 | モデル推論（頭脳） | 計算・保存の部品 | 部品を統合した実体 |
| 状態 | なし（1回の入出力） | DO/KV/D1/R2 で個別に | 標準で永続＋同期 |
| 自律性 | 呼ばれたら答える | Cron/Queue を自分で用意 | 予約・メール等で自走 |
| 位置づけ | 脳 | 手足・記憶 | 神経系（統合） |
「記憶 × 自律 × ツール」が効く場所と、Cloudflare 完結か外部連携かの見極め。
家庭教師・カスタマーサポート・パーソナルコーチ
リサーチ・監視・要約・定期レポート生成
定期ポーリング → 判断 → 通知 / アクション
外部ツール群と接続、または自分をツールとして公開
多段・長時間・再試行が必要な業務処理
共同編集・マルチプレイ・音声エージェント
既存 Postgres 等へ低レイテンシ接続
オンプレを穴を開けず安全に接続(単一方向)
バックエンド同士を 相互にメッシュ接続
外部LLM・外部ツールを集約して呼ぶ
構成：Agents SDK（Durable Object）＋ Workers AI ＋ Hono ＋ React。部品を統合する手間をSDKが引き受ける。
記憶 × 自律 × ツールを一体化した、エッジで動く「実体」。
部品(Workers AI/DO/…)を 自分で組み合わせず、SDKが一体で提供。
推論・記憶・計算が 同じ網で隣接。速く・安く・無限に。
Cloudflare Agents = 記憶を持ち、自律的に動く AI を、エッジで組み立てる。