O que o assistente pode fazer com o Aggrega
Depois de ligado ao servidor MCP do Aggrega, o assistente trabalha com o mesmo binário aggrega que seria executado num terminal: lê os schemas e a documentação, redige e verifica os ficheiros, faz o build de uma Release e, quando autorizado, publica. Esta página indica o que isso abrange, por grupos. A resposta do próprio servidor é a lista completa, e é nela que se deve confiar: chame describe-capabilities sem argumentos, ou peça ao assistente que o faça, e o servidor lista cada ferramenta que oferece, cada uma com a sua finalidade numa linha, os tipos de entidade que serve e se escreve. Compatibilidade indica o que uma versão pode alterar nas ferramentas.
Ler os schemas e a documentação
O servidor fornece material de referência que um assistente lê antes de escrever YAML: o JSON Schema de uma entidade (schema://<kind>), qualquer página da referência da linguagem (langref://<path>), o guia de criação (authoring://<topic>), o YAML criado de uma entidade do catálogo (catalog://<kind>/<name>) e a ajuda de qualquer comando (cli://<command>). Os schemas estão integrados no binário, e as páginas provêm de uma cópia da documentação que o servidor guarda na cache do computador. O que faz lista cada família.
Assumir um papel ou seguir um fluxo de trabalho
Os prompts de criação colocam o assistente no papel de programador, arquiteto ou autor de operações, ou concentram-no num único tipo de entidade, para que as suas sugestões se mantenham dentro daquilo que esse papel escreve. Os prompts de fluxo de trabalho definem a ordem das chamadas para um objetivo que exige várias: compor um novo Aggregate e a sua Release, trazer para o Aggrega um chart, um módulo de infraestrutura ou um ficheiro Compose existente, ou perceber porque falha um build. O cliente lista-os como os prompts do servidor.
Descobrir o que um workspace contém
list-entities e list-releases indicam o que o workspace contém e em que quantidade, e depois entregam os registos uma página de cada vez; describe mostra uma entidade ou tudo aquilo a que uma Release chega; config-show indica a configuração em vigor e a origem de cada definição. O servidor indica também as caches, os registries configurados e os plugins que resolve. Consulte Descobrir o que um workspace contém.
Redigir e verificar os ficheiros
scaffold redige um documento inicial para um tipo de entidade, com os campos que o tipo exige, ou escreve um dos exemplos executáveis da documentação num novo diretório. get-schema devolve o JSON Schema de um tipo, validate verifica um rascunho e indica cada marcador de posição que ainda contém, lint verifica as convenções de publicação do catálogo, e explain-error desenvolve um diagnóstico na correção que este pede. Outras ferramentas respondem às perguntas que surgem durante a edição: que Features podem ser associadas a um componente e a que este se pode ligar, onde deve ficar uma nova entrada num ficheiro, e uma única edição delimitada aplicada a um documento, com cada byte em que não toca mantido como estava. Consulte Perguntar o que pode ser associado e o que se pode ligar a quê e Aplicar uma única edição delimitada a um documento.
Resolver e fazer o build de uma Release
pull resolve as dependências de uma Release para a cache e escreve o seu lockfile, e build faz o rendering da Release nos seus artefactos, em memória por predefinição ou em dist/ na raiz do workspace quando o assistente lhe pede que os escreva. Um build recusado devolve os diagnósticos que indicam o que corrigir. Consulte Resolver aquilo de que uma Release depende e Fazer o build com o conteúdo que uma Release já fixa.
Trazer um projeto de outra ferramenta
import lê uma descrição produzida por outra ferramenta e escreve rascunhos de ficheiros do Aggrega no workspace, para revisão. Consulte Transformar uma descrição externa em rascunhos de entidades e aggrega import para os formatos que lê.
Publicar, assinar e retirar
Quatro ferramentas colocam uma entidade ou um artefacto num registry, assinam o que lá está publicado ou retiram-no com um marcador assinado. Aquilo que alteram chega a todos os que resolvem a partir desse registry, e nada disso pode ser retirado a quem já o tem, pelo que estas são as ferramentas sobre as quais se deve refletir antes de as autorizar. Consulte Publicar, assinar e retirar.
Executar qualquer comando
Para um cliente que iniciou o servidor no próprio computador do utilizador, através da entrada e saída padrão, o servidor oferece também uma ferramenta para cada comando que se poderia escrever, com o nome desse comando: cli-build executa aggrega build, cli-validate executa aggrega validate, e assim por diante. Um servidor acedido por HTTPS não oferece nenhuma delas.
O que pode fazer sem perguntar
Um assistente ligado através da entrada e saída padrão pode chamar qualquer ferramenta que o servidor ofereça sem perguntar ao utilizador, a menos que o cliente esteja configurado para a recusar. É no cliente que se autorizam e recusam ferramentas pelo nome. O que um assistente pode fazer sem perguntar primeiro indica as operações que vão além do workspace, e Restringir o que o servidor anuncia encurta a lista de ferramentas quando o cliente não a aceita na totalidade.