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

O que seu assistente pode fazer com o Aggrega

Depois que seu assistente se conecta ao servidor MCP do Aggrega, ele trabalha com o mesmo binário aggrega que você executaria em um terminal: lê os schemas e a documentação, rascunha e verifica seus arquivos, faz o build de uma Release e, quando você permite, publica. Esta página diz o que isso abrange, em 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 seu assistente que o faça, e o servidor lista cada ferramenta que oferece a você, cada uma com uma finalidade de uma linha, os tipos de entidade que atende e se grava. Compatibilidade informa o que uma release pode mudar 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 são embutidos no binário, e as páginas vêm de uma cópia da documentação que o servidor mantém no cache da sua máquina. O que ele 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 desenvolvedor, arquiteto ou autor de operações, ou o concentram em um único tipo de entidade, para que suas sugestões fiquem dentro do 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 sua Release, trazer para o Aggrega um chart, um módulo de infraestrutura ou um arquivo Compose existente, ou descobrir por que um build falha. Seu cliente os lista como os prompts do servidor.

Descobrir o que um workspace contém

list-entities e list-releases dizem o que seu workspace contém e em que quantidade, e depois entregam os registros uma página por vez; describe mostra uma entidade ou tudo o que uma Release alcança; config-show informa a configuração em vigor e de onde veio cada configuração. O servidor também informa os caches, os registries configurados e os plugins que resolve. Veja Descobrir o que um workspace contém.

Rascunhar e verificar seus arquivos

scaffold rascunha um documento inicial para um tipo de entidade, com os campos que o tipo exige, ou grava um dos exemplos executáveis da documentação em um novo diretório. get-schema retorna o JSON Schema de um tipo, validate verifica um rascunho e aponta cada placeholder que ainda está nele, lint verifica as convenções de publicação do catálogo, e explain-error expande um diagnóstico na correção que ele pede. Outras ferramentas respondem às perguntas que surgem durante a edição: quais Features podem ser anexadas a um componente e a que ele pode se conectar, onde uma nova entrada deve ficar em um arquivo, e uma única edição delimitada aplicada a um documento, com cada byte que ela não toca mantido como estava. Veja Perguntar o que pode ser anexado e o que pode se conectar 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 no cache e grava seu lockfile, e build renderiza a Release em seus artefatos, em memória por padrão ou em dist/ na raiz do workspace quando o assistente pede que ele os grave. Um build recusado devolve os diagnósticos que dizem o que corrigir. Veja Resolver do 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 que outra ferramenta produziu e grava rascunhos de arquivos do Aggrega no workspace para você revisar. Veja Transformar uma descrição externa em rascunhos de entidades e aggrega import para os formatos que ele lê.

Publicar, assinar e retirar

Quatro ferramentas colocam uma entidade ou um artefato em um registry, assinam o que está publicado nele ou o retiram com um marcador assinado. O que elas alteram chega a todos que resolvem a partir desse registry, e nada disso pode ser retirado de quem já o tem, então essas são as ferramentas em que se deve pensar antes de permiti-las. Veja Publicar, assinar e retirar.

Executar qualquer comando

Para um cliente que iniciou o servidor na sua própria máquina, pela entrada e saída padrão, o servidor também oferece uma ferramenta para cada comando que você poderia digitar, com o nome dele: cli-build executa aggrega build, cli-validate executa aggrega validate, e assim por diante. Um servidor acessado por HTTPS não oferece nenhuma delas.

O que ele pode fazer sem perguntar a você

Um assistente conectado pela entrada e saída padrão pode chamar qualquer ferramenta que o servidor oferece sem perguntar a você, a menos que seu cliente esteja configurado para negá-la. É no seu cliente que você permite e nega ferramentas pelo nome. O que um assistente pode fazer sem perguntar a você antes nomeia as operações que vão além do seu workspace, e Restringir o que o servidor anuncia encurta a lista de ferramentas quando seu cliente não aceita a lista inteira.