A2A 1.0：面向生产环境的 Agent 协作协议

1
用户提出目标
2
    ↓
3
主 Agent 判断需要专业能力
4
    ↓
5
查找并读取远端 Agent 的 Agent Card
6
    ↓
7
确认能力、接口、版本和安全要求
8
    ↓
9
完成认证
10
    ↓
11
发送 Message
12
    ↓
13
远端 Agent 创建或更新 Task
14
    ↓
15
持续返回状态和进度
16
    ↓
17
必要时请求额外输入或授权
18
    ↓
19
生成 Artifact
20
    ↓
21
主 Agent校验、解释并返回用户

1
你是谁？
2
你由谁提供？
3
你会做什么？
4
你支持哪些输入和输出格式？
5
你支持哪些协议接口？
6
你使用哪个 A2A 版本？
7
你支持流式更新或 Webhook 吗？
8
调用你需要哪种认证？

1
{
2
  "name": "Medical Knowledge Agent",
3
  "description": "提供健康知识解释、危险信号筛查和就医建议分层",
4
  "provider": {
5
    "organization": "Example Health AI",
6
    "url": "https://health.example.com"
7
  },
8
  "version": "1.3.0",
9
  "supportedInterfaces": [
10
    {
11
      "url": "https://health.example.com/a2a",
12
      "protocolBinding": "HTTP+JSON",
13
      "protocolVersion": "1.0"
14
    }
15
  ],
16
  "capabilities": {
17
    "streaming": true,
18
    "pushNotifications": true,
19
    "extendedAgentCard": true
20
  },
21
  "securitySchemes": {
22
    "oauth": {
23
      "oauth2SecurityScheme": {
24
        "description": "OAuth 2.0 client credentials",
25
        "flows": {
26
          "clientCredentials": {
27
            "tokenUrl": "https://auth.example.com/oauth/token",
28
            "scopes": {
29
              "medical.read": "读取医疗知识能力",
30
              "medical.triage": "调用风险分层能力"
31
            }
32
          }
33
        }
34
      }
35
    }
36
  },
37
  "securityRequirements": [
38
    {
39
      "oauth": ["medical.read"]
40
    }
41
  ],
42
  "defaultInputModes": [
43
    "text/plain",
44
    "application/json"
45
  ],
46
  "defaultOutputModes": [
47
    "text/markdown",
48
    "application/json"
49
  ],
50
  "skills": [
51
    {
52
      "id": "symptom-education",
53
      "name": "症状知识解释",
54
      "description": "解释常见症状及其一般性健康含义",
55
      "tags": ["health", "symptom", "education"]
56
    },
57
    {
58
      "id": "risk-triage",
59
      "name": "风险分层",
60
      "description": "识别危险信号并给出就医紧迫性建议",
61
      "tags": ["health", "triage", "risk"]
62
    }
63
  ]
64
}

1
可读取
2
可索引
3
可验证
4
可匹配
5
可协商
6
可缓存

1
公开 Agent Card
2
  ├── 基础身份
3
  ├── 公共能力
4
  ├── 认证方式
5
  └── extendedAgentCard: true
6

7
完成认证
8
  ↓
9
Extended Agent Card
10
  ├── 受限 Skills
11
  ├── 更详细的接口
12
  └── 针对当前调用方的能力信息

1
发现候选 Agent
2
    ↓
3
读取 Agent Card
4
    ↓
5
验证身份与完整性
6
    ↓
7
筛选能力和协议兼容性
8
    ↓
9
应用业务、合规和成本策略
10
    ↓
11
选择具体 Agent 与接口

1
Request
2
  ↓
3
立即处理
4
  ↓
5
Response

1
理解目标
2
  ↓
3
检查输入
4
  ↓
5
执行多步分析
6
  ↓
7
等待外部系统
8
  ↓
9
请求用户补充信息
10
  ↓
11
继续执行
12
  ↓
13
生成多个结果

1
TASK_STATE_SUBMITTED
2
          ↓
3
TASK_STATE_WORKING
4
          ↓
5
TASK_STATE_INPUT_REQUIRED
6
          ↓
7
TASK_STATE_WORKING
8
          ↓
9
TASK_STATE_COMPLETED

1
TASK_STATE_WORKING
2
   ├── TASK_STATE_FAILED
3
   ├── TASK_STATE_CANCELED
4
   └── TASK_STATE_REJECTED

1
用户发热、咳嗽并有胸闷

1
年龄
2
是否呼吸困难
3
是否存在基础疾病
4
症状是否突然加重
5
是否有血氧数据

1
TASK_STATE_INPUT_REQUIRED

1
TASK_STATE_AUTH_REQUIRED

1
SendMessage
2
SendStreamingMessage
3
GetTask
4
ListTasks
5
CancelTask
6
SubscribeToTask

1
messageId 唯一约束
2
重复请求检测
3
任务创建幂等键
4
状态迁移并发控制
5
Artifact 去重
6
失败重试策略

1
主 Agent → SendMessage
2
主 Agent ← Task: SUBMITTED
3

4
主 Agent → GetTask
5
主 Agent ← Task: WORKING
6

7
主 Agent → GetTask
8
主 Agent ← Task: COMPLETED + Artifacts

1
Message-only：恰好返回一个 Message，然后关闭连接
2

3
Task lifecycle：
4
  先返回 Task
5
  再持续返回 TaskStatusUpdateEvent / TaskArtifactUpdateEvent

1
已接收任务
2
正在进行危险信号筛查
3
需要补充用户年龄
4
正在生成风险分层结果
5
已生成结构化 Artifact
6
任务完成

1
主 Agent → 提交任务
2
连接结束
3

4
远端 Agent继续执行
5

6
远端 Agent → Webhook
7
             通知状态变化或 Artifact 更新

1
API Key
2
HTTP Basic / Bearer
3
OAuth 2.0
4
OpenID Connect
5
mTLS

1
Authentication：你是谁？
2
Authorization：你被允许做什么？

1
健康知识解释
2
一般性危险信号筛查

1
读取完整病历
2
修改处方
3
访问其他租户的健康数据
4
触发高风险医疗操作

1
卡片内容是否被修改
2
卡片是否由持有对应私钥的一方签发

1
获取 Agent Card
2
    ↓
3
规范化待验证内容
4
    ↓
5
验证 JWS 签名
6
    ↓
7
检查签名密钥是否可信
8
    ↓
9
检查卡片是否过期或已撤销
10
    ↓
11
确认接口域名与提供方策略一致

1
只发送完成任务所需的数据
2
敏感字段尽可能脱敏
3
明确用户授权和使用目的
4
限制 Task、History 和 Artifact 的保留时间
5
记录谁在什么时间调用了哪个 Skill
6
对高风险结果保留人工复核

1
AgentCard
2
Message
3
Part
4
Task
5
TaskStatus
6
Artifact
7
TaskStatusUpdateEvent
8
TaskArtifactUpdateEvent
9
SecurityScheme

1
JSONRPC
2
GRPC
3
HTTP+JSON

1
protocolBinding
2
protocolVersion
3
url

1
A2A-Version: 1.0

1
租户鉴权
2
数据隔离
3
密钥隔离
4
配额限制
5
审计隔离

1
认证错误
2
授权错误
3
参数校验错误
4
资源不存在或不可见
5
系统内部错误
6
A2A 专属错误

1
TaskNotFoundError
2
TaskNotCancelableError
3
PushNotificationNotSupportedError
4
ContentTypeNotSupportedError
5
VersionNotSupportedError

1
用户：
2

3
“我已经咳嗽三天了，体温 38.5℃，
4
今天走动时感觉胸口有点闷，需要去医院吗？”

1
需要的 Skills：
2
  symptom-education
3
  risk-triage
4

5
其他要求：
6
  支持中文
7
  支持结构化 JSON 输出
8
  支持多轮补充信息
9
  支持 Streaming
10
  通过组织安全审核

1
Medical Knowledge Agent
2
Agent Card:
3
https://health.example.com/.well-known/agent-card.json

1
Agent 名称：Medical Knowledge Agent
2
Skills：symptom-education、risk-triage
3
输入：text/plain、application/json
4
输出：text/markdown、application/json
5
Binding：HTTP+JSON
6
A2A 版本：1.0
7
Streaming：支持
8
认证：OAuth 2.0

1
它是谁？
2
它会什么？
3
我能否安全调用它？

1
medical.read
2
medical.triage

1
POST /message:send HTTP/1.1
2
Host: health.example.com
3
Content-Type: application/a2a+json
4
Authorization: Bearer <access-token>
5
A2A-Version: 1.0

1
{
2
  "message": {
3
    "messageId": "msg-001",
4
    "role": "ROLE_USER",
5
    "parts": [
6
      {
7
        "data": {
8
          "symptoms": [
9
            "咳嗽三天",
10
            "体温 38.5 摄氏度",
11
            "走动时胸闷"
12
          ],
13
          "language": "zh-CN",
14
          "request": "请进行危险信号筛查，并给出就医紧迫性建议"
15
        },
16
        "mediaType": "application/json"
17
      }
18
    ]
19
  },
20
  "configuration": {
21
    "returnImmediately": true
22
  }
23
}

1
用户姓名
2
身份证号
3
家庭地址
4
与任务无关的完整聊天记录

1
{
2
  "task": {
3
    "id": "medical-task-1001",
4
    "contextId": "health-context-88",
5
    "status": {
6
      "state": "TASK_STATE_WORKING",
7
      "timestamp": "2026-08-28T12:30:00.000Z"
8
    }
9
  }
10
}

1
taskId: medical-task-1001
2
contextId: health-context-88

1
{
2
  "statusUpdate": {
3
    "taskId": "medical-task-1001",
4
    "contextId": "health-context-88",
5
    "status": {
6
      "state": "TASK_STATE_INPUT_REQUIRED",
7
      "message": {
8
        "messageId": "msg-medical-question-001",
9
        "contextId": "health-context-88",
10
        "taskId": "medical-task-1001",
11
        "role": "ROLE_AGENT",
12
        "parts": [
13
          {
14
            "data": {
15
              "questions": [
16
                "用户年龄是多少？",
17
                "是否存在明显呼吸困难？",
18
                "是否有哮喘、心脏病等基础疾病？",
19
                "是否出现嘴唇发紫、意识模糊或持续胸痛？",
20
                "是否测量过血氧？"
21
              ]
22
            },
23
            "mediaType": "application/json"
24
          }
25
        ]
26
      }
27
    }
28
  }
29
}

1
“为了更准确地判断紧迫程度，我还需要确认：
2
你今年多大？现在是否明显呼吸困难？
3
有没有哮喘或心脏病？是否有持续胸痛？
4
家里有血氧仪吗？”

1
“我 27 岁，没有基础病。
2
没有明显呼吸困难，但走动时胸闷更明显。
3
没有持续胸痛，也没有血氧仪。”

1
{
2
  "message": {
3
    "messageId": "msg-002",
4
    "contextId": "health-context-88",
5
    "taskId": "medical-task-1001",
6
    "role": "ROLE_USER",
7
    "parts": [
8
      {
9
        "data": {
10
          "age": 27,
11
          "underlyingConditions": [],
12
          "breathingDifficulty": false,
13
          "chestTightnessOnActivity": true,
14
          "persistentChestPain": false,
15
          "oxygenSaturation": null
16
        },
17
        "mediaType": "application/json"
18
      }
19
    ]
20
  }
21
}

1
TASK_STATE_WORKING

1
TaskStatusUpdateEvent：
2
  正在进行危险信号筛查
3

4
TaskStatusUpdateEvent：
5
  正在评估线下就医紧迫性
6

7
TaskArtifactUpdateEvent：
8
  已生成结构化风险分层结果

1
TASK_STATE_COMPLETED

1
{
2
  "task": {
3
    "id": "medical-task-1001",
4
    "contextId": "health-context-88",
5
    "status": {
6
      "state": "TASK_STATE_COMPLETED",
7
      "timestamp": "2026-08-28T12:30:08.000Z"
8
    },
9
    "artifacts": [
10
      {
11
        "artifactId": "risk-assessment-001",
12
        "name": "症状风险分层结果",
13
        "description": "基于用户提供信息生成的一般性风险提示",
14
        "parts": [
15
          {
16
            "data": {
17
              "riskLevel": "needs-timely-in-person-evaluation",
18
              "reasons": [
19
                "发热持续三天",
20
                "咳嗽持续三天",
21
                "活动时胸闷"
22
              ],
23
              "recommendedAction": "建议尽快接受线下医疗评估",
24
              "emergencyTriggers": [
25
                "明显或快速加重的呼吸困难",
26
                "嘴唇发紫",
27
                "意识模糊",
28
                "持续或加重的胸痛"
29
              ],
30
              "limitations": [
31
                "该结果不是医疗诊断",
32
                "无法替代体格检查、血氧测量和必要的医学检查"
33
              ]
34
            },
35
            "mediaType": "application/json"
36
          }
37
        ]
38
      },
39
      {
40
        "artifactId": "patient-explanation-001",
41
        "name": "面向用户的健康说明",
42
        "parts": [
43
          {
44
            "text": "根据你描述的持续发热、咳嗽和活动时胸闷，建议尽快接受线下医疗评估。若出现明显呼吸困难、嘴唇发紫、意识异常，或持续加重的胸痛，请立即联系当地急救服务。",
45
            "mediaType": "text/markdown"
46
          }
47
        ]
48
      }
49
    ]
50
  }
51
}

1
你描述的持续发热、咳嗽，以及走动时胸闷，
2
建议尽快接受线下医疗评估，以便测量血氧并做必要检查。
3

4
仅凭聊天无法判断具体原因，也不能替代医生诊断。
5
若出现明显呼吸困难、嘴唇发紫、意识模糊，
6
或者胸痛持续加重，请立即联系当地急救服务。

1
Agent Card
2
  解决医疗 Agent 是谁、会什么、支持怎样的接口和认证。
3

4
Discovery
5
  解决主 Agent 如何找到并选择可信的医疗能力。
6

7
Task
8
  解决医疗评估如何被创建、追问、继续和完成。
9

10
Async
11
  解决主 Agent 如何持续获得状态、进度和 Artifact。
12

13
Security
14
  解决身份、权限、卡片完整性、健康数据和回调如何被保护。

1
用户
2
 │
3
 │ 提出医疗问题
4
 ↓
5
主 Agent
6
 │
7
 │ 1. Discovery：查找可信医疗 Agent
8
 ↓
9
Agent Registry / Well-Known URI
10
 │
11
 │ 2. 获取并验证 Agent Card
12
 ↓
13
主 Agent
14
 │
15
 │ 3. 取得最小权限凭据
16
 │ 4. SendMessage
17
 ↓
18
医疗 Agent
19
 │
20
 │ 5. 创建 Task
21
 │ 6. TASK_STATE_WORKING
22
 │ 7. TASK_STATE_INPUT_REQUIRED
23
 ↓
24
主 Agent
25
 │
26
 │ 8. 向用户追问
27
 │ 9. 携带相同 taskId/contextId 补充信息
28
 ↓
29
医疗 Agent
30
 │
31
 │ 10. Streaming 状态更新
32
 │ 11. 生成 Artifacts
33
 │ 12. TASK_STATE_COMPLETED
34
 ↓
35
主 Agent
36
 │
37
 │ 13. 校验、解释和安全呈现
38
 ↓
39
用户