A2A 中的核心概念和组件

A2A 使用一组核心概念来定义智能体如何交互。理解这些核心构建块以开发或集成符合 A2A 标准的系统。

A2A 交互中的核心参与者

• 用户：最终用户，可以是人类操作员或自动化服务。用户发起请求或定义需要一个或多个 AI 智能体协助的目标。
• A2A 客户端（客户端智能体）：代表用户操作的应用程序、服务或其他 AI 智能体。客户端使用 A2A 协议发起通信。
• A2A 服务器（远程智能体）：暴露实现 A2A 协议的 HTTP 端点的 AI 智能体或智能体系统。它接收来自客户端的请求，处理任务，并返回结果或状态更新。从客户端的角度来看，远程智能体作为不透明（黑盒）系统运行，意味着其内部工作原理、内存或工具不被暴露。

基本通信元素

下表描述了 A2A 中的基本通信元素：

元素	描述	主要目的
Agent Card	描述智能体身份、能力、端点、技能和身份验证要求的 JSON 元数据文档。	使客户端能够发现智能体并了解如何安全有效地与它们交互。
任务	由智能体启动的有状态工作单元，具有唯一 ID 和定义的生命周期。	促进长时间运行操作的跟踪，并支持多轮交互和协作。
消息	客户端和智能体之间的一次通信，包含内容和角色（"user" 或 "agent"）。	传达指令、上下文、问题、答案或状态更新，这些不一定是正式工件。
部分	在消息和工件中使用的基本内容容器（例如，TextPart、FilePart、DataPart）。	为智能体在消息和工件中交换各种内容类型提供灵活性。
工件	智能体在任务处理期间生成的有形输出（例如，文档、图像或结构化数据）。	交付智能体工作的具体结果，确保结构化和可检索的输出。

交互机制

A2A 协议支持各种交互模式，以适应不同的响应性和持久性需求。这些机制确保智能体能够高效可靠地交换信息，无论任务的复杂性或持续时间如何：

• 请求/响应（轮询）：客户端发送请求，服务器响应。对于长时间运行的任务，客户端定期轮询服务器以获取更新。
• 服务器发送事件（SSE）流式传输：客户端启动流，在开放的 HTTP 连接上从服务器接收实时、增量的结果或状态更新。
• 推送通知：对于非常长时间运行的任务或断开连接的场景，当发生重要任务更新时，服务器可以主动向客户端提供的 webhook 发送异步通知。

有关流式传输和推送通知的详细探索，请参阅流式传输和异步操作文档。

Agent Card

Agent Card 是一个 JSON 文档，作为初始发现和交互设置的数字名片。它提供有关智能体的基本元数据。客户端解析此信息以确定智能体是否适合给定任务、如何构建请求以及如何安全通信。关键信息包括身份、服务端点（URL）、A2A 能力、身份验证要求和技能列表。

消息和部分

消息代表客户端和智能体之间的一次通信。它包括一个角色（"user" 或 "agent"）和一个唯一的 messageId。它包含一个或多个部分对象，这些是实际内容的细粒度容器。这种设计使 A2A 能够独立于模态。

主要部分类型包括：

• TextPart：包含纯文本内容。
• FilePart：表示文件。可以通过内联（Base64 编码）或 URI 传输。它包括"filename"和"mimeType"等元数据。
• DataPart：携带结构化 JSON 数据。这对于表单、参数或任何机器可读信息很有用。

工件

工件代表远程智能体在任务处理期间生成的有形输出或具体结果。与一般消息不同，工件是实际的交付物。工件具有唯一的 artifactId、人类可读的名称，并由一个或多个部分对象组成。工件与任务生命周期密切相关，可以增量流式传输到客户端。

智能体响应：任务或消息

智能体响应可以是新 Task（当智能体需要执行长时间运行的操作时）或 Message（当智能体可以立即响应时）。

更多详情，请参见任务的生命周期。

其他重要概念

• 上下文（contextId）： 服务器生成的标识符，可用于逻辑上分组多个相关的 Task 对象，在一系列交互中提供上下文。
• 传输和格式： A2A 通信通过 HTTP(S) 进行。JSON-RPC 2.0 用作所有请求和响应的有效载荷格式。
• 身份验证和授权： A2A 依赖于标准的 Web 安全实践。身份验证要求在 Agent Card 中声明，凭证（例如 OAuth 令牌、API 密钥）通常通过 HTTP 头部传递，与 A2A 协议消息本身分开。更多信息请参见企业就绪功能。
• 智能体发现： 客户端查找 Agent Card 以了解可用 A2A 服务器及其能力的过程。更多信息请参见智能体发现。
• 扩展： A2A 允许智能体在其 Agent Card 中声明自定义协议扩展。更多信息请参见扩展。