Agent Communication Protocol (ACP)

---

🚀 重要更新

ACP 现已加入 Linux 基金会旗下的 A2A 项目！

👉 了解更多 | 🛠️ 迁移指南

---

ACP 是一种用于 AI Agent、应用程序和人类之间通信的开放协议。

现代 AI Agent 通常在不同的框架、团队和基础设施中孤立地构建。这种碎片化阻碍了创新，并使 Agent 难以有效协同工作。ACP 通过支持 Agent 使用多模态消息进行通信和协调，解决了这一问题。

ACP 支持 Agent 实现以下功能：

• 发送和接收富文本消息——例如文本、代码、文件或媒体
• 以实时、后台处理或流式传输的方式响应
• 让其他方发现其能力
• 针对长期运行的任务进行协作
• 在需要时彼此共享状态

ACP 为 BeeAI Platform 的 Agent 通信提供支持——这是一个你可以发现、运行和分享 Agent 的平台。

学习 ACP

通过这门 DeepLearning.AI 短课程，获取 ACP 的实操入门指导：

更新日志

• 🧭 轨迹元数据 (Trajectory Metadata) - 增强了 MessagePart，引入 TrajectoryMetadata 以追踪多步推理和工具调用。
• 🌐 分布式会话 (Distributed Sessions) - 通过基于 URI 的资源共享实现跨多个服务器实例的会话连续性。
• 🔍 RAG LlamaIndex Agent - 新的示例 Agent，展示了如何使用 LlamaIndex 进行检索增强生成 (RAG)。
• 📚 引用元数据 (Citation Metadata) - 增强了 MessagePart，引入 CitationMetadata 以改进来源追踪和归因。
• ⚡ 高可用性支持 (High Availability Support) - 支持通过中心化存储（Redis/PostgreSQL）部署 ACP 服务器，实现可扩展且容错的架构。
• 📝 消息角色参数 (Message Role Parameter) - 在 Message 结构中增加了 role 参数，以实现更好的 Agent 识别。
• 🔄 TypeScript SDK (Client) - 用于与 ACP Agent 交互的完整 TypeScript 客户端库。

ACP 工具包

• 📚 文档：关于实现和使用 ACP 的综合指南与参考资料。
• 📝 OpenAPI 规范：定义了构成 ACP 协议的 REST API 端点、请求/响应格式和数据模型。
• 🛠️ Python SDK：包含服务器实现、客户端库和模型定义，方便轻松创建并与 ACP Agent 交互。
• 🛠️ TypeScript SDK：包含客户端库和模型定义，方便轻松与 ACP Agent 交互。
• 💻 示例：即用型代码示例，展示了如何构建使用 ACP 进行通信的 Agent 和客户端。

核心概念

概念	描述
Agent 清单 (Agent Manifest)	一个描述 Agent 能力的模型（包含名称、描述以及可选的元数据和状态），用于发现和组合，而无需暴露实现细节。
运行 (Run)	带有特定输入的一次 Agent 执行。支持同步或流式传输，包含中间输出和最终输出。
消息 (Message)	核心结构