dapr/dapr-agents

Build autonomous, resilient and observable AI agents with built-in workflow orchestration, security, statefulness and telemetry.

Dapr Agents – プロダクションレベルのAIエージェントシステムを構築するためのフレームワーク

何であるか – Dapr Agents はオープンソースのPython SDK（および対応するランタイム）であり、大規模言語モデル（LLMs）を使って推論・行動・協働を行う エージェント型 アプリケーションを記述できるようにします。Daprの検証済みコンポーネント（スケーラビリティ、レジリエンス、オブザーバビリティ）に依存することで、信頼性の高い分散AIエージェントの開発が可能になります。

なぜ重要か – 信頼性の高い分散AIエージェントを構築するのは難しいです：ステートの永続化、リトライ、サービスディスカバリ、セキュアな通信、多数のデータソースとの統合が必要です。Dapr Agentsはその複雑さを隠蔽します。各エージェントはDaprの アクター（軽量で状態を持つコンピューティングユニット）として実行され、Daprの耐久実行エンジンでマルチステップのワークフローをオーケストレーションするため、クラッシュやネットワーク障害後も中断した場所から継続できます。

コア機能（READMEに記載）

機能	得られるもの
スケーラビリティと効率性	数千のエージェントが1つのCPUコアを共有可能。Daprがクラスタ全体で作業を自動的に分散します。
ワークフローのレジリエンス	エージェントのタスクの各ステップに対して自動リトライとステートの回復が可能。
Kubernetesネイティブ	エージェントを通常のDapr対応サービスとしてデプロイ。サイドカーがネットワーキング、シークレット、スケーリングを処理します。
データ駆動型	50以上のエンタープライズデータソース（例：PDF、データベース、メッセージキュー）に即座にアクセスできる組み込みバインディングとステートストア。
マルチエージェント協働	セキュアで観測可能なサービス間呼び出しとPub/Subにより、エージェント同士や外部サービスと通信可能。
ベンダー非依存	任意のクラウドまたはオンプレ環境で動作。複数のLLMプロバイダーをサポート。
AI専用ヘルパー	構造化出力、ツール選択、文脈記憶、柔軟なプロンプティング、ゼロ構成のMCPServerツール発見。
セキュリティと信頼性	mTLS暗号化、Daprのレジリエンスポリシー（タイムアウト、リトライ、セミコンダクターブレーカー）、細粒度のアクセススコープ。

一般的なエージェントの例（READMEからのPythonコード）

from dapr_agents import DurableAgent

agent = DurableAgent(
    name="my-agent",
    role="マルチツールアシスタント",
    runtime=workflow_runtime,
)  # MCPServerツールは自動発見 – 追加設定不要

エージェント起動時に、Dapr AgentsはローカルのDaprサイドカーからロードされた MCPServer リソースを照会し、ツール定義を取得してワークフローのステップとして登録します。開発者はビジネスロジックのみを記述すればよく、発見、ステート、リトライはフレームワークが処理します。

クイックスタート（導入チェックリスト）

前提条件のインストール – Dapr CLI、Python ≥ 3.11、および uv パッケージマネージャ。
Daprの初期化 – dapr init でローカルにサイドカーをセットアップ。
SDKの追加 – uv add dapr-agents（または pip install dapr-agents）。
クイックスタートの実行 – リポジトリにはステップバイステップのチュートリアルが含まれており、シンプルなエージェントの作成、データソースへの接続、スケーリングの方法を紹介しています。
例の探索 – MCPServerの自動発見を含むより完全なデモは examples/ ディレクトリにあります。

どの人にとって適しているか

プラットフォームチーム：KubernetesやオンプレクラスタでAIエージェントをスケールして運用する標準的な方法が必要な場合。
開発者：マルチエージェントワークフロー、リトリーバル増強生成パイプライン、複数の呼び出しにわたって文脈を保持する必要がある自律アシスタントを開発する場合。
企業：ベンダーロックインを避け、AIロジックを自社のセキュリティおよびオブザーバビリティスタックの後ろに保ちたい場合。

コミュニティと貢献

CNCFプロジェクト：クラウドネイティブコンピューティングファウンデーション（CNCF）の下で運営。
Discord & YouTube：ヘルプとニュースのための活発なチャネル。
貢献方法：リポジトリのコードオブコンダクトに従い、開発には uv を使用し、テストスイートを実行（uv run pytest）。
ロードマップ：Pythonサポートは2025年Q4の安定版リリースを予定。他の言語バインディングも計画中。

TL;DR

Dapr Agentsは、スケーラビリティ、障害耐性、データベースや他のエージェントとの通信、セキュリティを備えたプロダクションレベルのAIエージェント開発プラットフォームを提供します。分散システムのインフラ（プラumbing）に悩まず、LLM駆動のロジックに集中できます。