Saltar al contenido
Aggrega

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 | sh

Windows, en PowerShell

irm https://aggrega.ai/install.ps1 | iex

Dos 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/valkey

aggrega 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.

El prompt

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.
Qué cambia de un asistente a otro

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.

Aggregatedescribe tu aplicación
Releasela configuración de un entorno
Manifestcómo se construye cada parte
aggrega buildmisma entrada, mismos archivos
  • Kubernetes
  • Helm
  • Compose
  • Terraform
  • CloudFormation

archivos que revisas y que te pertenecen

Fuera de Aggrega
ArgoCD · Flux · Terraformdespliegan lo que escribió
Aggrega se detiene en los archivos. Nunca accede a un clúster en ejecución ni a una cuenta en la nube; tus propias herramientas despliegan lo que escribió.
  1. Describe la aplicación

    Un Aggregate nombra sus componentes y cómo se conectan.

  2. Elige el entorno

    Una Release aporta la configuración de ese entorno.

  3. 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.

  4. Ejecuta aggrega build

    El comando escribe los archivos para cada plataforma: los mismos archivos para la misma entrada, siempre.

  5. 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 tokens
  • Cargas 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 maneras
  • Features

    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 prompts
  • Una 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 Kubernetes
    aggregate.yamlescrito una vez

    En un portátil

    release-compose.yaml
    manifest-compose.yaml
    aggrega build
    docker-compose.yaml

    En un clúster de Kubernetes

    release-helm-synth.yaml
    manifest-helm-synth.yaml
    aggrega build
    manifiestos de Kubernetes
    Cada 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 destinos
    aggrega build
    tu políticaconectada al compilador
    aprobada
    archivos escritoslistos para revisar y desplegar
    rechazada
    compilación detenidapolicy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted
    Una 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 bloqueo
  • El 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.
Qué escribe cada destino

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
aggrega import
borradores de archivos Aggregapara que los revises y edites
Tu proyecto existente entra, salen borradores de archivos Aggrega. No se despliega nada; primero revisas los borradores.
Cómo funciona la importación

Comienza

  • Inicio rápido

    Instala Aggrega, construye un ejemplo ejecutable, ejecútalo en tu máquina y luego hazlo crecer paso a paso.

    Primeros pasos
  • Ejecuta un primer ejemplo

    Cada ejemplo ejecutable es un espacio de trabajo completo que construyes con la CLI de aggrega.

    Explora los ejemplos
  • Instalació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 GitHub
  • Visual 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