template-multi-agent-ops

Multi-agent operations template implementing the A2A (Agent-to-Agent) protocol with Agent Cards for discovery, task delegation, and OpenTelemetry observability for agent interactions.

Architecture

+------------------------------------------------------------------+
|                        CLI (click)                                |
|  agents | task | status | trace | topology                       |
+------------------------------------------------------------------+
|                                                                  |
|  +------------------+    +-------------------+                   |
|  |  Orchestration   |    |    Observability   |                  |
|  |  +-----------+   |    |  +-----------+     |                  |
|  |  | Planner   |   |    |  | Tracer    |     |                  |
|  |  +-----------+   |    |  +-----------+     |                  |
|  |  | Delegator |   |    |  | Metrics   |     |                  |
|  |  +-----------+   |    |  +-----------+     |                  |
|  |  | Supervisor|   |    |  | Dashboard |     |                  |
|  |  +-----------+   |    |  +-----------+     |                  |
|  +------------------+    +-------------------+                   |
|                                                                  |
|  +------------------+    +-------------------+                   |
|  |    Protocol      |    |     Agents        |                   |
|  |  +-----------+   |    |  +-----------+    |                   |
|  |  | Messages  |   |    |  | BaseAgent |    |                   |
|  |  +-----------+   |    |  +-----------+    |                   |
|  |  | Router    |   |    |  | AgentCard |    |                   |
|  |  +-----------+   |    |  +-----------+    |                   |
|  |  | Converse  |   |    |  | Registry  |    |                   |
|  |  +-----------+   |    |  +-----------+    |                   |
|  +------------------+    +-------------------+                   |
|                                                                  |
|  +----------------------------------------------------+         |
|  |                   Config                            |         |
|  |  topology.py (YAML agent definitions)               |         |
|  |  settings.py (system tuning parameters)             |         |
|  +----------------------------------------------------+         |
+------------------------------------------------------------------+

Message Flow

User/External
     |
     v
+-----------+     TaskRequest      +----------+     TaskRequest
|  Planner  | --(decompose)--->    | Delegator| ------>  Agent A
+-----------+                      +----------+          Agent B
     |                                  |                Agent C
     v                                  v
+-----------+     StatusUpdate     +----------+
| Supervisor| <--(monitor)----    | Registry |
+-----------+                      +----------+
     |
     v
 Aggregated
  Response

Agent Lifecycle

  init ---> ready ---> busy ---> idle ---> shutdown
              ^         |         |
              |         v         |
              +---- (message) ----+

Conversation State Machine

  negotiating ---> delegated ---> executing ---> completed
       |               |              |
       v               v              v
    failed          failed          failed

Quick Start

pip install -e .
multi-agent-ops --help
multi-agent-ops agents list
multi-agent-ops status

Docker

docker-compose up

Development

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest -v
ruff check src/ tests/

Configuration

Agent topology is defined in YAML:

agents:
  - name: orchestrator
    capabilities: [planning, delegation, supervision]
    queue_size: 100
  - name: network-agent
    capabilities: [network_scan, vulnerability_check]
    queue_size: 50
  - name: security-agent
    capabilities: [threat_analysis, compliance_check]
    queue_size: 50

System settings via settings.py or environment variables:

License

MIT License. Copyright 2026 Corey Wade.