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 | shWindows, no PowerShell
irm https://aggrega.ai/install.ps1 | iexDois 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/valkeyaggrega 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.
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.
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.
- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation
ficheiros que revê e que são seus
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 tokensCargas 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 formasFeatures
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 promptsUma 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 Kubernetesaggregate.yamlescrito uma vezNum portátil
release-compose.yamlmanifest-compose.yamlaggrega builddocker-compose.yamlNum cluster Kubernetes
release-helm-synth.yamlmanifest-helm-synth.yamlaggrega buildmanifestos do KubernetesCada 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 destinosaggrega builda sua políticaligada ao compiladoraprovadaficheiros escritosprontos para rever e implementarreprovadacompilação interrompidapolicy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencryptedUma 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 bloqueioO 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.
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
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 passosExecutar um primeiro exemplo
Cada exemplo executável é um espaço de trabalho completo que se constrói com a CLI aggrega.
Explorar os exemplosInstalaçã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.
O compilador
O binário aggrega e a sua interface de linha de comandos.
aggrega-ai/aggrega-cli no GitHubVisual 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