Google A2A项目解析：A2A协议与核心数据类型详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00228/article/details/148440084

Google A2A项目解析：A2A协议与核心数据类型详解

Tutorial-Codebase-Knowledge Turns Codebase into Easy Tutorial with AI 项目地址: https://gitcode.com/gh_mirrors/tu/Tutorial-Codebase-Knowledge

引言：AI代理间的通信挑战

在分布式AI系统中，不同团队开发的AI代理（Agent）需要高效协作。这就如同来自不同国家的专家需要共同完成项目，必须解决语言沟通问题。Google A2A项目通过定义标准化的通信协议和数据类型，为AI代理间的交互提供了通用解决方案。

协议基础：AI代理的"交通规则"

什么是通信协议？

通信协议是一组预先定义的规则，用于规范系统间的数据交换方式。在A2A项目中，协议主要包含三个关键要素：

传输机制：使用HTTP作为基础传输层
消息格式：采用JSON-RPC 2.0标准
操作指令：定义标准化的方法集

JSON-RPC 2.0详解

JSON-RPC是一种轻量级的远程过程调用协议，其核心结构如下：

请求示例：

{
  "jsonrpc": "2.0",
  "method": "tasks/send",
  "params": {
    "id": "task-001",
    "message": {...}
  },
  "id": "req-001"
}

响应示例（成功）：

{
  "jsonrpc": "2.0",
  "result": {...},
  "id": "req-001"
}

响应示例（失败）：

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32601,
    "message": "Method not found"
  },
  "id": "req-001"
}

这种结构确保了请求与响应的精确匹配，通过唯一ID实现追踪。

核心数据类型：AI代理的"通用词汇"

1. AgentCard（代理名片）

相当于AI代理的"身份证"，包含：

代理名称和描述
能力说明（支持的任务类型）
通信端点（URL）

2. Task（任务）

代表一个完整的工作单元，关键字段包括：

id：唯一任务标识符
status：当前状态（含时间戳）
artifacts：任务产出物
history：交互历史记录

3. Message（消息）

表示对话中的一轮交互，包含：

role：发送者身份（user/agent）
parts：内容部分列表

4. Part（内容部分）

消息的具体内容载体，支持多种类型：

TextPart：纯文本
FilePart：文件（内联或引用）
DataPart：结构化数据

5. Artifact（产出物）

任务执行过程中生成的结果，结构与Message类似，同样使用Part来表示不同类型的内容。

6. 任务状态相关类型

TaskStatus：组合状态和时间戳
TaskState：枚举值（submitted/working/completed等）

实战解析：任务发送全流程

1. 客户端请求构建

完整任务请求示例：

{
  "jsonrpc": "2.0",
  "method": "tasks/send",
  "params": {
    "id": "translation-001",
    "message": {
      "role": "user",
      "parts": [
        {
          "type": "text",
          "text": "请将这段文本翻译成法语"
        },
        {
          "type": "file",
          "uri": "https://example.com/doc.txt"
        }
      ]
    }
  },
  "id": "client-req-2023"
}

2. 代理响应处理

成功响应示例：

{
  "jsonrpc": "2.0",
  "result": {
    "id": "translation-001",
    "status": {
      "state": "submitted",
      "timestamp": "2023-11-15T08:30:00Z"
    },
    "artifacts": null
  },
  "id": "client-req-2023"
}