通常の Worker はリクエストに応答できますが、多くのアプリケーションには、状態を記憶し、接続中のクライアントを調整し、リクエスト終了後も処理を続ける安定したアイデンティティが必要です。Cloudflare Agents SDK は、Workers と SQLite ベースの Durable Objects の上で、このアプリケーションモデルを提供します。
小さな架空のサポートシステムを、境界ごとに構築します。最初は AI モデルを使わず、名前付きアイデンティティ、永続状態、同期クライアントを観察します。後のラボでは、永続的な会話、予定された処理、モデルが選ぶツール、明示的な承認、読み取り専用 MCP インターフェース、実践的なルーティング診断を追加します。新しい概念は、それを必要とするアプリケーションの要件とともに説明するため、Agents SDK の事前経験は不要です。
8 つのガイド付きラボと、承認を修復する 1 つの自主課題で構成されています。各スキルをガイド付きラボで学んでから自主課題に進みます。
学習する内容
- 名前付きサポート Agent を作成する： 安定した名前をルーティングし、サポート状態を永続化し、Agent インスタンス間の分離を確認する。
- サポートダッシュボードを同期する： 2 つのブラウザークライアントを接続し、サーバーが管理する状態のリアルタイム更新を観察する。
- 永続的な会話をストリーミングする： 限定した回答を配信し、再接続後に永続的な会話履歴を復元する。
- サポートのフォローアップを予定する： 永続的な Agent タスクを登録、確認、完了、キャンセルする。
- 検証済みサポートツールを追加する： スキーマとサーバー側の範囲確認を使い、モデルが選ぶツールを架空のレコードに接続する。
- レコード変更に承認を要求する： 人の判断を待つために副作用を停止し、繰り返し配信を安全にする。
- 読み取り専用 MCP ツールを公開する： 厳密に検証した架空の検索を、リモート MCP トランスポートで提供する。
- 誤った Agent セッションを診断する： 履歴を失わず、分離を弱めずに、選択された Agent 名を修復する。
- 未承認のサポート更新： 提供された Agent の、作用前の承認と厳密に 1 回の動作を自主的に修復する。
このコースの対象者
Workers と Durable Objects に慣れており、状態を持つアシスタントと協調するクライアントを構築したい開発者が対象です。
前提知識： Cloudflare Durable Objects for Beginners と Connect LabEx to Your Cloudflare Account を完了してください。小さな TypeScript Worker と、安定した名前ごとに 1 つの Durable Object を持つ考え方を理解している必要があります。Agents SDK 自体は最初から説明します。
学習環境： 自分の専用 Cloudflare 学習用アカウントを使います。各ユニットは新しい VM で始まり、Wrangler を個別に認可し、一意の名前の使い捨てリソースを作成し、削除とログアウトで終わります。演習のリソースは Workers Free の範囲内に限定します。モデルを使うラボは Cloudflare がホストする推論を少数回だけ呼び出します。
よくある質問
Agents SDK や AI の事前経験は必要ですか？
Agents SDK の事前経験は不要です。最初の 2 つのラボは AI モデルを使わず、名前付きアイデンティティ、永続状態、同期クライアントを先に学びます。モデルを使うラボには Workers AI の基礎が必要です。
モデルはレコードを直接変更できますか？
提案されたツール呼び出しは、スキーマとサーバー側の範囲確認を通過する必要があります。承認ラボは、人の判断を待つために副作用を停止し、繰り返し配信を安全にします。自主課題は、作用の前に承認があることを確認します。
クライアントが再接続するとどうなりますか？
選択された Agent のアイデンティティ、永続会話、サーバーが管理する状態を、1 つのブラウザー接続と区別します。有効な履歴を捨てずに、誤った経路のセッションも修復します。
リソースはどうクリーンアップしますか？
認可が有効な間に、ラボの使い捨て Worker とオブジェクト名前空間だけを削除し、削除を確認してからログアウトします。各 VM は自分のアカウントを独立して認可します。
