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

aggrega get-schema

Stampa lo JSON Schema di un tipo di entità o di contratto

Sinossi

aggrega get-schema [kind] [flags]

Descrizione

Print the canonical JSON Schema for an embedded kind.
The kind is the lowercase-hyphenated schema name — for example component, aggregate, ir, or template-context. Entity kinds, the intermediate-representation and wire-format contracts, and the wasm-* plugin socket contracts are all addressable. The emitted bytes are identical to the distributed schema file.
Use --list to enumerate every available kind, one per line.

Flag

FlagPredefinitoDescrizione
--listfalseElenca ogni tipo di schema, uno per riga.

Cosa fa

aggrega get-schema <kind> stampa sullo standard output il JSON Schema canonico di un tipo di entità o di contratto. Lo schema è il contratto strutturale di riferimento: i campi obbligatori, i valori ammessi e l’annidamento che il compilatore accetta per quel tipo. Viene servito dagli schemi integrati nel binario, quindi l’output corrisponde sempre alla versione di aggrega che stai eseguendo.

aggrega get-schema --list stampa il nome di ogni tipo che puoi richiedere, uno per riga — i tipi di entità che un autore scrive (aggregate, component, feature, recipe, featurerecipe, manifest, release, plugin, schemalibrary, mappinglibrary, workloadlibrary, artifactlibrary, workload) insieme agli schemi di contratto interni che il compilatore usa. Eseguilo per primo quando non sei sicuro del token esatto da passare.

Quando usarlo

Ricorri a get-schema quando ti serve la forma esatta di un tipo durante l’authoring — quali campi sono obbligatori, cosa può essere un valore, come si annida un blocco. È il riferimento con cui verificare un file scritto a mano, e il punto di partenza per imparare un tipo che non conosci. Poiché stampa JSON Schema leggibile da una macchina, puoi anche passarlo a un editor che supporta gli schemi o a uno strumento di validazione.

Un assistente AI connesso tramite aggrega mcp legge gli stessi byte dalla risorsa schema://<kind>, quindi lo schema su cui scrive un assistente e lo schema che recuperi da riga di comando sono identici. Questa pagina documenta il comando; non riproduce il contenuto di alcuno schema — esegui il comando, oppure apri la pagina corrispondente del riferimento delle entità per la spiegazione campo per campo di cosa significa ciascun campo.

Esempi

Stampa lo schema di un Component:

Terminal window
aggrega get-schema component

Elenca ogni tipo che puoi richiedere:

Terminal window
aggrega get-schema --list

Recupera uno schema e ispeziona un singolo campo con uno strumento JSON:

Terminal window
aggrega get-schema recipe | jq '.properties.spec'

Per il ciclo di authoring che questo comando alimenta — impara la forma, crea lo scheletro, compila, valida — vedi Scrivere file Aggrega.