cloudflare/agents

Build and deploy AI Agents on Cloudflare

What it solves

Cloudflare Agents は、エージェント型ワークロードのための永続的でステートフルな実行環境を構築・展開するためのフレームワークを提供します。アイドル時に休眠し、オンデマンドで起動する、数百万もの個別のエージェント（例：ユーザーやセッションごとに 1 つ）のライフサイクル、状態、通信を管理する問題を解決します。これにより、コストと運用オーバーヘッドを削減できます。

How it works

Cloudflare Durable Objects 上に構築されており、各エージェントは独自のストレージとライフサイクルを持つステートフルなエンティティです。このフレームワークは、@callable() デコレータを通じて型安全な RPC システムを提供し、クライアントがエージェントのメソッドをローカル関数のように呼び出せるようにします。WebSocket を介して状態の変化をリアルタイムに同期し、AI モデル、MCP (Model Context Protocol)、および永続的なマルチステップ・ワークフローをサポートします。

Who it’s for

AI エージェント、リアルタイム共同作業アプリケーション、またはエッジで永続的な状態と AI 統合が必要なステートフルサービスを構築する開発者。

Highlights

  • Persistent State: 状態は再起動後も維持され、接続されているすべてのクライアントに自動的に同期されます。
  • AI Capabilities: AI チャット、音声パイプライン (STT/TTS)、および LLM が実行可能な TypeScript コードを生成する "Code Mode" 用の専用パッケージが含まれています。
  • Sandboxed Execution: 仮想ファイルシステムを備えた隔離された Worker で LLM 生成コードを実行する機能。
  • MCP Support: エージェントの機能を拡張するために、MCP サーバまたはクライアントとして動作できます。
  • Infrastructure Integration: スケジューリング、メール、送信、x402 pay-per-call 決済をサポートしています。
  • Frontend Integration: 専用の React hooks (useAgent, useAgentChat) により、シームレスなフロントエンド接続を実現します。