メモリ、ツール、MCP、RAG、音声、ワークフローを備えたAIエージェントを構築するTypeScriptフレームワーク。可観測性を提供するVoltOpsコンソールも付属。
cloudflare/agents
Cloudflare Durable Objects上で、リアルタイムの状態同期、スケジューリング、MCPに対応した永続的なステートフルAIエージェントを構築するTypeScript SDK。
- スター
- 5,854
- フォーク
- 787
- 未解決の Issue
- 171
- 最終コミット
- 7 時間前
これは何?
Cloudflare Agentsは、CloudflareのDurable Objects上でAIエージェントを永続的なステートフル単位として実行するためのSDKです。各エージェントは独自の状態とストレージを保持し、アイドル時には休止して、必要に応じて起動します。そのため、ユーザー、セッション、ゲームルームごとにエージェントを作成できます。
コアパッケージの`agents`には、接続中のクライアントと状態をリアルタイムに同期する基本のAgentクラス、`@callable()`デコレーターで公開する呼び出し可能なメソッド、スケジューリング、WebSockets、SQLクエリ、AIモデル呼び出しの組み込みサポートが用意されています。フロントエンド連携には、`useAgent`や`useAgentChat`などのReact hooksのほか、vanilla JSクライアントを利用できます。
このリポジトリはpnpmのモノレポで、AIチャット、LLMに実行可能なTypeScriptを書かせるCode Mode方式、Workersランタイムのバンドラー、Honoミドルウェアの各パッケージに加え、30以上のサンプルアプリも含まれています。
主な機能
- 01接続中のすべてのクライアントとリアルタイムに同期する、永続的なエージェント状態
- 02`@callable()`デコレーターによる型安全な呼び出し可能メソッド
- 03単発、繰り返し、cronベースのタスクスケジューリング
- 04MCPサーバーとクライアントのサポート
- 05人間による承認を含む、永続的な複数ステップのワークフロー
- 06フロントエンド連携用のReact hooksとvanilla JSクライアント
ユースケース
- 永続的なメモリとチャット履歴を備えた、ユーザーごとのAIアシスタントの構築
- 各ルームをエージェントとして扱う、リアルタイムのマルチプレイヤーゲームルームの作成
- Cloudflare Workers上でホストするMCPサーバーを通じた、LLMへのツール公開
- AIモデルを呼び出すスケジュール実行のバックグラウンドジョブ
クイックスタート
- 1
スターターテンプレートから新しいプロジェクトを作成する
npm create cloudflare@latest -- --template cloudflare/agents-starter - 2
または、既存のプロジェクトにSDKを追加する
npm install agents - 3
リポジトリからサンプル(playgroundなど)をローカルで実行する
cd examples/playground npm start
使う前に知っておきたいこと
- Cloudflare Durable Objectsを基盤としているため、Cloudflareプラットフォーム上での実行を前提に設計されています。
- 現在、外部からのプルリクエストは受け付けていません。
トピック
よくある質問
- agents とは?
- Cloudflare Durable Objects上で、リアルタイムの状態同期、スケジューリング、MCPに対応した永続的なステートフルAIエージェントを構築するTypeScript SDK。 Cloudflare Agentsは、CloudflareのDurable Objects上でAIエージェントを永続的なステートフル単位として実行するためのSDKです。各エージェントは独自の状態とストレージを保持し、アイドル時には休止して、必要に応じて起動します。そのため、ユーザー、セッション、ゲームルームごとにエージェントを作成できます。
- agents は無料で使えますか?ライセンスは?
- agents は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- agents は今もメンテナンスされていますか?
- 活発にメンテナンス中。agents の最終コミットは 2026年10月20日 です。
- agents は何に使えますか?
- 永続的なメモリとチャット履歴を備えた、ユーザーごとのAIアシスタントの構築 各ルームをエージェントとして扱う、リアルタイムのマルチプレイヤーゲームルームの作成 Cloudflare Workers上でホストするMCPサーバーを通じた、LLMへのツール公開 AIモデルを呼び出すスケジュール実行のバックグラウンドジョブ
- agents のインストール方法は?
- スターターテンプレートから新しいプロジェクトを作成する: npm create cloudflare@latest -- --template cloudflare/agents-starter または、既存のプロジェクトにSDKを追加する: npm install agents リポジトリからサンプル(playgroundなど)をローカルで実行する: cd examples/playground npm start
- agents はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/cloudflare/agents
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
PythonとTypeScriptで、ツール、MCP、メモリ、モデルのポータビリティを備えたAIエージェントを構築・実行するためのオープンソースSDK。
AIエージェントに1,000以上の認証済みアプリツールキット、ユーザーごとのセッション、アクション実行用サンドボックスを提供するTypeScript・Python SDK。
あらゆるWebページにGUIエージェントを組み込み、自然言語で操作できるJavaScriptライブラリ。
ワークフロー、ツール、メモリ、MCPサーバー、評価機能を備えた、AIエージェントやLLM搭載アプリを構築するためのTypeScriptフレームワーク。
AIエージェントやIDE、アプリを、事前定義ツールまたはカスタムツールでデータベースにつなぐオープンソースのMCPサーバー。