a2a-protocol

A2A Protocol Skill

Implementation of the Agent2Agent (A2A) Protocol for inter-agent communication.

What it does

• Agent Discovery via Agent Cards
• Send Messages to remote agents
• Task Management (submit, check status, get results)
• Streaming via Server-Sent Events (SSE)
• Authentication support (API keys, Bearer tokens)

Installation

# Install Python dependencies
pip install requests sseclient-py

Usage

Register Your Agent

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

Get Agent Card

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

Send Message

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

Submit Task

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

Check Task Status

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

List Remote Agents

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

A2A Concepts

• Agent Card: JSON describing agent capabilities (name, endpoint, methods)
• Client Agent: Agent that sends tasks
• Remote Agent: Agent that receives and processes tasks
• Task: Work request with ID, status, and result
• Message: Direct communication between agents

API Reference

POST /a2a/agents/register - Register agent
GET  /a2a/agents/{id}    - Get agent info
GET  /a2a/agents/{id}/card - Get Agent Card
POST /a2a/messages       - Send message
POST /a2a/tasks          - Submit task
GET  /a2a/tasks/{id}     - Get task status
GET  /a2a/tasks/{id}/result - Get task result

Examples

Python Usage

from a2a import A2AClient

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

# Send message
client.send_message("target-agent-id", "Hello!")

# Submit task
task_id = client.submit_task("target-agent-id", "Do X")
result = client.get_result(task_id)