agentclientprotocol/python-sdk

解决的问题

该项目提供了一个 Agent Client Protocol (ACP) 的 Python SDK，使开发者能够构建使用标准化协议进行通信的代理和客户端。它消除了开发者手动实现传输层、模式验证和事件流易用性等需求，这些功能在不同 AI 代理框架中通常分散且不一致。

工作原理

SDK 提供了根据最新 ACP 模式自动生成的 Pydantic 模型，确保数据负载始终符合规范。它使用 asyncio 传输和 stdio JSON-RPC 机制来处理代理与客户端之间的通信。此外，还包含基础类和生命周期辅助工具，以减少创建自定义代理所需的样板代码。

适用人群

• 代理作者：希望创建具有类型模型和事件流支持的 ACP 兼容助手的开发者。
• 客户端集成者：希望将 ACP 代理嵌入 Python 应用程序，或通过 stdio 包装现有 CLI 的开发者。
• 工具团队：正在实验权限流程、流式用户体验或 Gemini 桥接的团队。

主要亮点

• 规范一致性：Pydantic 模型从上游 ACP 模式自动生成，确保与规范完全一致。
• 异步支持：内置异步基类和 JSON-RPC 机制，实现高效通信。
• 开箱即用的示例：包含流式传输、权限控制和 Gemini 桥接的演示示例。
• 贡献工具：提供会话累加器和工具调用追踪器，简化实际部署。