Repolode
cloudflare

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. 1

    スターターテンプレートから新しいプロジェクトを作成する

    npm create cloudflare@latest -- --template cloudflare/agents-starter
  2. 2

    または、既存のプロジェクトにSDKを追加する

    npm install agents
  3. 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 の数値は毎日更新されます。

関連プロジェクト