标签 http 下的文章

AI新宠?解读MCP、A2A为何偏爱JSON-RPC 2.0

本文永久链接 – https://tonybai.com/2025/04/16/ai-protocol-prefer-jsonrpc

大家好,我是Tony Bai。

在AI技术飞速演进的今天,底层通信协议的选择对系统效率和互操作性至关重要。细心的开发者可能已经发现,新兴的AI协议如模型上下文协议(MCP)Agent2Agent(A2A)协议,都不约而同地将目光投向了JSON-RPC 2.0。这并非巧合,而是一个深思熟虑的技术选型。在这篇文章中,我将和大家一起看看JSON-RPC 2.0的起源、核心规范以及历史应用,并解读这个10多年前定义的“老协议”为何能在AI时代能再次获得青睐。

1. JSON-RPC 2.0:起源与核心规范

JSON-RPC协议的诞生,源于对早期RPC协议(如XML-RPCSOAP)复杂性的反思,旨在提供一种更轻量、更简洁的远程过程调用机制。其2.0版本规范(基于2009年草案,正式发布于2010年左右)更是将这一理念发扬光大。其核心设计哲学正如规范开篇所言:“It is designed to be simple!”

很多开发者日常都是用过JSON-RPC 2.0,但可能没有对其规范做过深入的了解,借此篇文章机会,让我们依据其官方规范,深入了解其关键特性。。

1.1 核心原则

我们先来看一下JSON-RPC协议设计的几个核心原则。

  • Stateless (无状态): 每次请求都是独立的,服务器不保存客户端状态。
  • Light-weight (轻量级): 协议开销小,消息体紧凑。
  • JSON Data Format (JSON数据格式): 使用广泛流行、易于解析和人类可读的JSON(RFC 4627) 作为数据交换格式。
  • Transport Agnostic (传输无关): 协议本身不限定网络传输方式,可在HTTP、WebSocket、TCP、甚至进程内等多种环境使用。

接下来,我们再来看一下工作原理。JSON-RPC 2.0是一个相对简单的协议,其规范也就几页,因此其工作原理也非常好理解。

1.2 工作原理

JSON-RPC 的工作原理是向实现此协议的服务器发送请求。在这种情况下,客户端通常是打算调用远程系统的单个方法的软件。多个输入参数可以作为数组或对象传递给远程方法,而方法本身也可以返回多个输出数据(这取决于实现的版本。)

下面是对协议中的一些核心对象的解读。

1.2.1 Request Object (请求对象)

Request Object是发起RPC调用的核心,由客户端发送请求到服务端。我们结合一个示例来理解请求对象的各个字段的含义:

--> {"jsonrpc": "2.0", "method": "subtract", "params": {"minuend": 42, "subtrahend": 23}, "id": 4}
<-- {"jsonrpc": "2.0", "result": 19, "id": 4}
  • jsonrpc: 必须是”2.0″,这是区分版本的关键标识。
  • method: 是一个字符串类型的必选字段,表示要调用的方法名。以rpc.开头的为保留方法。
  • params: 是一个可选参数,它是一个结构化值Array或Object,包含调用方法所需的参数。

JSON-RPC支持两种传递params的方式,一种是By-name(按名称),即params是一个对象,其成员名与服务器期望参数名匹配,比如上面示例中params使用的就是一个by-name的参数传递方式。另外一种是By-position (按位置),即params是一个数组,值按服务器期望顺序排列。比如上面示例中params等价为下面按位置传递方式的params:

{"jsonrpc": "2.0", "method": "subtract", "params": [42, 23], "id": 1}
  • id: 是一个字符串或数字类型的值,用于关联请求和响应。比如上面示例中,请求的id=4,其对应的响应(Response)的id也应该为4才能匹配成功。

1.2.2 Response Object (响应对象)

上面的示例中的第二行其实是一个Repsonse Object,即服务器针对有效请求(非通知类)的回复:

<-- {"jsonrpc": "2.0", "result": 19, "id": 4}
  • jsonrpc: 必须是”2.0″,这是区分版本的关键标识。
  • result: 包含方法调用的成功结果。如果rpc调用失败,那么响应中不有result字段,可以说与下面的error是二取一的。
  • error: 包含一个Error Object。如果rpc调用没有错误发生,响应体中不应该存在error字段。
  • id: 与对应请求对象中的id一致。如果检测请求id出错(比如解析出错或非法请求),则应为Null,比如下面这个示例:

下面是返回错误码的示例:

--> {"jsonrpc": "2.0", "method": 1, "params": "bar"} // method值不是字符串,不是一个合法的请求对象
<-- {"jsonrpc": "2.0", "error": {"code": -32600, "message": "Invalid Request"}, "id": null}

再强调一下:result 和 error 成员互斥,必须存在其一。

1.2.3 Error Object (错误对象)

错误对象用于描述发生的错误,对象有三个字段:

  • code: 错误码,类型为整数,指示错误类型。-32768到-32000 为预定义错误码范围。下面是一些典型错误code:
    • -32700: Parse error
    • -32600: Invalid Request
    • -32601: Method not found
    • -32602: Invalid params
    • -32603: Internal error
    • -32000 to -32099: Server error
  • message: 错误信息,字符串类型,用于简短描述错误。
  • data: 可选,代表原始值或结构化值,包含额外错误信息。

下面是一个错误对象示例:

--> {"jsonrpc": "2.0", "method": "foobar", "id": "1"}
<-- {"jsonrpc": "2.0", "error": {"code": -32601, "message": "Method not found"}, "id": "1"}

1.2.4 Notification通知

Notification通知一种特殊的Request,它没有id成员。表示客户端不关心响应,服务器也不用回复,适用于无需确认的操作。比如下面这个示例:

--> {"jsonrpc": "2.0", "method": "update", "params": [1,2,3,4,5]}

也就是说当一个合法的Request中没有id,则可以认为是Notification通知。

1.2.5 Batch批量调用

Batch批量调用是指客户端可能发送一个包含多个Request对象的数组,以实现批量处理。服务器应该返回一个包含对应Response对象的数组(通知除外)。请求处理和响应返回可以是无序的,客户端通过id匹配。下面是一个批量调用的示例:

--> [
        {"jsonrpc": "2.0", "method": "sum", "params": [1,2,4], "id": "1"},
        {"jsonrpc": "2.0", "method": "notify_hello", "params": [7]},
        {"jsonrpc": "2.0", "method": "subtract", "params": [42,23], "id": "2"},
        {"foo": "boo"},
        {"jsonrpc": "2.0", "method": "foo.get", "params": {"name": "myself"}, "id": "5"},
        {"jsonrpc": "2.0", "method": "get_data", "id": "9"}
    ]
<-- [
        {"jsonrpc": "2.0", "result": 7, "id": "1"},
        {"jsonrpc": "2.0", "result": 19, "id": "2"},
        {"jsonrpc": "2.0", "error": {"code": -32600, "message": "Invalid Request"}, "id": null},
        {"jsonrpc": "2.0", "error": {"code": -32601, "message": "Method not found"}, "id": "5"},
        {"jsonrpc": "2.0", "result": ["hello", 5], "id": "9"}
    ]

2. JSON-RPC的“前世今生”:应用场景

自诞生以来,JSON-RPC凭借其简洁、轻量、易于实现和跨语言的特性,在多个领域得到了广泛应用,满足了开发者对“高效”通信的需求:

  • Web APIs: 作为RESTful API的一种替代或补充,尤其是在需要明确“过程调用”语义的场景。
  • 微服务架构: 服务间的内部通信,特别是在追求低延迟、简单交互的场景下,比HTTP REST更轻量。
  • 消息队列(Message Queues): 作为消息体格式,在基于消息队列的异步任务处理系统中定义任务和传递结果。
  • 桌面应用与Web端交互: 例如,本地应用通过WebSocket与网页前端进行双向通信。
  • 物联网(IoT): 资源受限设备间的通信,其轻量特性非常适合。
  • 区块链节点通信: 一些区块链项目使用JSON-RPC作为节点间或客户端与节点间交互的标准接口。

这些应用场景充分证明了JSON-RPC作为一种基础通信协议的普适性和生命力

3. 为何AI时代再次垂青?MCP/A2A 的选择逻辑

MCP和A2A是AI领域新兴的协议,旨在为日益复杂的AI系统(如多模型协作、Agent智能体交互)提供标准化的通信框架,解决互操作性问题。 那么,JSON-RPC 2.0究竟凭借哪些优势,在众多协议中脱颖而出,被MCP、A2A等选中呢?下面我们就来看看JSON-RPC的优势。

  • 极致简洁,降低开发与理解成本

JSON-RPC 2.0 使用人类可读的 JSON 格式。其规范非常简单,定义清晰,无论是开发者学习、实现客户端/服务端,还是调试网络通信,成本都相对较低。这在需要快速迭代和广泛协作的AI领域尤为重要。

  • 跨语言跨平台,适应AI生态多样性

AI的开发涉及Python、Java、Go、Rust等多种语言和框架。JSON-RPC的简洁性和文本基础使其极易在不同语言和平台间实现互操作,为构建异构AI系统提供了基础通信能力,某种程度上提供了通信层面的“一站式解决方案”的可能性。

  • 传输协议无关,提供高度灵活性

JSON-RPC 2.0本身不绑定具体的网络传输协议。它可以承载于HTTP(S)、WebSocket、TCP、消息队列等多种传输层之上。这种灵活性使得它可以适应不同的部署环境和通信需求,无论是需要低延迟长连接的Agent交互,还是简单的模型服务调用。

  • 成熟稳定,生态工具丰富

作为一个存在已久的协议,JSON-RPC 2.0拥有大量成熟的库和工具支持,覆盖了几乎所有主流编程语言。这意味着开发者可以快速集成,将更多精力投入到核心的AI逻辑开发上,而不是在基础通信协议上“重复造轮子”,符合用户“要更高效”的心理。比如:golang.org/x/exp/jsonrpc2就是Go team维护的一个高质量JSON-RPC 2.0的实现。

  • 清晰的请求-响应模式,契合常见AI服务调用

JSON-RPC明确的请求(方法名、参数)和响应(结果、错误)结构,非常适合表示AI服务中的函数调用、查询等交互模式,使得接口定义和理解更加直观,有助于提升开发和沟通效率。

  • 易于扩展

JSON-RPC协议本身简洁,但params和data字段提供了足够的扩展空间来承载复杂的AI特定数据结构。

以上JSON-RPC协议的核心特点与AI时代需求的高度契合

4. 小结:大道至简,务实之选

综上所述,JSON-RPC 2.0并非昙花一现的“新宠”,而是凭借其诞生之初的简洁设计、久经考验的稳定性、广泛的跨平台能力以及与当前AI通信需求的天然契合,在AI时代焕发了新的生机。MCP、A2A等协议选择它,正是看中了其作为通信基石的扎实、高效和务实

对于JSON-RPC在AI领域的应用,以及未来可能出现的更优协议,你有何看法?欢迎在评论区分享你的真知灼见!

关注我,持续获取有深度的AI与技术解析。


Gopher部落知识星球在2025年将继续致力于打造一个高品质的Go语言学习和交流平台。我们将继续提供优质的Go技术文章首发和阅读体验。并且,2025年将在星球首发“Gopher的AI原生应用开发第一课”、“Go陷阱与缺陷”和“Go原理课”专栏!此外,我们还会加强星友之间的交流和互动。欢迎大家踊跃提问,分享心得,讨论技术。我会在第一时间进行解答和交流。我衷心希望Gopher部落可以成为大家学习、进步、交流的港湾。让我相聚在Gopher部落,享受coding的快乐! 欢迎大家踊跃加入!

img{512x368}
img{512x368}

img{512x368}
img{512x368}

著名云主机服务厂商DigitalOcean发布最新的主机计划,入门级Droplet配置升级为:1 core CPU、1G内存、25G高速SSD,价格6$/月。有使用DigitalOcean需求的朋友,可以打开这个链接地址:https://m.do.co/c/bff6eed92687 开启你的DO主机之路。

Gopher Daily(Gopher每日新闻) – https://gopherdaily.tonybai.com

我的联系方式:

  • 微博(暂不可用):https://weibo.com/bigwhite20xx
  • 微博2:https://weibo.com/u/6484441286
  • 博客:tonybai.com
  • github: https://github.com/bigwhite
  • Gopher Daily归档 – https://github.com/bigwhite/gopherdaily
  • Gopher Daily Feed订阅 – https://gopherdaily.tonybai.com/feed

商务合作方式:撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。

告别智能体孤岛:谷歌A2A协议能否成为企业AI协作的通用语?

本文永久链接 – https://tonybai.com/2025/04/14/what-is-a2a-protocol

随着人工智能(AI)的飞速发展,AI 智能体(Agent)正成为企业自动化、提升生产力的关键力量。从处理日常重复任务到辅助复杂决策,智能体的应用场景日益广泛。然而,一个严峻的挑战随之而来:不同框架、不同厂商构建的智能体往往如同信息孤岛,难以有效协作,这极大地限制了它们在复杂企业环境中的潜力释放。

为了打破这一僵局,谷歌近日联合 Atlassian、Salesforce、SAP、LangChain、Cohere 等超过 50 家技术合作伙伴和领先服务提供商,共同发布并推动一个全新的开放协议——Agent2Agent(A2A)。该协议旨在为不同生态系统中的AI智能体提供一种标准的通信语言,使其能够安全地发现彼此、交换信息、协调行动,最终实现跨平台、跨应用的无缝协作。

在这篇文章中,我们就来结合示例快速了解一下A2A协议的设计哲学、核心机制、交互流程与对象模型,以及它与MCP(model context protocol)的区别。这可能是你看过的关于Agent互操作协议最清晰的解读之一。

1. A2A协议的设计哲学与核心机制

企业环境中,单一智能体往往难以应对复杂的端到端流程。例如,一个完整的客户服务请求可能需要客服智能体、订单系统智能体、物流跟踪智能体协同工作。A2A协议的诞生,正是为了满足这种日益增长的跨系统、跨智能体协作需求。

A2A的核心目标是促进智能体之间的互操作性(Interoperability),即使这些智能体基于不同的技术栈构建、不共享内部状态或工具集。谷歌及其合作伙伴在设计A2A时,明确了五大关键原则,这些原则深刻影响了协议的形态:

  • 拥抱智能体能力 (Embrace agentic capabilities)

协议并非将智能体降级为简单的 API 或工具,而是承认并支持它们以更自然、有时甚至是非结构化的方式进行交互和协作。

  • 基于现有标准 (Build on existing standards)

为了降低采用门槛和集成复杂度,A2A 建立在开发者熟悉的 HTTP/1.1 或 HTTP/2 之上,采用 JSON-RPC 2.0 作为请求/响应格式,并利用服务器发送事件 (Server-Sent Events, SSE) 实现流式通信。这使得 A2A 更易融入现有的企业 IT 架构。

  • 默认安全 (Secure by default)

安全是企业级应用的基础。A2A 在设计上与 OpenAPI 的认证规范保持一致,支持如 OAuth2、API Key、JWT 等多种认证方案。关键在于,认证凭证通过标准的 HTTP Header(如 Authorization)传递,而非包含在 A2A 的 JSON 载荷中,确保协议本身与具体认证机制解耦,并强制要求服务器对每个请求进行验证。

  • 支持长时与异步任务 (Support for long-running tasks)

许多智能体任务并非瞬时完成,可能涉及复杂计算、外部调用甚至人工介入(Human-in-the-loop)。A2A 通过任务状态管理、流式更新 (SSE) 和可选的推送通知 (Push Notifications) 机制,原生支持这类耗时较长的异步交互场景。

  • 模态无关 (Modality agnostic)

智能体的交互远不止文本。A2A 的 Part 数据结构设计使其能够承载文本 (TextPart)、文件 (FilePart,支持内联 Base64 或 URI 引用,可用于图像、文档等) 和结构化数据 (DataPart,用于表单、JSON 对象等)。这为未来支持音频流、视频流等多模态交互奠定了基础。

2. A2A 的核心交互流程与对象模型

A2A 定义了一个清晰的客户端-服务器交互模型。一个“客户端”智能体(发起请求方)与一个“远程”智能体(A2A 服务器,处理请求方)通过一系列标准化的步骤进行通信:

Agent交互的第一步是发现。

2.1 发现 (Discovery)

客户端首先需要找到并了解远程智能体的能力。这通过获取远程智能体的Agent Card实现。Agent Card是一个JSON 文件,通常发布在服务器的熟知路径下,推荐路径为:

https://base url/.well-known/agent.json

Agent Card中包含了智能体的名称、描述、服务 URL、版本、提供商信息、支持的核心能力 (capabilities 如 streaming, pushNotifications)、认证要求 (authentication)、默认输入/输出模式 (defaultInputModes/defaultOutputModes) 以及最重要的——它所具备的技能列表 (skills)。每个技能 (AgentSkill) 有 ID、名称、描述、标签、示例等,帮助客户端判断该智能体是否适合处理特定任务。

下面是A2A协议文档中Agent Card的一个示例,我们来看一下:

//agent card
{
  "name": "Google Maps Agent",
  "description": "Plan routes, remember places, and generate directions",
  "url": "https://maps-agent.google.com",
  "provider": {
    "organization": "Google",
    "url": "https://google.com"
  },
  "version": "1.0.0",
  "authentication": {
    "schemes": "OAuth2"
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain", "application/html"],
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "route-planner",
      "name": "Route planning",
      "description": "Helps plan routing between two locations",
      "tags": ["maps", "routing", "navigation"],
      "examples": [
        "plan my route from Sunnyvale to Mountain View",
        "what's the commute time from Sunnyvale to San Francisco at 9AM",
        "create turn by turn directions from Sunnyvale to Mountain View"
      ],
      // can return a video of the route
      "outputModes": ["application/html", "video/mp4"]
    },
    {
      "id": "custom-map",
      "name": "My Map",
      "description": "Manage a custom map with your own saved places",
      "tags": ["custom-map", "saved-places"],
      "examples": [
        "show me my favorite restaurants on the map",
        "create a visual of all places I've visited in the past year"
      ],
      "outputModes": ["application/html"]
    }
  ]
}

这个JSON对象是一个典型的Agent Card实例,它为”Google Maps Agent”提供了一份详细的说明书,旨在让其他客户端(可能是用户界面、应用程序或其他AI智能体)了解如何发现、连接和使用它。下面我们逐一解析其关键字段:

  1. 基本信息 (Identification & Discovery):

    • “name”: “Google Maps Agent”: 这是该智能体的人类可读名称,简洁明了地标识了它的身份。
    • “description”: “Plan routes, remember places, and generate directions”: 提供了更详细的功能概述,帮助客户端快速理解该智能体的核心用途。
    • “url”: “https://maps-agent.google.com”: 这是至关重要的基础服务端点 URL。客户端将向这个 URL(或其下的特定路径,如 /a2a,具体取决于实现)发送 A2A 协议的 JSON-RPC 请求。
    • “provider”: { “organization”: “Google”, “url”: “https://google.com” }: 指明了服务提供商是 Google,增加了来源的可信度,并提供了组织信息。
    • “version”: “1.0.0″: 表明了当前 Agent Card 所描述的智能体实现的版本号,有助于客户端进行版本兼容性管理。
  2. 连接与交互要求 (Connection & Interaction Requirements):

    • “authentication”: { “schemes”: “OAuth2″ }: 这个字段明确了与该智能体交互所需的认证机制。客户端在发送请求时,需要通过标准的 HTTP Authorization 头携带有效的 OAuth2 令牌。这是实现安全通信的关键。
    • “defaultInputModes”: ["text/plain"]: 定义了该智能体默认接受的输入内容类型。除非特定技能另有说明,否则它主要期望接收纯文本输入。
    • “defaultOutputModes”: ["text/plain", "application/html"]: 定义了该智能体默认能够生成的输出内容类型。它可以返回纯文本或 HTML 格式的响应。
  3. 核心协议能力 (Core Protocol Capabilities):

    • “capabilities”: { “streaming”: true, “pushNotifications”: false }: 这个对象说明了该智能体支持的 A2A 协议高级特性
      • “streaming”: true: 表示该智能体支持流式响应。客户端可以使用 tasks/sendSubscribe 方法发起请求,并通过 SSE 实时接收任务状态和结果更新。
      • “pushNotifications”: false: 表示该智能体不支持推送通知。即使客户端配置了 webhook,该智能体也不会在连接断开后主动推送更新。
  4. 具体技能清单 (Skills List):

    • “skills”: [...]: 这是 Agent Card 的核心部分,详细列出了该智能体具体能执行的任务类型(技能)。客户端可以根据这个列表来判断该智能体是否具备完成特定用户请求的能力。
    • 技能 1: Route Planning (route-planner)
      • “id”: 技能的唯一标识符。
      • “name”: 技能的人类可读名称。
      • “description”: 详细描述该技能的作用。
      • “tags”: [...]: 相关的标签,便于分类和搜索。
      • “examples”: [...]: 非常重要,提供了具体的用户请求示例。这极大地帮助了客户端(尤其是其他 AI 智能体)理解如何有效地触发和使用这项技能。
      • “outputModes”: ["application/html", "video/mp4"]: 覆盖了默认输出模式。这个技能特别指出,除了默认的文本和 HTML,它还能生成 video/mp4 格式的输出(例如,路线演示视频)。这展示了 A2A 协议的灵活性,允许不同技能具有不同的输出能力。
    • 技能 2: Custom Map (custom-map)
      • 同样包含 id, name, description, tags, examples。
      • “outputModes”: ["application/html"]: 这个技能的输出模式仅限于 HTML,它也覆盖了默认设置,但没有像 route-planner 那样增加额外的视频格式。

我们看到:客户端(无论是人类开发者阅读,还是另一个程序解析)可以通过这份”名片”,准确地了解如何与”Google Maps Agent”进行有效且安全的交互,选择合适的技能来满足用户需求,并预期可能收到的响应格式。这正是A2A协议实现智能体互操作性的基石。

2.2 任务启动与管理 (Task Initiation & Management)

一旦Agent相互发现后,后续所有交互都围绕Task对象展开。Task是A2A中的核心工作单元,代表一个需要完成的目标,拥有唯一的id和可选的 sessionId (用于关联同一会话中的多个任务)。

客户端通过向服务器的 A2A 端点发送 JSON-RPC 请求来启动或继续一个任务。主要方法包括:

  • tasks/send: 用于发送初始请求或在多轮对话中发送后续用户输入。服务器处理后同步返回最终的 Task 状态及结果 (Artifacts)。适用于短时任务或客户端选择轮询获取更新的场景。
  • tasks/get: 用于查询指定 id 的任务状态和已生成的 Artifacts,可选择性地获取最近的 N 条消息历史 (historyLength)。
  • tasks/cancel: 请求取消一个正在进行的任务。
  • tasks/sendSubscribe: 同样用于发送消息,但服务器会通过SSE 连接持续推送任务进展。适用于长时任务,客户端可以实时接收更新。这是一种流工作模式

Task 对象包含当前状态 (status),该状态会经历一个生命周期:submitted -> working -> (可能进入 input-required) -> completed / failed / canceled。

下面是一个发送task和接收task response的示例。我们先看请求,具体字段的含义在示例的注释中,后续就不赘述了。

//Request
{
  "jsonrpc": "2.0", // 1. 标准 JSON-RPC 版本声明
  "id": 1,          // 2. 客户端生成的请求 ID,用于匹配响应
  "method":"tasks/send", // 3. 调用的 A2A 方法:发送消息以启动或继续任务
  "params": {       // 4. 方法参数
    "id": "de38c76d-d54c-436c-8b9f-4c2703648d64", // 5. 任务 ID (由客户端生成)
    "message": {   // 6. 要发送的消息内容
      "role":"user", // 7. 消息发送者角色:用户 (由客户端代理)
      "parts": [{   // 8. 消息内容部分
        "type":"text", // 9. 内容类型:纯文本
        "text": "tell me a joke" // 10. 具体的文本内容
      }]
    },
    "metadata": {} // 11. 可选的元数据,这里为空
  }
}

这个请求是客户端在启动一个新任务(ID: de38c…),并通过 tasks/send 方法发送了一个包含文本 “tell me a joke” 的用户消息。

下面是该请求对应的响应体的内容:

//Response
{
  "jsonrpc": "2.0", // 1. 标准 JSON-RPC 版本声明
  "id": 1,          // 2. 响应的 ID,与请求的 ID 匹配
  "result": {       // 3. 请求成功,包含结果数据
    "id": "de38c76d-d54c-436c-8b9f-4c2703648d64", // 4. 任务 ID,与请求中的一致
    "sessionId": "c295ea44-7543-4f78-b524-7a38915ad6e4", // 5. 会话 ID (由服务器生成)
    "status": {    // 6. 任务的当前状态
      "state": "completed" // 7. 任务状态:已完成
    },
    "artifacts": [{ // 8. 任务生成的制品 (结果)
      "name":"joke", // 9. 制品名称
      "parts": [{  // 10. 制品内容部分
          "type":"text", // 11. 内容类型:纯文本
          "text":"Why did the chicken cross the road? To get to the other side!" // 12. 具体的笑话文本
        }]
      }],
    "metadata": {} // 13. 可选的元数据,这里为空
  }
}

这个响应表明服务器成功接收并处理了 ID 为 de38c… 的任务请求。任务已经完成 (completed),服务器为此任务分配了一个会话 ID (c295ea…),并将结果(笑话文本)封装在一个名为 “joke” 的 Artifact 中返回给了客户端。

上面这个简单的示例清晰地展示了A2A协议中最基础的一种交互模式。

通过task可以承载Message和Artifact,而Message和Artifact各自又可以分为多个Part,它们的对象关系图如下:

Task 是状态和流程的容器。 Message 是 Task 请求过程中的通信载体。 Artifact 是 Task 产生的结果载体。 Part 是构成 Message 和 Artifact 内容的基本单元。

下面我们就来看看Message和Artifact这两种对象。

2.3 通信载体:消息与部件 (Communication: Message & Part)

Message(消息)包含任何非人工制品的内容。这可以包括智能体的想法、用户上下文、指令、错误、状态或元数据等。 客户端和服务器之间的交流通过Message对象进行。Message 标识了发送方 (role: “user” 或 “agent”),并包含一个或多个Part 对象。

Part 是实际内容的载体,可以是:

  • TextPart: 包含 text 字段。
  • FilePart: 包含 file 对象,该对象内含 mimeType、name,以及 bytes (Base64 编码内容) 或 uri (文件链接)。
  • DataPart: 包含 data 字段,承载任意 JSON 结构,常用于表单提交或结构化数据交换。

在上面发送task的示例中我们已经看到了Message的一个示例(下面再摘录一下其中内容,这是一个TextPart):

"message": {   // 6. 要发送的消息内容
  "role":"user", // 7. 消息发送者角色:用户 (由客户端代理)
  "parts": [{   // 8. 消息内容部分
    "type":"text", // 9. 内容类型:纯文本
    "text": "tell me a joke" // 10. 具体的文本内容
  }]
},

我们再来看看Artifact。

2.4 结果交付:制品 (Result Delivery: Artifact)

当智能体完成任务或产生阶段性结果时,它会生成Artifact 对象。Artifact代表任务的最终或中间输出。

一个 Artifact 可以有名称 (name)、描述 (description),并像 Message 一样包含一个或多个Part。例如,一个生成报告的任务可能产生一个包含 TextPart (报告文本) 和 FilePart (PDF 文件) 的 Artifact。

在上面示例的应答中,我们已经见识过Aritfact了:

"artifacts": [{ // 8. 任务生成的制品 (结果)
  "name":"joke", // 9. 制品名称
  "parts": [{  // 10. 制品内容部分
      "type":"text", // 11. 内容类型:纯文本
      "text":"Why did the chicken cross the road? To get to the other side!"
    }
  }],

此外,在流式传输中,Artifact 可以通过 TaskArtifactUpdateEvent 分块 (append: true) 发送,并用 lastChunk: true 标记结束。

2.5 异步与实时更新:流式传输与推送通知

A2A支持通过SSE实现的流式传输。 当使用 tasks/sendSubscribe 时,服务器通过 SSE 连接发送事件流。主要事件类型包括:

  • TaskStatusUpdateEvent: 通知任务状态 (status) 的变化,包含状态码、可选的消息 (message) 和时间戳 (timestamp)。final: true 标记任务终结。
  • TaskArtifactUpdateEvent: 流式传输 Artifact 的内容。

下面是一个流式传输的示例(主要是通过TaskArtifactUpdateEvent传输Artifact的内容):

//Request
{
  "method":"tasks/sendSubscribe",
  "params": {
    "id": "de38c76d-d54c-436c-8b9f-4c2703648d64",
    "sessionId": "c295ea44-7543-4f78-b524-7a38915ad6e4",
    "message": {
      "role":"user",
      "parts": [{
        "type":"text",
        "text": "write a long paper describing the attached pictures"
      },{
        "type":"file",
        "file": {
           "mimeType": "image/png",
           "data":"<base64-encoded-content>"
        }
      }]
    },
    "metadata": {}
  }
}

//Response
data: {
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": 1,
    "status": {
      "state": "working",
      "timestamp":"2025-04-02T16:59:25.331844"
    },
    "final": false
  }
}

data: {
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": 1,
    "artifact": [
      "parts": [
        {"type":"text", "text": "<section 1...>"}
      ],
      "index": 0,
      "append": false,
      "lastChunk": false
    ]
  }
}
data: {
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": 1,
    "artifact": [
      "parts": [
        {"type":"text", "text": "<section 2...>"}
      ],
      "index": 0,
      "append": true,
      "lastChunk": false
    ]
  }
}
data: {
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": 1,
    "artifact": [
      "parts": [
        {"type":"text", "text": "<section 3...>"}
      ],
      "index": 0,
      "append": true,
      "lastChunk": true
    ]
  }
}

data: {
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": 1,
    "status": {
      "state": "completed",
      "timestamp":"2025-04-02T16:59:35.331844"
    },
    "final": true
  }
}

A2A还支持推送通知 (Push Notifications),允许服务器在客户端断开连接后,仍能将任务状态更新发送到客户端预先配置的 webhook URL。客户端通过 tasks/pushNotification/set 提供 webhook URL 和可选的认证信息。服务器通过 tasks/pushNotification/get 查询配置。这对于需要人工介入或极长时间运行的任务至关重要。

最后再看看多轮交互。

2.6 多轮交互 (Multi-turn Conversations)

当任务状态变为 input-required 时,服务器发送的 TaskStatus 对象中的 message 会指示需要用户提供什么信息(可能是文本提示,也可能是包含 DataPart 的表单结构)。客户端获取用户输入后,再次调用 tasks/send (携带相同的 id 和 sessionId),将用户响应作为新的 Message 发送给服务器,任务得以继续。

下面是协议规范中一个多轮交互的示例:

//Request - seq 1
{
  "jsonrpc": "2.0",
  "id": 1,
  "method":"tasks/send",
  "params": {
    "id": "de38c76d-d54c-436c-8b9f-4c2703648d64",
    "message": {
      "role":"user",
      "parts": [{
        "type":"text",
        "text": "request a new phone for me"
      }]
    },
    "metadata": {}
  }
}
//Response - seq 2
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": "de38c76d-d54c-436c-8b9f-4c2703648d64",
    "sessionId": "c295ea44-7543-4f78-b524-7a38915ad6e4",
    "status": {
      "state": "input-required",
      "message": {
        "parts": [{
          "type":"text",
          "text":"Select a phone type (iPhone/Android)"
        }]
      }
    },
    "metadata": {}
  }
}
//Request - seq 3
{
  "jsonrpc": "2.0",
  "id": 2,
  "method":"tasks/send",
  "params": {
    "id": "de38c76d-d54c-436c-8b9f-4c2703648d64",
    "sessionId": "c295ea44-7543-4f78-b524-7a38915ad6e4",
    "message": {
      "role":"user",
      "parts": [{
        "type":"text",
        "text": "Android"
      }]
    },
    "metadata": {}
  }
}
//Response - seq 4
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "id": 1,
    "sessionId": "c295ea44-7543-4f78-b524-7a38915ad6e4",
    "status": {
      "state": "completed"
    },
    "artifacts": [{
      "name": "order-confirmation",
      "parts": [{
          "type":"text",
          "text":"I have ordered a new Android device for you. Your request number is R12443"
        }],
      "metadata": {}
    }],
    "metadata": {}
  }
}

3. A2A与MCP:协同而非竞争,共筑智能体生态

在讨论智能体互操作性时,另一个常被提及的协议是 Anthropic 推出的 Model Context Protocol (MCP)。理解 A2A 与 MCP 的区别与联系,对于把握当前智能体生态的发展方向至关重要。谷歌在发布 A2A 时也明确指出,两者是互补而非竞争关系。正如下图所示:


图来自网络

上图形象地揭示了两者核心关注点的不同:

  • A2A (Agent2Agent): 聚焦于智能体之间的通信与协作

    • 核心目标: A2A 的设计初衷是为了解决不同 AI 智能体之间如何进行有效交互的问题。它定义了一套标准的协议,使得由不同供应商、使用不同框架构建的、甚至内部逻辑互不透明(Opaque)的智能体,能够相互发现、理解对方的能力(通过 Agent Card)、协商交互方式(如数据格式、模态),并协同完成更复杂的任务。
    • 交互模式:Agent <-> Agent。它关心的是智能体 A 如何将一个任务或子任务委托给智能体 B,如何传递必要的上下文,如何管理任务状态,以及如何接收来自智能体 B 的结果或需要进一步输入的请求。
    • 应用场景: 主要用于构建多智能体系统 (Multi-Agent Systems),实现跨系统、跨应用的企业级工作流自动化,需要多个具有不同专长的智能体协同工作的场景。
  • MCP (Model Context Protocol): 聚焦于智能体与工具/API 的通信

    • 核心目标: MCP 主要关注的是单个 AI 智能体如何更有效地理解和使用外部工具或 API。它提供了一种标准化的方式来描述工具的功能、参数、以及如何将相关上下文信息传递给模型,从而提高模型调用工具的准确性和可靠性。
    • 交互模式: 本质上是 Agent <-> API/Tool。它关心的是智能体如何理解一个外部函数(如天气查询 API、数据库查询工具)并准确地调用它,以及如何处理返回结果。
    • 应用场景: 主要用于增强单个智能体的能力,让它能够像人类使用软件一样,通过调用各种工具来完成自身无法独立完成的任务,例如联网搜索、代码执行、访问专有数据等。

综上,A2A和MCP是妥妥的互补关系A2A致力于解决“智能体们如何互相交谈与合作” 的问题。而MCP则致力于解决“一个智能体如何更好地使用它的工具箱”的问题。

在一个复杂的系统中,两者可以很好地协同工作:一个主智能体可以使用 MCP 来理解和调用其内部集成的各种工具(如数据库查询、日历管理 API);当需要与其他独立的、专门化的智能体(如财务审批智能体、报告生成智能体)协作时,它可以通过 A2A 协议与这些外部智能体进行通信和任务协调。 因此,将 A2A 和 MCP 视为智能体生态建设中不同层面的解决方案更为准确。A2A 构建了智能体之间的“社交网络”,而 MCP 则增强了每个智能体个体的“动手能力”。两者共同推动着更强大、更灵活、更具适应性的 AI 智能体系统的发展。

4. 小结

Agent2Agent (A2A) 协议是谷歌及其庞大生态伙伴网络为解决 AI 智能体互操作性难题而迈出的关键一步。通过提供一个基于开放标准、注重安全和灵活性的通信框架,A2A有望成为连接不同智能体、打通企业复杂流程的桥梁,从而真正释放 AI 在自动化和生产力提升方面的潜力。

虽然 A2A 目前仍处于草案阶段,但其清晰的设计理念、强大的合作伙伴支持以及开放的社区模式,都预示着其广阔的应用前景。谷歌计划在今年晚些时候推出生产就绪版本,并持续根据社区反馈进行迭代优化,未来可能涵盖更复杂的动态能力协商、任务内UX调整等高级特性。

A2A 的旅程才刚刚开始。它的最终成功将取决于业界的广泛采纳和开发者社区的积极贡献。我们期待 A2A 能够引领 AI 智能体进入一个更加协同、高效、互联互通的新时代。

对 A2A 感兴趣的开发者可以通过以下途径深入了解和参与:

你对 A2A 协议的前景怎么看?它能真正解决 Agent 协作的难题吗?欢迎在评论区留下你的看法!

关注我,获取更多 Go、AI 与云原生前沿解读。


原「Gopher部落」已重装升级为「Go & AI 精进营」知识星球,快来加入星球,开启你的技术跃迁之旅吧!

我们致力于打造一个高品质的 Go 语言深度学习AI 应用探索 平台。在这里,你将获得:

  • 体系化 Go 核心进阶内容: 深入「Go原理课」、「Go进阶课」、「Go避坑课」等独家深度专栏,夯实你的 Go 内功。
  • 前沿 Go+AI 实战赋能: 紧跟时代步伐,学习「Go+AI应用实战」、「Agent开发实战课」,掌握 AI 时代新技能。
  • 星主 Tony Bai 亲自答疑: 遇到难题?星主第一时间为你深度解析,扫清学习障碍。
  • 高活跃 Gopher 交流圈: 与众多优秀 Gopher 分享心得、讨论技术,碰撞思想火花。
  • 独家资源与内容首发: 技术文章、课程更新、精选资源,第一时间触达。

衷心希望「Go & AI 精进营」能成为你学习、进步、交流的港湾。让我们在此相聚,享受技术精进的快乐!欢迎你的加入!

img{512x368}

img{512x368}

img{512x368}
img{512x368}

著名云主机服务厂商DigitalOcean发布最新的主机计划,入门级Droplet配置升级为:1 core CPU、1G内存、25G高速SSD,价格6$/月。有使用DigitalOcean需求的朋友,可以打开这个链接地址:https://m.do.co/c/bff6eed92687 开启你的DO主机之路。

Gopher Daily(Gopher每日新闻) – https://gopherdaily.tonybai.com

我的联系方式:

  • 微博(暂不可用):https://weibo.com/bigwhite20xx
  • 微博2:https://weibo.com/u/6484441286
  • 博客:tonybai.com
  • github: https://github.com/bigwhite
  • Gopher Daily归档 – https://github.com/bigwhite/gopherdaily
  • Gopher Daily Feed订阅 – https://gopherdaily.tonybai.com/feed

商务合作方式:撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。

如发现本站页面被黑,比如:挂载广告、挖矿等恶意代码,请朋友们及时联系我。十分感谢! Go语言第一课 Go语言精进之路1 Go语言精进之路2 Go语言编程指南
商务合作请联系bigwhite.cn AT aliyun.com

欢迎使用邮件订阅我的博客

输入邮箱订阅本站,只要有新文章发布,就会第一时间发送邮件通知你哦!

这里是 Tony Bai的个人Blog,欢迎访问、订阅和留言! 订阅Feed请点击上面图片

如果您觉得这里的文章对您有帮助,请扫描上方二维码进行捐赠 ,加油后的Tony Bai将会为您呈现更多精彩的文章,谢谢!

如果您希望通过微信捐赠,请用微信客户端扫描下方赞赏码:

如果您希望通过比特币或以太币捐赠,可以扫描下方二维码:

比特币:

以太币:

如果您喜欢通过微信浏览本站内容,可以扫描下方二维码,订阅本站官方微信订阅号“iamtonybai”;点击二维码,可直达本人官方微博主页^_^:
本站Powered by Digital Ocean VPS。
选择Digital Ocean VPS主机,即可获得10美元现金充值,可 免费使用两个月哟! 著名主机提供商Linode 10$优惠码:linode10,在 这里注册即可免费获 得。阿里云推荐码: 1WFZ0V立享9折!


View Tony Bai's profile on LinkedIn
DigitalOcean Referral Badge

文章

评论

  • 正在加载...

分类

标签

归档



Statcounter View My Stats