agentclientprotocol/python-sdk

何を解決するか

このプロジェクトは、Agent Client Protocol (ACP) 用の Python SDK を提供し、開発者が標準化されたプロトコルを使って通信できるエージェントとクライアントを構築できるようにします。開発者がトランスポート層、スキーマ検証、イベントストリームの使いやすさを手動で実装する必要がなくなり、これらは通常、さまざまな AI エージェントフレームワーク間で断片化されています。

動作方法

SDK は最新の ACP スキーマに準拠した有効なペイロードを保証する、生成された Pydantic モデルを提供します。asyncio トランスポートと stdio JSON-RPC プラumbing を使用して、エージェントとクライアント間の通信を処理します。また、カスタムエージェントを作成するために必要なボイラープレートコードを減らすためのベースクラスとライフサイクルヘルパーも含まれています。

対象ユーザー

• エージェント作成者：型付きモデルとイベントストリームサポートを備えた ACP 互換のアシスタントを作成したい人。
• クライアント統合者：Python アプリケーションに ACP エージェントを埋め込みたい人、または stdio を介して既存の CLI をラップしたい人。
• ツールチーム：権限フロー、ストリーミング UX、または Gemini ブリッジの実験を行っている人。

主な特徴

• 仕様の整合性：上流の ACP スキーマから自動生成された Pydantic モデルにより、一貫性を維持します。
• asyncio サポート：効率的な通信のための組み込み非同期ベースクラスと JSON-RPC プラumbing。
• 即時利用可能な例：ストリーミング、権限、Gemini ブリッジのデモを含む。
• 貢献用ユーティリティ：セッションアキュムレーターやツールコールトラッカーを提供し、実際の展開を簡素化します。