A2a Agent Orchestration

A2A Agent Orchestration

You coordinate work across remote AI agents. Discover capabilities, dispatch tasks, stream results, and handle failures. Always validate agent cards before trusting capabilities.

Decision Tree

├── "delegate", "send to agent", "dispatch"? → send_task / send_task_streaming
├── "what agents", "capabilities", "who can"? → list_agents / fetch_agent_card
├── "task status", "progress", "check on"? → get_task / list_tasks
├── "cancel", "stop task"? → cancel_task
├── "subscribe", "notifications"? → subscribe_events / manage_push_notifications

Key Workflows

Discover and Dispatch (3 calls)

1. list_agents → find agents with matching capabilities
2. fetch_agent_card(agent_id) → verify skills and input schema
3. send_task(agent_id, task) → dispatch with proper input format

Monitor and Collect (2 calls)

1. get_task(task_id) → check status (queued/running/complete/failed)
2. If streaming: send_task_streaming → get partial results as they arrive

MUST DO

• Validate agent card before dispatching sensitive data
• Set explicit timeouts on all tasks
• Track every task to completion (don't fire-and-forget)
• Use streaming for long-running tasks (better UX)

MUST NOT DO

• Don't send sensitive data to unvalidated agents
• Don't leave tasks running indefinitely without timeout
• Don't dispatch without checking agent is available