# Aggrega

> O Aggrega é um compilador de código aberto para infraestrutura como código: uma única descrição YAML da sua aplicação torna-se ficheiros de Kubernetes, Helm, Compose, Terraform ou CloudFormation que revê e que lhe pertencem.

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

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

O Aggrega é um compilador de código aberto para infraestrutura como código: uma única descrição YAML da sua aplicação torna-se ficheiros de **Kubernetes**, **Helm**, **Compose**, **Terraform** ou **CloudFormation** que revê e que lhe pertencem.

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

[Configurar com o seu assistente de IA](https://aggrega.ai/pt/#ai-assistant)[Início rápido](https://aggrega.ai/docs/pt/getting-started/)[Importar o seu projeto](https://aggrega.ai/pt/#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 passo a passo: um agente de IA num modelo local e uma aplicação web com PostgreSQL. Cada passo mostra os ficheiros que altera com as linhas que acrescenta, o comando aggrega build e os ficheiros que a compilação escreve.

### Funciona com o seu assistente de IA

Cole este prompt num assistente que possa executar comandos e este instala o Aggrega, acrescenta a si próprio a competência do Aggrega e liga-se ao servidor MCP do Aggrega. O prompt leva-o a confirmar consigo antes de instalar seja o que for.

O prompt

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

1. Execute `aggrega version`. Se o comando não for encontrado, pergunte-me antes de instalar o Aggrega e depois instale-o para o meu utilizador 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` novamente. Se o instalador mostrou uma linha a acrescentar ao meu `PATH`, mostre-ma.

2. Se `https://aggrega.ai/docs/ai-assistants/skill/` indicar uma forma de instalar em si o plugin do Aggrega, pergunte-me antes de o instalar e depois instale-o dessa forma, ou diga-me o que fazer quando se tratar de um passo que eu próprio executo na sua interface. O plugin acrescenta a skill do Aggrega e liga-o ao servidor MCP do Aggrega. Caso contrário, execute `aggrega skills install --help` e encontre o seu próprio identificador na lista que o comando apresenta. Pergunte-me se quero a skill neste projeto ou em todos os projetos e depois execute `aggrega skills install --agent <your identifier>`, acrescentando `--global` para todos os projetos. Se não estiver na lista, não instale a skill e diga-mo.

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

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

**Mostrar o prompt completo**

- **A competência** — Explica ao assistente como decorre o ciclo de criação e que deve obter do binário aggrega todas as respostas sobre um esquema ou um ficheiro.

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

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

### Como funciona

Descreve-se a aplicação, o Aggrega escreve os ficheiros e as ferramentas que já utiliza implementam-nos. O Aggrega nunca acede a um cluster em execução nem a uma conta na nuvem.

Aggregate descreve a aplicação

Release as definições de um ambiente

Manifest como cada parte é construída

aggrega build mesma entrada, mesmos ficheiros

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

ficheiros que revê e que são seus

Fora do Aggrega

ArgoCD · Flux · Terraform implementam o que escreveu

O Aggrega fica-se pelos ficheiros. Nunca acede a um cluster em execução nem a uma conta na nuvem; são as suas próprias ferramentas que implementam o que escreveu.

#### Descrever a aplicação

Um **Aggregate** nomeia os seus **componentes** e a forma como se ligam.

#### Escolher o ambiente

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

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

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

#### Executar aggrega build

O comando escreve os ficheiros para cada plataforma: os **mesmos ficheiros** para a mesma entrada, sempre.

#### Implementar com as suas ferramentas

O que o comando escreveu é implementado pelo **ArgoCD**, pelo **Flux** ou pelo **Terraform**.

### O que 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, por trás de gateways de modelos com orçamentos de tokens, cache semântica, mascaramento de registos e um escudo contra injeção de prompts.

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

#### Cargas de trabalho tradicionais

Bases de dados, caches, brokers de mensagens e gestão de identidades, por exemplo PostgreSQL, MariaDB, Redis, Kafka e Keycloak.

[Uma base de dados PostgreSQL, implementada de três formas](https://aggrega.ai/docs/pt/language-reference/examples/postgres-three-realizations/)

#### Features

Capacidades que se anexam por ambiente sem mexer na aplicação, por exemplo um escudo contra injeção de prompts, mascaramento de dados sensíveis, ingress HTTPS, monitorização e cópias de segurança.

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

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

O mesmo Aggregate é construído para Docker Compose num portátil 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/language-reference/examples/mariadb-adminer/)

aggregate.yaml escrito uma vez

Num portátil

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

Num cluster Kubernetes

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

manifestos do Kubernetes

Cada plataforma é construída a partir da sua própria Release e do seu próprio Manifest. O Aggregate, que descreve a aplicação, mantém-se igual.

#### Governação e políticas

As suas políticas ligam-se ao compilador e param uma compilação que as viole, indicando o que corrigir.

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

aggrega build

a sua política ligada ao compilador

aprovada

ficheiros escritos prontos para rever e implementar

reprovada

compilação interrompida policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

Uma política pode interromper uma compilação e indicar o que corrigir. Nunca altera os seus ficheiros para os fazer passar.

#### Compilações reprodutíveis

Mesma entrada, mesma saída, com cada dependência fixada num ficheiro de bloqueio.

[Construir um exemplo e o seu ficheiro de bloqueio](https://aggrega.ai/docs/pt/language-reference/examples/ai-agent-and-model-router/#building)

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

Components para agentes, modelos, gateways, armazenamentos de dados, mensagens, observabilidade, segurança e armazenamento, prontos a usar num Aggregate.

[Explorar o catálogo](https://aggrega.ai/catalog/pt/browse)

### O seu assistente, com o Aggrega

O que ganha um assistente que escreve o seu código de infraestrutura ao trabalhar através do Aggrega.

- **Reprodutível** — Mesma entrada, mesmos ficheiros, com cada dependência fixada num ficheiro de bloqueio.

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

- **Políticas em tempo de compilação** — As suas políticas são executadas no compilador e param uma compilação que as viole.

- **Um catálogo assinado e versionado** — O que um assistente transfere do catálogo é versionado e assinado, e a transferência verifica cada assinatura.

- **Verificado pelo compilador** — O assistente valida e compila com o binário aggrega e obtém dele as respostas sobre esquemas e ficheiros.

### Destinos

Cada plataforma recebe os ficheiros que lê nativamente. Os agentes de IA são executados em qualquer cluster Kubernetes, e muitos também em Compose.

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

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

- **Compose** — Um ficheiro Docker Compose, para executar a aplicação num portátil.

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

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

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

### Importação

aggrega import lê um projeto num destes formatos e escreve rascunhos de ficheiros do Aggrega para rever e editar.

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

aggrega import

rascunhos de ficheiros do Aggrega para rever e editar

O seu projeto existente entra, saem rascunhos de ficheiros do Aggrega. Nada é implementado; primeiro revê os rascunhos.

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

### Começar

#### Início rápido

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

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

#### Executar um primeiro exemplo

Cada exemplo executável é um espaço de trabalho completo que se constrói com a CLI aggrega.

[Explorar os exemplos](https://aggrega.ai/docs/pt/language-reference/examples/)

#### Instalação

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

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

### Código aberto

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

#### O compilador

O binário aggrega e a sua interface de linha de comandos.

[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)
