agents-sdk
Cloudflare の Agents SDK で、状態を持つエージェントを書かせ、見直させる。状態の同期、予約した処理、長い処理の続行、チャット、MCP、メール。細部は最新の公式文書を読みに行かせる
npx skills add cloudflare/skills/agents-sdk入れる前にこのスキルがすること・注意点・SKILL.md の原文を確かめてください。解析は安全性の判定ではありません。
- インストール
- 111,732
- 実用度
- 65
- GitHub star
- 3,292
- 最終更新
- 2026/11/7
頼み方の例
そのままコピーして使えますagents-sdkスキルを使って、利用者ごとに 1 つのエージェントを持ち、毎朝 8 時に予定をまとめて Web Push で知らせる仕組みの設計を出してください。使う API と wrangler.jsonc の設定を示し、コードはまだ書かないでください。
対象のファイルや状況は、ご自身の作業に合わせて置き換えてください。
このスキルがすること
SKILL.md の記述から機械的に抽出- シェルコマンドを実行する記述があります
- パッケージを導入する記述があります
これは安全性の判定ではありません。 SKILL.md にそう書かれているという事実だけを並べています。実際に問題があるかは使い方と文脈で決まるため、当サイトでは断定しません。導入前に SKILL.md の原文を確認してください。
SKILL.md の規模
コードブロックの言語: bash、jsonc、typescript
この解説は再確認中です。 2026年10月30日に原本（SKILL.md）が更新されており、以下の解説が現在の内容と合っていない可能性があります。最新の内容は GitHub の SKILL.md を確認してください。
いつ使うか
Cloudflare の上で、状態を持つ AI のエージェントを作るときに効きます。Agents SDK は、Durable Objects の上に、状態の保存と同期・呼び出し・予約した処理などを載せた仕組みです。
できることは 8 分野
できることの一覧が本文にあります。
| 分野 | 中身 |
|---|---|
| 状態 | SQLite に保存し、setState で画面の側にも自動で同期する。変更を検査する口もある |
| 呼び出し | @callable() のメソッドを WebSocket から呼ぶ。流し続ける応答も可 |
| 予約した処理 | 1 回だけ、一定の間隔、cron |
| 長い処理 | 段階を踏む処理（AgentWorkflow）、実体が落ちても続く処理（runFiber()）、待ち行列、やり直し |
| チャット | AIChatAgent。切れても再開できる流し方、会話の保存、道具 |
| 外との接続 | MCP のクライアントとサーバー、メールの受信と返信、Webhook、Web Push |
| 画面の側 | React のフック（useAgent、useAgentChat） |
| 試験導入 | 音声（STT/TTS）、ブラウザの操作、より上位のチャットのクラス（Think） |
学習済みの知識より、公式の文書を読みに行かせる
冒頭は同じ公開元の他のスキルと同じく「Agents SDK の知識は古いかもしれない。学習済みの知識より文書の取得を優先せよ」です。話題ごとに読むべき公式の頁が 30 以上（表の 33 行）並んでいます。
- 話題ごとに案内される公式の頁
- 30 以上
- 同梱ファイル（分野ごとの資料）
- 19 件
使わないほうがいいとき
Durable Objects を直接書きたいとき
下の層の決まりは durable-objects の担当です。
Cloudflare 以外で動かすエージェント
Workers と Durable Objects が前提です。
注意点
解析の結果と、実際の動きがずれている
SKILL.md の解析では、シェルコマンドの実行とパッケージの導入の記述（npm install agents など）が見つかっています。ただし本文は細部を developers.cloudflare.com から取ってこいと指示していて、実際には Web を読みに行きます。
解析は、この地の文の指示を拾えていません。同梱ファイルは 19 件で、分野ごとの資料です。
設定の落とし穴が 4 つ挙がっている
設定の落とし穴が挙がっています。次の 4 つです。
- tsconfig の設定
experimentalDecoratorsを有効にすると@callableが壊れる - 移行の設定古い移行の設定は書き換えずに、新しい札を足す
- クラスごとの項目エージェントのクラスごとに、Durable Objects の結び付けと移行の項目が要る
- Workers AI使うなら
"ai": { "binding": "AI" }を足す
試験導入の機能がある
上流の一覧の説明とずれている
上流の一覧の説明とずれています。上流（skills.sh の一覧）の説明は「エージェントに本物のブラウザの力を与える」という書き方です。しかし SKILL.md の中身は Agents SDK 全般の手引きで、ブラウザの操作は試験導入の 1 項目です（2026-09-26 に当サイトで照合）。
インストール数
インストール数は約 6.2 万件です。同じリポジトリの 10 件は約 4.7 万〜8.1 万件で（2026-09-07 の上流集計）、1 件ずつ選ばれている形です。
インストール数の推移
日次で記録9月18日 〜 11月7日（49日分）
インストール数と 1 日あたりの増加は Skillselion が に集計した値です。上流の更新は数日おきなので、前日比ではありません。GitHub star と最終更新は に GitHub から取得しました。
併用すると強いスキル
cloudflare
「アップロードを受けたい」「裏で処理を回したい」といった要望から、Cloudflare のどの製品を組み合わせるかを選ばせる。97 行の対応表で製品と担当のスキルに振り分け、細部は公式文書を読みに行かせる
durable-objects
Cloudflare の Durable Objects のコードを書かせ、見直させる。チャットの部屋やユーザーごとに 1 つ持つ「状態を持つ部品」を、7 つの決まりと禁止事項で組ませる。細部は最新の公式文書を読みに行かせる
web-perf
サイトの表示の遅さを実測で調べさせる。Chrome DevTools で計測し、効果が 0 ミリ秒の改善は勧めさせない
よくある質問
URL はどう割り当てられますか
/agents/{エージェント名}/{インスタンス名} に振り分けられます。Counter クラスの user-123 なら /agents/counter/user-123 です。画面の側からは useAgent({ agent: "Counter", name: "user-123" }) でつなぎます。
人の承認を挟めますか
挟めます。承認の流れ（needsApproval）、問い返し、時間切れの扱いの資料が同梱されています。
MCP のサーバーも作れますか
作れます。createMcpHandler で MCP のサーバーを作る手順と、OAuth などで守る方法の頁が案内されています。MCP のサーバーに接続するクライアントとしても使えます。