Esta página se tradujo automáticamente. Leer el original en inglés.
Describe la arquitectura una vez.Obtén el código de infraestructura para cada plataforma que usas.
Aggrega es un compilador de código abierto para infraestructura como código: una única descripción YAML de tu aplicación se convierte en archivos de Kubernetes, Helm, Compose, Terraform o CloudFormation que revisas y que son tuyos.
¿Ya has creado un agente con LangGraph, CrewAI, n8n, Dify u otros? Impórtalo.
Linux y macOS
curl -fsSL https://aggrega.ai/install.sh | shWindows, en PowerShell
irm https://aggrega.ai/install.ps1 | iexDos ejemplos de inicio rápido, construidos paso a paso: un agente de IA sobre un modelo local y una aplicación web con PostgreSQL. Cada paso muestra los archivos que cambia con las líneas que añade, el comando aggrega build y los archivos que escribe la compilación.
aggregate.yaml
kind: Aggregatespec: components: chat: type: core/compute/server agent: type: core/ai-agent/langgraph llm: type: core/ai-model/ollama memory: type: core/datastore/valkeyaggrega build --release release.yaml --auto-pull
- dist/compose/docker-compose.yaml
Funciona con tu asistente de IA
Pega este prompt en un asistente que pueda ejecutar comandos y este instalará Aggrega, se añadirá la habilidad de Aggrega y se conectará al servidor MCP de Aggrega. El prompt le hace consultarte antes de instalar nada.
Configura Aggrega para mí, paso a paso, y dime qué ejecutaste en cada paso.
1. Ejecuta `aggrega version`. Si no se encuentra el comando, pregúntame antes de instalar Aggrega y luego instálalo para mi usuario con el instalador oficial: en Linux o macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, en Windows en PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Vuelve a ejecutar `aggrega version`. Si el instalador mostró una línea para añadir a mi `PATH`, muéstramela.
2. Si `https://aggrega.ai/docs/ai-assistants/skill/` indica una forma de instalar el plugin de Aggrega en ti, pregúntame antes de instalarlo, y luego instálalo de esa forma, o dime qué hacer cuando se trate de un paso que realizo yo en tu interfaz. El plugin añade la skill de Aggrega y te conecta al servidor MCP de Aggrega. De lo contrario, ejecuta `aggrega skills install --help` y busca tu propio identificador en la lista que imprime. Pregúntame si quiero la skill en este proyecto o en todos los proyectos, y luego ejecuta `aggrega skills install --agent <your identifier>`, añadiendo `--global` para todos los proyectos. Si no estás en la lista, omite la instalación de la skill y dímelo.
3. Si instalaste el plugin, ya estás conectado al servidor MCP de Aggrega. De lo contrario, conéctate al servidor MCP de Aggrega, que es el comando `aggrega mcp`, de la forma en que añades un servidor MCP, como `https://aggrega.ai/docs/ai-assistants/mcp-server/` lo describe para ti. Si necesitas reiniciar o recargar para cargar el plugin o el servidor, dime qué hacer.
4. Una vez conectado, llama a la herramienta `describe-capabilities` sin argumentos y resume lo que enumera.
- La habilidad
- Le indica al asistente cómo funciona el ciclo de autoría y que tome cada respuesta sobre un esquema o un archivo del binario aggrega.
- El servidor MCP
- aggrega mcp le da al asistente las herramientas de Aggrega: scaffold, validate, build y las demás.
Cómo funciona
Tú describes la aplicación, Aggrega escribe los archivos y las herramientas que ya usas los despliegan. Aggrega nunca accede a un clúster en ejecución ni a una cuenta en la nube.
- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation
archivos que revisas y que te pertenecen
Describe la aplicación
Un Aggregate nombra sus componentes y cómo se conectan.
Elige el entorno
Una Release aporta la configuración de ese entorno.
Elige cómo se construye cada parte
Un Manifest asigna cada componente a una Recipe para tu plataforma, como un chart de Helm, un módulo de Terraform o un contenedor.
Ejecuta aggrega build
El comando escribe los archivos para cada plataforma: los mismos archivos para la misma entrada, siempre.
Despliega con tus herramientas
Lo que escribió el comando lo despliegan ArgoCD, Flux o Terraform.
Qué puedes construir
Empieza con un ejemplo ejecutable o con los componentes del catálogo.
Agentes de IA y gateways
Agentes creados con LangGraph, CrewAI, LlamaIndex, Dify, n8n y otros, detrás de gateways de modelos con presupuestos de tokens, caché semántica, enmascaramiento de registros y un escudo contra la inyección de prompts.
Un agente detrás de un gateway con un presupuesto de tokensCargas de trabajo tradicionales
Bases de datos, cachés, brokers de mensajes y gestión de identidades, por ejemplo PostgreSQL, MariaDB, Redis, Kafka y Keycloak.
Una base de datos PostgreSQL, desplegada de tres manerasFeatures
Capacidades que adjuntas por entorno sin tocar la aplicación, por ejemplo un escudo contra la inyección de prompts, el enmascaramiento de datos sensibles, ingress HTTPS, supervisión y copias de seguridad.
Un gateway que revisa cada solicitud en busca de inyección de promptsUna aplicación, muchas plataformas
El mismo Aggregate se construye para Docker Compose en un equipo portátil y para Kubernetes en producción: cambiar de destino cambia un mapeo, no tu código.
Un Aggregate, construido para Compose y Kubernetesaggregate.yamlescrito una vezEn un portátil
release-compose.yamlmanifest-compose.yamlaggrega builddocker-compose.yamlEn un clúster de Kubernetes
release-helm-synth.yamlmanifest-helm-synth.yamlaggrega buildmanifiestos de KubernetesCada plataforma se construye a partir de su propia Release y su propio Manifest. El Aggregate, que describe tu aplicación, sigue siendo el mismo. Gobernanza y políticas
Tus políticas se conectan al compilador y detienen una compilación que las incumple, indicando qué corregir.
Una política, comprobada en cuatro destinosaggrega buildtu políticaconectada al compiladoraprobadaarchivos escritoslistos para revisar y desplegarrechazadacompilación detenidapolicy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencryptedUna política puede detener una compilación e indicar qué corregir. Nunca cambia tus archivos para que la superen. Compilaciones reproducibles
Misma entrada, misma salida, con cada dependencia fijada en un archivo de bloqueo.
Construye un ejemplo y su archivo de bloqueoEl catálogo de la biblioteca estándar
Components para agentes, modelos, gateways, almacenes de datos, mensajería, observabilidad, seguridad y almacenamiento, listos para usar en un Aggregate.
Explora el catálogo
Tu asistente, con Aggrega
Lo que gana un asistente que escribe tu código de infraestructura al trabajar a través de Aggrega.
- Reproducible
- Misma entrada, mismos archivos, con cada dependencia fijada en un archivo de bloqueo.
- Una sola descripción
- Una sola descripción de la aplicación, construida para cada plataforma en la que se ejecuta.
- Políticas en tiempo de compilación
- Tus políticas se ejecutan en el compilador y detienen una compilación que las incumple.
- Un catálogo firmado y versionado
- Lo que un asistente descarga del catálogo está versionado y firmado, y la descarga verifica cada firma.
- Comprobado por el compilador
- El asistente valida y compila con el binario aggrega, y toma de él sus respuestas sobre esquemas y archivos.
Destinos
Cada plataforma recibe los archivos que lee de forma nativa. Los agentes de IA se ejecutan en cualquier clúster de Kubernetes, y muchos también en Compose.
- Kubernetes
- Manifiestos de Kubernetes, un archivo por recurso, para que ArgoCD o Flux los apliquen.
- Helm
- Charts de Helm, renderizados en manifiestos de Kubernetes.
- Compose
- Un archivo de Docker Compose, para ejecutar la aplicación en un equipo portátil.
- Terraform
- Configuración para servicios gestionados en la nube. Aggrega nunca ejecuta Terraform.
- CloudFormation
- Plantillas de stack para AWS. Aggrega nunca ejecuta CloudFormation.
Importación
aggrega import lee un proyecto en uno de estos formatos y escribe borradores de archivos de Aggrega para que los revises y edites.
- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose
Comienza
Inicio rápido
Instala Aggrega, construye un ejemplo ejecutable, ejecútalo en tu máquina y luego hazlo crecer paso a paso.
Primeros pasosEjecuta un primer ejemplo
Cada ejemplo ejecutable es un espacio de trabajo completo que construyes con la CLI de aggrega.
Explora los ejemplosInstalación
Un solo comando instala el binario aggrega para tu usuario, sin permisos de administrador.
Instala el binario
Código abierto
El compilador de Aggrega es de código abierto bajo Apache-2.0, y seguirá siéndolo: no habrá una edición cerrada del compilador, ni open-core. Todas las funcionalidades del compilador estarán disponibles en la versión de código abierto.
El compilador
El binario aggrega y su interfaz de línea de comandos.
aggrega-ai/aggrega-cli en GitHubVisual Studio Code
Validación, navegación, información al pasar el cursor y autocompletado para el YAML de Aggrega, respaldados por el binario aggrega.
La extensión en GitHub