Google ADK + A2A: Documentación del IDP con 7 agentes

Qué es este sistema

google-adk-a2a-idp es un sistema de 7 agentes especializados que construyen un Internal Developer Platform (IDP) completo de forma autónoma. Cada agente tiene una responsabilidad única, escribe sus decisiones en archivos compartidos via A2A Protocol, y el siguiente las lee activamente — sin parámetros directos entre agentes.

El resultado: 21 archivos de infraestructura generados en ~4.5 minutos, desde Docker Compose hasta un portal web funcional con FastAPI.

Los 8 agentes del sistema

Un Orchestrator coordina a los 7 agentes especializados. El Orchestrator gestiona el DAG de ejecución, reintentos y rollback — pero no ejecuta ninguna tarea de infraestructura.

#	Agente	Responsabilidad	Output
0	Orchestrator	Coordina DAG, reintentos (x3) y rollback	`orchestration-report.json`
1	Platform Architect	Analiza la tarea y decide el stack completo	`platform-config.yaml`
2	Infrastructure	Lee el YAML del Arquitecto y genera Docker Compose	`docker-compose/app-stack.yml`
3	Security	Escanea con Trivy, puede bloquear el pipeline	`security-report.json`
4	CI/CD	Genera scripts de build/test/deploy y Jenkinsfile	`cicd/` + `Jenkinsfile`
5	Observability	Configura Prometheus + 2 dashboards Grafana	`grafana-dashboards/`
6	DevEx	Genera CLI tool ejecutable con comandos del proyecto	`cli-tool/idp`
7	Web Portal	Construye portal web completo con FastAPI + HTMX	`portal/`

Qué genera el sistema

Una ejecución completa produce 21 archivos:

test-outputs/idp-adk-sequential/
├── platform-config.yaml          ← Decisiones del Arquitecto
├── docker-compose/
│   └── app-stack.yml             ← Todos los servicios con healthchecks
├── security-report.json          ← Vulnerabilidades y recomendaciones
├── cicd/
│   ├── build.sh
│   ├── test.sh
│   └── deploy.sh
├── Jenkinsfile                   ← Pipeline CI/CD configurado
├── grafana-dashboards/
│   ├── app-metrics.json          ← Latencia, error rate, throughput
│   └── system-metrics.json       ← CPU, memoria, disco
├── cli-tool/idp                  ← CLI con init/build/test/deploy/status/logs
├── portal/                       ← Portal web self-service
│   ├── main.py
│   ├── routes/
│   ├── templates/
│   └── Dockerfile
└── orchestration-report.json     ← Reporte completo de la ejecución

Tecnologías

Componente	Tecnología
Framework de agentes	Google ADK
Orquestación	SequentialAgent
Comunicación entre agentes	A2A Protocol (Linux Foundation)
Modelo de IA	Gemini 2.5 Flash
Infraestructura generada	Docker Compose
Portal generado	FastAPI + Jinja2 + HTMX + TailwindCSS
Monitoreo generado	Prometheus + Grafana
CI/CD generado	Scripts Bash + Jenkinsfile

Cuándo usar este sistema

Quieres ver Google ADK + SequentialAgent en un proyecto real con código funcional
Necesitas un punto de partida sólido para un IDP en tu organización
Quieres entender cómo implementar A2A Protocol con artefactos compartidos
Estás aprendiendo Gemini function calling en un contexto complejo de múltiples agentes

→ Inicio rápido: instalación y primeros pasos