Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler 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. Descrevem-se os componentes de uma aplicação e a forma como se ligam; o Aggrega transforma-os, de forma determinística, nos ficheiros de implantação que a executam.

  • Use as linguagens que conhece. Um compilador para as linguagens que já usa: entra YAML; saem charts do Helm, manifestos do Kubernetes e ficheiros do Compose, Terraform ou CloudFormation.
  • Os programadores descrevem, as Ops implementam. Os programadores declaram os componentes, as suas funcionalidades e quem usa quem; a equipa de plataforma decide como e onde cada um é executado.
  • Uma aplicação, muitas plataformas. A mesma aplicação é executada no Docker Compose num portátil e no Kubernetes em produção: mudar de destino muda um mapeamento, não o código.
  • Reproduzível e governado. A mesma entrada, a mesma saída, com cada dependência fixada num lockfile. As políticas ligam-se ao compilador e travam uma compilação que as infrinja, indicando o que corrigir.

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

  • Utilizá-lo com o assistente de IA

    Cola-se um único prompt num assistente capaz de executar comandos: este instala o Aggrega, adiciona a skill do Aggrega e liga-se ao servidor MCP do Aggrega, pedindo confirmação antes de instalar o que quer que seja.

  • Início rápido

    Instale o Aggrega, escreva um exemplo executável numa pasta e execute-o no seu computador; depois, faça-o crescer um passo de cada vez: um agente de IA num modelo local, ou uma aplicação web com PostgreSQL.

  • Aprender Aggrega

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

Instalação

Em Linux e 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 utilizador atual. Instalação explica o que o comando faz, bem como Homebrew, Scoop, winget e a transferência manual; Ligar o servidor MCP liga um assistente de IA. A extensão do Aggrega para Visual Studio Code traz validação, navegação, informação ao passar o cursor e preenchimento automático ao YAML do Aggrega, com base no binário aggrega.

A documentação

Documentação para os utilizadores da linguagem e do compilador Aggrega, escrita em inglês e traduzida para todas as outras línguas que o site oferece. Tem três partes.

  • Arquitetura — o «porquê» do Aggrega. Visão, posicionamento, modelo mental, pipeline do compilador a nível concetual, governação empresarial, catálogo, extensibilidade, escolhas de design. Numa primeira leitura, os capítulos numerados de 01 a 16 leem-se por ordem.
  • Guia de criação — o «como sentar-se e criar» do Aggrega. O ciclo de criação, os quatro papéis que colaboram, a correspondência entre tipos de entidade e papéis, e como ligar um assistente de IA através do servidor Model Context Protocol. Comece por Criar ficheiros do Aggrega; para que o assistente de IA instale e configure o próprio Aggrega, cole o prompt de Configurar o Aggrega com o assistente de IA.
  • Referência da linguagem — o «quê» e o «como usar» do Aggrega. Comece por Estado da linguagem para conhecer o estado atual de prontidão e, numa primeira leitura, siga depois os capítulos numerados de 01 a 09 por ordem. Os subdiretórios não numerados (entities/, vocabulary/, templates/, providers/, plugins/, schema/, cli/, errors/, examples/) são catálogos de referência — consultam-se diretamente os itens específicos conforme necessário.

Sobre o Aggrega

O compilador Aggrega é open source sob a licença Apache-2.0, e continuará a sê-lo: não haverá nenhuma edição fechada do compilador, nenhum open-core. Todas as funcionalidades do compilador estarão disponíveis na versão open source.

O ecossistema assenta em quatro pilares:

  1. O modelo de separação (inspirado no OAM): uma orientação de design que separa a intenção do programador (o «quê» e o «quanto» abstratos) da realidade física das Ops da plataforma (o «como» e o «onde» físicos). O compilador não impõe esta separação: aceita qualquer padrão de escrita que passe a validação de schema.
  2. A DSL semântica e a ontologia operacional: os programadores mapeiam a sua arquitetura com um conjunto fechado de primitivas universais da cloud (por exemplo, server, worker, stateful-server) na etiqueta reservada component.aggrega.ai/type do Aggrega. Todo o contexto avançado — como a autonomia dos agentes de IA, as capacidades generativas ou a conformidade dos dados — é sobreposto através de etiquetas estáticas de duck typing, e um catálogo que classifica componentes segundo um eixo próprio acrescenta uma chave de etiqueta própria.
  3. Políticas programáveis e validação: o compilador central em Go é sem opiniões próprias. A governação empresarial é inteiramente conduzida por normas da indústria e por WebAssembly conectável: JSON Schema 2020-12 (escrito numa forma abreviada compacta com o aspeto de YAML ou em YAML de JSON Schema completo) para a validação do catálogo, o papel label-transform do socket de governação para a etiquetagem dinâmica da topologia, e os seus papéis de veredicto para avaliar as fronteiras de segurança da arquitetura.
  4. O compilador AOT e a passagem da execução: um pipeline de compilação estrito traduz a DSL num grafo de representação intermédia (IR) agnóstico em relação às capacidades. A IR capta a topologia dos componentes e as arestas uses entre eles (quem usa quem); o compilador passa este grafo ao socket de governação WebAssembly (Wasm) para detetar vulnerabilidades de confiança transitiva e, em seguida, executa plugins de renderização Wasm para gerar as configurações exatas de proxies e de guardrails. O Aggrega escreve estes artefactos em disco e entrega-os a outras ferramentas, como pipelines de CI/CD ou orquestradores de runtime, que os implantam.

Licença

A documentação do Aggrega é distribuída ao abrigo da Apache License, Version 2.0; o texto completo encontra-se no ficheiro LICENSE do respetivo repositório.