A2A协议基础

愈努力俞幸运

378人浏览 · 2026-05-16 21:57:36

愈努力俞幸运 · 2026-05-16 21:57:36 发布

文章目录

A2A agent 与agent之间的沟通规范
- 什么是agent？
A2A协议使用场景
简化只问天气场景的场景
某些 agent 以 HTTP server 的形式对外提供能力。
A2A 协议如何规定agent的注册过程
主agent调用其它agent
总结

A2A agent 与agent之间的沟通规范

什么是agent？

agent就是能自主思考（llm），并调用工具来解决用户问题的的智能程序。比如cline就是一个agent.让cline做一个ai的网页，他首先会通过llm思考方案的大致步骤，然后调用工具来完成任务

A2A协议使用场景

需要从西雅图，飞往纽约，需要从3天里面选择一天，且这一天天气要好

在这里插入图片描述

调度agent做整体的规划和调度，把任务下发给其它更专业的agent

在这里插入图片描述

A2A 协议作用在2个agent之间，mcp协议作用在agent内部

在这里插入图片描述

简化只问天气场景的场景

既然只有一个agent，就不需要调度agent了，可用直接问天气agent，为什么还要通过调度agent?
只是为什么方便演示A2A协议

在这里插入图片描述

某些 agent 以 HTTP server 的形式对外提供能力。

在这里插入图片描述

A2A 协议如何规定agent的注册过程

在这里插入图片描述

Agent Card 可以理解为智能体的“说明书 / 名片 / 服务发现文件”

在这里插入图片描述

{
  "name": "Code Prepare Agent",
  "description": "An agent that prepares code context and streams preparation task status.",
  "version": "1.0.0",
  "supportedInterfaces": [
    {
      "url": "https://example.com/a2a/v1",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "Your Organization",
    "url": "https://example.com"
  },
  "documentationUrl": "https://example.com/docs/code-prepare-agent",
  "iconUrl": "https://example.com/icon.png",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/event-stream"
  ],
  "skills": [
    {
      "id": "prepare_code_context",
      "name": "Prepare code context",
      "description": "Submit a code preparation task and stream its task status.",
      "tags": [
        "code",
        "prepare",
        "task-status",
        "sse"
      ],
      "examples": [
        "Prepare code context for version V27A and stream the progress."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/event-stream"
      ]
    }
  ]
}

name Agent 的人类可读名称

在这里插入图片描述

description 是 required，用于帮助用户和其他 agent 理解它的用途

在这里插入图片描述

version Agent 自己的版本号，不是协议版本

在这里插入图片描述

supportedInterfaces 表示这个 agent 可以通过哪些接口/协议被调用。

在这里插入图片描述

provider表示 agent 的服务提供方

在这里插入图片描述

documentationUrl 文档地址

在这里插入图片描述

iconUrl Agent 图标地址

在这里插入图片描述

capabilities 表示这个 agent 支持哪些能力

在这里插入图片描述

defaultInputModes 和 defaultOutputModes 默认输入输出格式

在这里插入图片描述

skills 表示这个 agent 的具体能力列表

skill 指的是这个 Agent “对外公开宣称的、可以独立完成的某项业务功能/原子任务”。

在这里插入图片描述

"skills": [
  {
    "id": "prepare_code_context", // 【外包订单号】：主 Agent 发起请求时，JSON-RPC 里要指定的 method
    "name": "Prepare code context", // 读起来人性化的名字
    "description": "Submit a code preparation task...", // 【业务广告】：给其他 Agent 的 LLM 评估“你能帮我干这活不”
    "tags": ["code", "prepare", "sse"], // 【索引标签】：方便其他 Agent 在上百个外部路由里快速过滤过滤
    "examples": [ ... ] // 【话术样例】：教对方 Agent 怎么用自然语言或者结构化意图来触发我
  }
]