Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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.