Arquitectura
La mayoría de los diagramas de arquitectura mezclan niveles y esconden lo que significan las flechas. C4 le da a los proyectos de agentes cuatro niveles de zoom. Usa las pestañas para pasar del sistema completo hasta el código.
6 nov. 2026 · 6 min de lectura
El diagrama y las fuentes están en inglés.
Los proyectos de agentes cambian de forma rápido: aparece una pasarela de herramientas, la memoria pasa a su propio almacén, se suma un segundo proveedor de modelos. El diagrama de la wiki suele dejar de coincidir con el sistema en cuestión de semanas, y a menudo nunca respondió la primera pregunta que hace alguien nuevo en el equipo: ¿cuáles son las partes y quién habla con quién?
El modelo C4, creado por Simon Brown, describe el software en cuatro niveles de zoom: sistema de software, contenedor, componente y código. El sitio de C4 es explícito en que no tienes que usar todos los niveles, y en que los diagramas de contexto del sistema y de contenedores bastan para la mayoría de los equipos.
Usa las pestañas de arriba para moverte entre los niveles. Muestran la misma plataforma de agentes de ejemplo, cada una con un paso más de zoom.
Un contenedor es algo que tiene que estar funcionando para que el sistema opere: una aplicación web, un servicio de agentes, una pasarela de herramientas, una base de datos. El proveedor de modelos y los sistemas del negocio no son nuestros, así que se dibujan como sistemas externos fuera del límite.
Guarda el código fuente del diagrama en el repositorio y revísalo en el mismo pull request que el cambio que describe. Un diagrama que se edita junto con el código se mantiene honesto. Uno que vive solo en una presentación, no.
Contanos un proceso. Te mostramos cómo lo podría resolver un agente y qué medir para saber que funciona.