A2A 协议技能

实现 Agent2Agent（A2A）协议，用于代理之间的通信。

功能说明

• 代理发现：通过 Agent Card 实现
• 发送消息：向远程代理发送消息
• 任务管理：支持提交任务、查询状态、获取结果
• 流式传输：基于服务器发送事件（SSE）
• 认证支持：支持 API 密钥与 Bearer Token

安装

# 安装 Python 依赖
pip install requests sseclient-py

使用方法

注册您的代理

.a2a.ps1 -Action register -Name "MyAgent" -Description "Research agent" -Capabilities "research,analysis" -Endpoint "https://my-agent.com/a2a"

获取 Agent Card

.a2a.ps1 -Action card -AgentId "uuid-of-agent"

发送消息

.a2a.ps1 -Action send -ToAgent "target-agent-uuid" -Content "Hello agent!"

提交任务

.a2a.ps1 -Action task -ToAgent "target-agent-uuid" -Task "Research quantum computing"

检查任务状态

.a2a.ps1 -Action status -TaskId "task-uuid"

列出远程代理

.a2a.ps1 -Action list -RegistryUrl "https://registry.agentlink.io"

A2A 核心概念

• Agent Card：以 JSON 格式描述代理能力（名称、端点、支持的方法等）
• Client Agent：发起任务的代理
• Remote Agent：接收并处理任务的代理
• Task：带唯一 ID、状态及结果的工作请求
• Message：代理之间的直接通信

API 参考

POST /a2a/agents/register - 注册代理
GET  /a2a/agents/{id}    - 获取代理信息
GET  /a2a/agents/{id}/card - 获取 Agent Card
POST /a2a/messages       - 发送消息
POST /a2a/tasks          - 提交任务
GET  /a2a/tasks/{id}     - 获取任务状态
GET  /a2a/tasks/{id}/result - 获取任务结果

示例

Python 使用示例

from a2a import A2AClient

client = A2AClient("https://remote-agent.com/a2a", api_key="your-key")

# 发送消息
client.send_message("target-agent-id", "Hello!")

# 提交任务
task_id = client.submit_task("target-agent-id", "Do X")
result = client.get_result(task_id)

运行要求

• Python 3.8+
• requests 库
• sseclient-py（用于流式传输）

许可证

MIT