DevOps Multi-Agent System

A hierarchical, modular AI agent system for DevOps troubleshooting.

Project Structure

devops_agent/                    # Source code root
├── devops_agent/                # Main package
│   ├── agent.py                 # Root agent definition
│   ├── prompts.py               # Supervisor instructions
│   ├── tools.py                 # Shared tools
│   └── sub_agents/              # Specialist agents
│       ├── gke_expert/          # Kubernetes expert (MCP)
│       ├── snow_expert/         # ServiceNow expert (MCP)
│       ├── logging_expert/      # Cloud Logging expert (Tool-based)
│       └── github_expert/       # GitHub & CI/CD expert (MCP)
│
├── pyproject.toml               # Project configuration (uv)
├── uv.lock                      # Dependency lockfile
└── README.md

Pattern

Each agent folder contains:

• agent.py - Agent definition
• tools.py - MCP/function tools
• prompts.py - System instructions
• sub_agents/ - Nested sub-agents (recursive)

Quick Start

cd devops_agent
# Install dependencies with uv
uv sync
# Set up environment
cp .env.example .env
# Edit .env with your credentials
# Run the agent
uv run adk run