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

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.

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

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

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.

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

ficheiros que revê e que são seus

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

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

  2. Escolher o ambiente

    Uma Release fornece as definições desse ambiente.

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

  4. Executar aggrega build

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

  5. 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
  • 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
  • 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
  • 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
    aggregate.yamlescrito 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
    aggrega build
    a sua políticaligada ao compilador
    aprovada
    ficheiros escritosprontos para rever e implementar
    reprovada
    compilação interrompidapolicy 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
  • 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

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

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

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
  • 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
  • Instalação

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

    Instalar o binário

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.