A2A协议连接器 - 屏墩墩集团WorkBuddy生态

一、连接器概述

A2A协议连接器是屏墩墩集团基于Google A2A（Agent-to-Agent）协议开发的MCP连接器，实现不同智能体之间的自主发现、协商、协作和交易。通过本连接器，企业可以快速接入A2A生态，让智能体之间自主完成复杂任务，提升业务效率。

二、技术架构

核心组件

Agent Card：智能体身份卡片，包含能力描述、接入点、认证方式等信息
Task Lifecycle：任务生命周期管理，包括任务创建、协商、执行、完成、失败
Message Protocol：消息协议，支持文本、结构化数据、文件等多种消息类型
Authentication：认证机制，支持API Key、OAuth2、DID等多种认证方式
Payment Integration：支付集成，支持智能体之间的自动支付和结算

工作流程

1. 智能体A通过Agent Card发现智能体B → 2. 智能体A向智能体B发送任务请求 → 3. 智能体B评估并协商任务条款 → 4. 双方达成一致后开始执行 → 5. 执行完成后确认并结算

三、API端点列表（共11个）

方法	路径	描述	认证
POST	`/api/v1/a2a/agent-card`	注册/更新智能体Agent Card	API Key
GET	`/api/v1/a2a/agents`	发现可用智能体列表	API Key
GET	`/api/v1/a2a/agents/{agent_id}`	获取指定智能体详情	API Key
POST	`/api/v1/a2a/tasks`	创建新任务	API Key
GET	`/api/v1/a2a/tasks/{task_id}`	获取任务状态	API Key
POST	`/api/v1/a2a/tasks/{task_id}/messages`	发送任务消息	API Key
GET	`/api/v1/a2a/tasks/{task_id}/messages`	获取任务消息列表	API Key
POST	`/api/v1/a2a/tasks/{task_id}/complete`	完成任务	API Key
POST	`/api/v1/a2a/tasks/{task_id}/cancel`	取消任务	API Key
POST	`/api/v1/a2a/payments`	创建支付	API Key
GET	`/api/v1/a2a/payments/{payment_id}`	获取支付状态	API Key

四、请求示例

POST /api/v1/a2a/tasks
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "agent_id": "target_agent_123",
  "task_type": "data_analysis",
  "description": "分析2026年8月销售数据",
  "input_data": {
    "data_source": "sales_db",
    "period": "2026-08",
    "metrics": ["revenue", "volume", "profit"]
  },
  "callback_url": "https://your-domain.com/callback",
  "timeout": 3600
}

五、响应示例

{
  "task_id": "task_789012",
  "status": "pending",
  "agent_id": "target_agent_123",
  "created_at": "2026-09-07T10:00:00Z",
  "expires_at": "2026-09-07T11:00:00Z",
  "input_data": {...},
  "_links": {
    "self": "/api/v1/a2a/tasks/task_789012",
    "messages": "/api/v1/a2a/tasks/task_789012/messages",
    "cancel": "/api/v1/a2a/tasks/task_789012/cancel"
  }
}

六、错误码

状态码	名称	描述
400	Bad Request	请求参数错误
401	Unauthorized	API Key无效或已过期
403	Forbidden	无权限访问该资源
404	Not Found	智能体或任务不存在
409	Conflict	任务状态冲突
429	Too Many Requests	请求频率超限
500	Internal Server Error	服务器内部错误
503	Service Unavailable	目标智能体不可用

七、价格方案

开发者版

免费

月度100次调用
基础A2A功能
社区支持

立即使用

专业版

¥299/月

月度10000次调用
完整A2A功能
支付集成
API接入
专属顾问

立即使用

企业版

¥999/月

无限调用
定制化开发
私有化部署
SLA保障
7x24支持

立即使用

八、常见问题

Q: 什么是A2A协议？

A: A2A（Agent-to-Agent）是Google提出的智能体之间通信协议，定义了智能体发现、协商、协作的标准接口。

Q: 支持哪些智能体平台？

A: 支持兼容A2A协议的所有智能体平台，包括Coze、Dify、LangChain等。

Q: 如何获取API Key？

A: 注册屏墩墩集团开发者账号后，在控制台创建应用即可获取API Key。

Q: 支持私有化部署吗？

A: 企业版支持私有化部署，可以部署在企业自有服务器上。