Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Aggrega

O que é o Aggrega

O Aggrega é um compilador de código aberto para a arquitetura da era da IA. Descreva os componentes de uma aplicação e como eles se conectam; o Aggrega os transforma, de forma determinística, nos arquivos de implantação que a executam.

  • Use as linguagens que você conhece. Um compilador para as linguagens que você já usa: entra YAML; saem charts do Helm, manifestos do Kubernetes e arquivos do Compose, Terraform ou CloudFormation.
  • Desenvolvedores descrevem, Ops implementa. Os desenvolvedores declaram os componentes, suas funcionalidades e quem usa quem; o time de plataforma decide como e onde cada um é executado.
  • Uma aplicação, muitas plataformas. A mesma aplicação roda no Docker Compose em um laptop e no Kubernetes em produção: mudar o destino muda um mapeamento, não o seu código.
  • Reproduzível e governado. Mesma entrada, mesma saída, com cada dependência fixada em um lockfile. Suas políticas se conectam ao compilador e interrompem um build que as viola, dizendo o que corrigir.

Aggrega significa “reúne” em italiano: o nome diz o que a ferramenta faz, reunindo as partes de uma aplicação em uma única descrição.

  • Use com seu assistente de IA

    Cole um único prompt em um assistente capaz de executar comandos: ele instala o Aggrega, adiciona a skill do Aggrega e se conecta ao servidor MCP do Aggrega, consultando você antes de instalar qualquer coisa.

  • Início rápido

    Instale o Aggrega, grave um exemplo executável em uma pasta e execute-o na sua máquina; depois, faça-o crescer um passo de cada vez: um agente de IA em um modelo local, ou uma aplicação web com PostgreSQL.

  • Aprenda Aggrega

    Um percurso pela documentação em ordem de leitura, desde para que serve o Aggrega até a referência da linguagem.

Instalação

No Linux e no macOS:

Terminal window
curl -fsSL https://aggrega.ai/install.sh | sh

No Windows, no PowerShell:

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

Qualquer um dos comandos instala o binário aggrega para o usuário atual. Instalação explica o que o comando faz, além de Homebrew, Scoop, winget e o download manual; Conectar o servidor MCP conecta um assistente de IA. A extensão do Aggrega para Visual Studio Code traz validação, navegação, hover e preenchimento automático para o YAML do Aggrega, com base no binário aggrega.

A documentação

Documentação voltada aos usuários da linguagem e do compilador Aggrega, escrita em inglês e traduzida para todos os outros idiomas que o site oferece. Ela tem três partes.

  • Arquitetura — o “porquê” do Aggrega. Visão, posicionamento, modelo mental, pipeline do compilador em nível conceitual, governança corporativa, catálogo, extensibilidade, escolhas de design. Na primeira leitura, siga em ordem os capítulos numerados de 01 a 16.
  • Guia de criação — o “como sentar e criar” do Aggrega. O ciclo de criação, os quatro papéis que colaboram, o mapa de tipos de entidade para papéis e como conectar um assistente de IA pelo servidor Model Context Protocol. Comece por Criar arquivos do Aggrega; para que seu assistente de IA instale e configure o Aggrega por conta própria, cole o prompt de Configurar o Aggrega com seu assistente de IA.
  • Referência da linguagem — o “quê” e o “como usar” do Aggrega. Comece por Status da linguagem para conhecer o estado atual de maturidade e, na primeira leitura, siga em ordem os capítulos numerados de 01 a 09. Os subdiretórios sem número (entities/, vocabulary/, templates/, providers/, plugins/, schema/, cli/, errors/, examples/) são catálogos de referência — vá direto aos itens específicos conforme precisar.

Sobre o Aggrega

O compilador Aggrega é open source sob a licença Apache-2.0, e continuará assim: não haverá nenhuma edição fechada do compilador, nenhum open-core. Todos os recursos do compilador estarão disponíveis na versão open source.

O ecossistema se apoia em quatro pilares:

  1. O modelo de separação (inspirado no OAM): uma orientação de design que separa a intenção do desenvolvedor (o “O quê” e o “Quanto” abstratos) da realidade física de Platform Ops (o “Como” e o “Onde” físicos). O compilador não impõe essa separação: ele aceita qualquer padrão de autoria que passe na validação de schema.
  2. A DSL semântica & a ontologia operacional: os desenvolvedores mapeiam a arquitetura usando um conjunto fechado de primitivas universais de nuvem (por exemplo, server, worker, stateful-server) no rótulo reservado component.aggrega.ai/type do Aggrega. Todo o contexto avançado—como a autonomia de agentes de IA, as capacidades generativas ou a conformidade de dados—é sobreposto por meio de rótulos estáticos de Duck-Typing, e um catálogo que classifica os componentes em um eixo próprio adiciona uma chave de rótulo própria.
  3. Políticas programáveis & validação: o compilador Go central se mantém sem opiniões próprias. A governança corporativa é conduzida inteiramente por padrões do setor e por WebAssembly plugável: JSON Schema 2020-12 (escrito em uma notação abreviada compacta em formato de YAML ou em JSON Schema YAML completo) para a validação do catálogo, o papel label-transform do soquete de governança para a marcação dinâmica da topologia e seus papéis de veredito para avaliar os limites de segurança da arquitetura.
  4. O compilador AOT & a passagem para a execução: um pipeline de compilação rigoroso traduz a DSL em um grafo de representação intermediária (IR) agnóstico em relação às capacidades. A IR captura a topologia dos componentes e as arestas uses entre eles (quem usa quem); o compilador passa esse grafo ao soquete de governança WebAssembly (Wasm) para detectar vulnerabilidades de confiança transitivas e, em seguida, executa os plugins de renderização Wasm para gerar as configurações precisas de proxy e de guardrails. O Aggrega grava esses artefatos em disco e os repassa a outras ferramentas, como pipelines de CI/CD ou orquestradores de runtime, que os implantam.

Licença

A documentação do Aggrega é distribuída sob a Apache License, Version 2.0; o texto completo está no arquivo LICENSE do seu repositório.