SuperAPI AI 工具集

a2a-protocol

智能体与模型

查看项目

更新于 10-16 00:22

技能介绍

用途:本技能是 Agent2Agent(A2A)协议的参考文档,A2A 是 Google 与 A2A 项目(Linux 基金会)提出的开放标准,用于独立 AI 智能体系统之间的通信。适用于构建或调试 A2A 服务器/客户端、配置 Ark A2AServer 自定义资源、理解 Agent Card、任务生命周期或消息格式、实现流式(SSE)或推送通知、使用 A2A 扩展,以及比较 A2A 与 MCP。

版本说明:默认使用 v0.3(v0.3.0),这是官方 Go 与 Python SDK 及多数实现当前支持的版本;v1.0 RC 规范仅在明确处理 v1.0 特性或规划迁移时查阅。

核心概念:协议参与者包括 User、A2A Client、A2A Server。核心元素包括 Agent Card(身份、能力、端点、鉴权的 JSON 元数据)、Task(带唯一 ID 与生命周期的有状态工作单元)、Message(单轮通信,role 为 user 或 agent)、Part(文本、文件引用或结构化数据)、Artifact(任务产出的成果)。交互模式包括请求/响应(长任务可轮询)、流式(SSE)和推送通知(Webhook)。任务生命周期为 submitted → working → input-required → completed / failed / canceled。客户端通过 /.well-known/agent.json 发现代理。

传输与鉴权:基于 HTTP 上的 JSON-RPC 2.0,支持 SSE 流式传输;文档涵盖鉴权与授权、错误码与处理、合规要求。

主要 JSON-RPC 方法:message/send、message/stream、tasks/get、tasks/cancel、tasks/resubscribe,以及推送通知配置的 set/get/list/delete,另有 agent/getAuthenticatedExtendedCard。

限制:本资料未提供具体安装命令、收费或价格信息、部署步骤与性能效果数据。所有内容为规范参考,实际实现须遵循对应 SDK 与规范版本。