# Aggrega

> O Aggrega é um compilador de código aberto para infraestrutura como código: uma única descrição YAML da sua aplicação se torna arquivos de Kubernetes, Helm, Compose, Terraform ou CloudFormation que você revisa e que são seus.

URL: https://aggrega.ai/pt-br/

## Descreva a arquitetura uma vez. Obtenha o código de infraestrutura para cada plataforma que você usa.

O Aggrega é um compilador de código aberto para infraestrutura como código: uma única descrição YAML da sua aplicação se torna arquivos de **Kubernetes**, **Helm**, **Compose**, **Terraform** ou **CloudFormation** que você revisa e que são seus.

Já criou um agente com **LangGraph**, **CrewAI**, **n8n**, **Dify** ou outros? Importe-o.

[Configure com seu assistente de IA](https://aggrega.ai/pt-br/#ai-assistant)[Início rápido](https://aggrega.ai/docs/pt-br/getting-started/)[Importe seu projeto](https://aggrega.ai/pt-br/#import)

Linux e macOS

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

Windows, no PowerShell

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

Dois exemplos de início rápido, construídos um passo de cada vez: um agente de IA em um modelo local e uma aplicação web com PostgreSQL. Cada passo mostra os arquivos que altera com as linhas que adiciona, o comando aggrega build e os arquivos que o build grava.

### Funciona com seu assistente de IA

Cole este prompt em um assistente que possa executar comandos, e ele instala o Aggrega, adiciona a si mesmo a habilidade do Aggrega e se conecta ao servidor MCP do Aggrega. O prompt faz com que ele confirme com você antes de instalar qualquer coisa.

O prompt

Configure o Aggrega para mim, um passo de cada vez, e me diga o que você executou em cada passo.

1. Execute `aggrega version`. Se o comando não for encontrado, me pergunte antes de instalar o Aggrega e depois instale-o para o meu usuário com o instalador oficial: no Linux ou macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, no Windows no PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Execute `aggrega version` de novo. Se o instalador exibiu uma linha para adicionar ao meu `PATH`, mostre-a para mim.

2. Se `https://aggrega.ai/docs/ai-assistants/skill/` indicar uma forma de instalar o plugin do Aggrega em você, me pergunte antes de instalá-lo e depois instale-o dessa forma, ou me diga o que fazer quando for uma etapa que eu realizo na sua interface. O plugin adiciona a skill do Aggrega e conecta você ao servidor MCP do Aggrega. Caso contrário, execute `aggrega skills install --help` e encontre o seu próprio identificador na lista que ele exibe. Me pergunte se quero a skill neste projeto ou em todos os projetos e depois execute `aggrega skills install --agent <your identifier>`, adicionando `--global` para todos os projetos. Se você não estiver na lista, pule a instalação da skill e me avise.

3. Se você instalou o plugin, já está conectado ao servidor MCP do Aggrega. Caso contrário, conecte-se ao servidor MCP do Aggrega, que é o comando `aggrega mcp`, da forma como você adiciona um servidor MCP, como `https://aggrega.ai/docs/ai-assistants/mcp-server/` descreve para você. Se precisar reiniciar ou recarregar para carregar o plugin ou o servidor, me diga o que fazer.

4. Depois de conectado, chame a ferramenta `describe-capabilities` sem argumentos e resuma o que ela lista.

**Mostrar o prompt completo**

- **A habilidade** — Explica ao assistente como funciona o ciclo de criação e que ele deve tirar toda resposta sobre um esquema ou um arquivo do binário aggrega.

- **O servidor MCP** — aggrega mcp dá ao assistente as ferramentas do Aggrega: scaffold, validate, build e as demais.

[O que muda de um assistente para outro](https://aggrega.ai/docs/pt-br/ai-assistants/set-up/)

### Como funciona

Você descreve a aplicação, o Aggrega grava os arquivos e as ferramentas que você já usa os implantam. O Aggrega nunca acessa um cluster em execução nem uma conta de nuvem.

Aggregate descreve sua aplicação

Release as configurações de um ambiente

Manifest como cada parte é construída

aggrega build mesma entrada, mesmos arquivos

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

arquivos que você revisa e que são seus

Fora do Aggrega

ArgoCD · Flux · Terraform implantam o que ele escreveu

O Aggrega para nos arquivos. Ele nunca acessa um cluster em execução nem uma conta na nuvem; suas próprias ferramentas implantam o que ele escreveu.

#### Descreva a aplicação

Um **Aggregate** nomeia seus **componentes** e como eles se conectam.

#### Escolha o ambiente

Uma **Release** fornece as configurações desse ambiente.

#### Escolha como cada parte é construída

Um **Manifest** associa cada componente a uma **Recipe** para a sua plataforma, como um chart do Helm, um módulo do Terraform ou um contêiner.

#### Execute aggrega build

O comando grava os arquivos para cada plataforma: os **mesmos arquivos** para a mesma entrada, sempre.

#### Implante com suas ferramentas

O que o comando gravou é implantado pelo **ArgoCD**, pelo **Flux** ou pelo **Terraform**.

### O que você pode construir

Comece por um exemplo executável ou pelos componentes do catálogo.

#### Agentes de IA e gateways

Agentes criados com LangGraph, CrewAI, LlamaIndex, Dify, n8n e outros, atrás de gateways de modelos com orçamentos de tokens, cache semântico, mascaramento de logs e um escudo contra injeção de prompt.

[Um agente atrás de um gateway com um orçamento de tokens](https://aggrega.ai/docs/pt-br/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Cargas de trabalho tradicionais

Bancos de dados, caches, brokers de mensagens e gerenciamento de identidade, por exemplo PostgreSQL, MariaDB, Redis, Kafka e Keycloak.

[Um banco de dados PostgreSQL, implantado de três formas](https://aggrega.ai/docs/pt-br/language-reference/examples/postgres-three-realizations/)

#### Features

Recursos que você anexa por ambiente sem mexer na aplicação, por exemplo um escudo contra injeção de prompt, mascaramento de dados sensíveis, ingress HTTPS, monitoramento e backups.

[Um gateway que verifica cada requisição em busca de injeção de prompt](https://aggrega.ai/docs/pt-br/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Uma aplicação, muitas plataformas

O mesmo Aggregate é construído para Docker Compose em um notebook e para Kubernetes em produção: mudar de destino muda um mapeamento, não o seu código.

[Um Aggregate, construído para Compose e Kubernetes](https://aggrega.ai/docs/pt-br/language-reference/examples/mariadb-adminer/)

aggregate.yaml escrito uma vez

Em um notebook

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

Em um cluster Kubernetes

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

manifestos do Kubernetes

Cada plataforma é construída a partir de sua própria Release e de seu próprio Manifest. O Aggregate, que descreve sua aplicação, continua o mesmo.

#### Governança e políticas

Suas políticas se conectam ao compilador e interrompem um build que as viole, dizendo o que corrigir.

[Uma política, verificada em quatro destinos](https://aggrega.ai/docs/pt-br/language-reference/examples/policy-render-verdict/)

aggrega build

sua política conectada ao compilador

aprovado

arquivos gravados prontos para revisar e implantar

reprovado

build interrompido policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

Uma política pode interromper um build e dizer o que corrigir. Ela nunca altera seus arquivos para fazê-los passar.

#### Builds reproduzíveis

Mesma entrada, mesma saída, com cada dependência fixada em um lockfile.

[Construa um exemplo e seu lockfile](https://aggrega.ai/docs/pt-br/language-reference/examples/ai-agent-and-model-router/#building)

#### O catálogo da biblioteca padrão

Components para agentes, modelos, gateways, armazenamentos de dados, mensageria, observabilidade, segurança e armazenamento, prontos para uso em um Aggregate.

[Navegue pelo catálogo](https://aggrega.ai/catalog/pt-br/browse)

### Seu assistente, com o Aggrega

O que um assistente que escreve seu código de infraestrutura ganha ao trabalhar por meio do Aggrega.

- **Reproduzível** — Mesma entrada, mesmos arquivos, com cada dependência fixada em um lockfile.

- **Uma única descrição** — Uma única descrição da aplicação, construída para cada plataforma em que ela roda.

- **Políticas em tempo de build** — Suas políticas rodam no compilador e interrompem um build que as viole.

- **Um catálogo assinado e versionado** — O que um assistente baixa do catálogo é versionado e assinado, e o download verifica cada assinatura.

- **Verificado pelo compilador** — O assistente valida e constrói com o binário aggrega, e tira dele as respostas sobre esquemas e arquivos.

### Destinos

Cada plataforma recebe os arquivos que lê nativamente. Agentes de IA rodam em qualquer cluster Kubernetes, e muitos também no Compose.

- **Kubernetes** — Manifestos do Kubernetes, um arquivo por recurso, para o ArgoCD ou o Flux aplicarem.

- **Helm** — Charts do Helm, renderizados em manifestos do Kubernetes.

- **Compose** — Um arquivo do Docker Compose, para rodar a aplicação em um notebook.

- **Terraform** — Configuração para serviços gerenciados de nuvem. O Aggrega nunca executa o Terraform.

- **CloudFormation** — Templates de stack para a AWS. O Aggrega nunca executa o CloudFormation.

[O que cada destino grava](https://aggrega.ai/docs/pt-br/language-reference/providers/reference-matrix/)

### Importação

aggrega import lê um projeto em um destes formatos e grava rascunhos de arquivos do Aggrega para você revisar e editar.

- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose

aggrega import

rascunhos de arquivos do Aggrega para você revisar e editar

Seu projeto existente entra, saem rascunhos de arquivos do Aggrega. Nada é implantado; você revisa os rascunhos primeiro.

[Como funciona a importação](https://aggrega.ai/docs/pt-br/authoring/import/)

### Comece agora

#### Início rápido

Instale o Aggrega, construa um exemplo executável, execute-o na sua máquina e depois faça-o crescer um passo de cada vez.

[Primeiros passos](https://aggrega.ai/docs/pt-br/getting-started/)

#### Execute um primeiro exemplo

Cada exemplo executável é um workspace completo que você constrói com a CLI aggrega.

[Navegue pelos exemplos](https://aggrega.ai/docs/pt-br/language-reference/examples/)

#### Instalação

Um único comando instala o binário aggrega para o seu usuário, sem direitos de administrador.

[Instale o binário](https://aggrega.ai/docs/pt-br/install/#install-the-binary)

### Código aberto

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

#### O compilador

O binário aggrega e sua interface de linha de comando.

[aggrega-ai/aggrega-cli no GitHub](https://github.com/aggrega-ai/aggrega-cli)

#### Visual Studio Code

Validação, navegação, hover e preenchimento automático para o YAML do Aggrega, com base no binário aggrega.

[A extensão no GitHub](https://github.com/aggrega-ai/aggrega-vscode-extension)
