Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

Guia de criação

Este guia é o complemento prático dos capítulos de arquitetura e da referência da linguagem. Enquanto a arquitetura explica porque o Aggrega tem a forma que tem e a referência especifica o que cada campo significa, este guia ensina como pôr mãos à obra e escrever — que entidade usar, por que ordem, e como a CLI e um assistente de IA ajudam a obter um ficheiro correto com o mínimo de atrito.

O guia foi escrito para dois públicos ao mesmo tempo: uma pessoa que escreve à mão num editor e um assistente de IA que escreve em nome de uma pessoa através do servidor Model Context Protocol. Ambos seguem o mesmo ciclo e leem as mesmas superfícies de referência, pelo que as páginas abaixo servem ambos.

Ler por esta ordem

  1. Escrever ficheiros do Aggrega — o ciclo de autoria de ponta a ponta: escolher o papel, aprender a forma, criar o esqueleto, preencher, validar, compilar. Comece aqui.
  2. Personas — os quatro papéis de autoria colaborativos (programador, arquiteto, operações, operador) e o enquadramento de orientação, não de imposição, por trás deles.
  3. Entidades por papel — cada tipo de entidade associado ao papel que normalmente o detém, para saber a que ficheiro pertence cada preocupação.
  4. Instalação — instalar o binário aggrega, com os comandos primeiro; a secção de ligação remete para Ligar o servidor MCP.
  5. Usar o Aggrega no Visual Studio Code — a extensão do Aggrega para o Visual Studio Code: o que necessita, a página de boas-vindas, os seus painéis e o grafo da topologia, e cada definição e comando.

Importação parte de um projeto que já tem noutro formato e gera a partir dele rascunhos destes ficheiros, para os rever e compilar.

Aprender o Aggrega situa este guia num percurso por toda a documentação.

Trabalhar com um assistente de IA

  1. Configurar o Aggrega com o seu assistente de IA — um único prompt para colar num assistente que consiga executar comandos, para que instale o Aggrega, adicione a skill do Aggrega e se ligue sozinho ao servidor.
  2. Ligar o servidor MCP — a entrada do servidor cliente a cliente, onde cada cliente a guarda, um servidor acedido por HTTPS e como verificar a ligação.
  3. A skill do Aggrega — as instruções que um assistente carrega para o Aggrega: como instalá-las e mantê-las atualizadas.
  4. O que o seu assistente pode fazer com o Aggrega — o que o servidor ligado permite a um assistente ler, verificar, compilar e publicar.

Como as superfícies do assistente se relacionam com este guia

O servidor aggrega mcp expõe este guia, a referência da linguagem e os JSON Schemas como recursos que um assistente lê antes de escrever YAML, além de ferramentas que criam o esqueleto de entidades e as validam. Os prompts de autoria integrados do assistente remetem para estas páginas em vez de as repetirem, pelo que este guia é o único lugar em prosa do método de autoria. Consulte Escrever ficheiros do Aggrega para o ciclo e Ligar o servidor MCP para a ligação.