Cosa può fare il tuo assistente con Aggrega
Una volta che il tuo assistente è collegato al server MCP di Aggrega, lavora con lo stesso binario aggrega che eseguiresti in un terminale: legge gli schemi e la documentazione, prepara e verifica i tuoi file, esegue la build di una Release e, quando glielo consenti, pubblica. Questa pagina dice cosa copre, per gruppi. L’elenco completo è la risposta del server stesso, ed è quella di cui fidarsi: chiama describe-capabilities senza argomenti, o chiedi al tuo assistente di farlo, e il server elenca ogni strumento che ti offre, ciascuno con il suo scopo in una riga, i tipi di entità che serve e se scrive. Compatibilità indica che cosa una release può cambiare negli strumenti.
Leggere gli schemi e la documentazione
Il server fornisce materiale di riferimento che un assistente legge prima di scrivere YAML: il JSON Schema di un’entità (schema://<kind>), qualsiasi pagina del riferimento del linguaggio (langref://<path>), la guida alla scrittura (authoring://<topic>), lo YAML scritto di un’entità del catalogo (catalog://<kind>/<name>) e l’help di qualsiasi comando (cli://<command>). Gli schemi sono integrati nel binario, e le pagine provengono da una copia della documentazione che il server conserva nella cache della tua macchina. Cosa fa elenca ogni famiglia.
Assumere un ruolo o seguire un flusso di lavoro
I prompt di scrittura inquadrano l’assistente come sviluppatore, architetto o autore operations, oppure lo concentrano su un solo tipo di entità, così che i suoi suggerimenti restino entro ciò che quel ruolo scrive. I prompt di flusso di lavoro stabiliscono l’ordine delle chiamate per un obiettivo che ne richiede diverse: comporre un nuovo Aggregate e la sua Release, portare in Aggrega un chart, un modulo di infrastruttura o un file Compose esistente, oppure capire perché una build fallisce. Il tuo client li elenca come prompt del server.
Scoprire cosa contiene un workspace
list-entities e list-releases dicono cosa contiene il tuo workspace e in che quantità, poi restituiscono i record una pagina alla volta; describe mostra una singola entità o tutto ciò che una Release raggiunge; config-show riporta la configurazione in vigore e da dove proviene ogni impostazione. Il server riporta anche le cache, i registry configurati e i plugin che risolve. Vedi Scoprire cosa contiene un workspace.
Preparare e verificare i tuoi file
scaffold prepara un documento iniziale per un tipo di entità, con i campi che il tipo richiede, oppure scrive uno degli esempi eseguibili della documentazione in una nuova directory. get-schema restituisce il JSON Schema di un tipo, validate verifica una bozza e nomina ogni segnaposto ancora presente, lint verifica le convenzioni di pubblicazione del catalogo, ed explain-error espande una diagnostica nella correzione che richiede. Altri strumenti rispondono alle domande che sorgono durante la modifica: quali Features possono essere associate a un componente e a cosa questo può connettersi, dove va una nuova voce in un file, e una singola modifica circoscritta applicata a un documento, mantenendo invariato ogni byte che non tocca. Vedi Chiedere cosa può essere associato e cosa può connettersi a cosa e Applicare una singola modifica circoscritta a un documento.
Risolvere ed eseguire la build di una Release
pull risolve le dipendenze di una Release nella cache e ne scrive il lockfile, e build esegue il rendering della Release nei suoi artefatti, in memoria per impostazione predefinita oppure in dist/ alla radice del workspace quando l’assistente gli chiede di scriverli. Una build rifiutata restituisce le diagnostiche che dicono cosa correggere. Vedi Risolvere ciò da cui dipende una Release e Eseguire la build sul contenuto che una Release fissa già.
Importare un progetto da un altro strumento
import legge una descrizione prodotta da un altro strumento e scrive bozze di file Aggrega nel workspace, perché tu le esamini. Vedi Trasformare una descrizione esterna in bozze di entità e aggrega import per i formati che legge.
Pubblicare, firmare e ritirare
Quattro strumenti inseriscono un’entità o un artefatto in un registry, firmano ciò che vi è pubblicato o lo ritirano con un marcatore firmato. Ciò che modificano raggiunge chiunque risolva da quel registry, e nulla di tutto ciò può essere ripreso da chi lo ha già, quindi sono questi gli strumenti su cui riflettere prima di consentirli. Vedi Pubblicare, firmare e ritirare.
Eseguire qualsiasi comando
Per un client che ha avviato il server sulla tua macchina, tramite standard input e output, il server offre anche uno strumento per ogni comando che potresti digitare, che porta il suo nome: cli-build esegue aggrega build, cli-validate esegue aggrega validate, e così via. Un server raggiunto via HTTPS non ne offre nessuno.
Cosa può fare senza chiedertelo
Un assistente collegato tramite standard input e output può chiamare ogni strumento che il server offre senza chiedertelo, a meno che il tuo client non sia impostato per negarlo. È nel tuo client che consenti e neghi gli strumenti per nome. Cosa può fare un assistente senza chiedertelo prima nomina le operazioni che vanno oltre il tuo workspace, e Restringere ciò che il server annuncia accorcia l’elenco degli strumenti dove il tuo client non lo accetta per intero.