Pular para o conteúdo
Aggrega

Esta página foi traduzida automaticamente. Ler o original em inglês.

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.

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.

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

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

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.

Aggregatedescreve sua aplicação
Releaseas configurações de um ambiente
Manifestcomo cada parte é construída
aggrega buildmesma entrada, mesmos arquivos
  • Kubernetes
  • Helm
  • Compose
  • Terraform
  • CloudFormation

arquivos que você revisa e que são seus

Fora do Aggrega
ArgoCD · Flux · Terraformimplantam 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.
  1. Descreva a aplicação

    Um Aggregate nomeia seus componentes e como eles se conectam.

  2. Escolha o ambiente

    Uma Release fornece as configurações desse ambiente.

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

  4. Execute aggrega build

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

  5. 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
  • 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
  • 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
  • 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
    aggregate.yamlescrito 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
    aggrega build
    sua políticaconectada ao compilador
    aprovado
    arquivos gravadosprontos para revisar e implantar
    reprovado
    build interrompidopolicy 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
  • 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

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

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

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
  • Execute um primeiro exemplo

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

    Navegue pelos exemplos
  • Instalação

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

    Instale o binário

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.