La pagina in cui si costruisce un arricchimento completo, dall'inizio alla fine: dati di esempio, schema, modelli, risultati. Al centro si trova l'albero dello schema: un editor visuale con riordino tramite drag-and-drop, modifica inline, navigazione da tastiera e modifiche assistite dall'AI.
L'albero dello schema consente di visualizzare e modificare i propri schemi di arricchimento senza scrivere JSON a mano. Le proprietà sono mostrate come albero interattivo raggruppato per dominio di competenza, così da vedere a colpo d'occhio quali campi appartengono a ciascuna area specialistica. Ogni modifica viene registrata in una cronologia di annullamento/ripristino e salvata automaticamente dopo un debounce di 2 secondi.
Proprietà raggruppate per dominio di competenza con sezioni comprimibili. Attiva/disattiva il raggruppamento.
Con la vista Ordinata disattivata, può riordinare le proprietà all'interno dei gruppi o tra gruppi diversi trascinandole — la disposizione viene salvata nello schema. Gli indicatori visivi di destinazione mostrano dove verranno posizionati gli elementi.
Fai clic su una proprietà per modificarne nome, tipo, descrizione ed esempi direttamente nell'albero.
Frecce direzionali per navigare e per comprimere o espandere, Invio per modificare, Canc per eliminare, Ctrl+A per selezionare tutto. Annulla e Ripeti sono pulsanti della barra degli strumenti e la cronologia resta disponibile anche cambiando schema o ricaricando la pagina.
Ricerca testuale per trovare i campi negli schema di grandi dimensioni: prima i nomi delle proprietà, con ripiego su descrizioni ed esempi quando nessun nome corrisponde. Le corrispondenze annidate vengono mostrate con il solo percorso che conduce ad esse.
Cronologia completa per le modifiche manuali. Le modifiche generate dall'IA sostituiscono senza aggiungere voci di annullamento.
Le schede in alto contengono i tipi denominati dello schema. Il pulsante + crea un Object (un'entità nidificata con proprietà proprie) oppure un Enum (un elenco chiuso di valori consentiti a cui puoi puntare qualsiasi proprietà di testo).
La vista DIAGRAMMA, accanto a SCHEMA e JSON, rappresenta lo schema come un diagramma delle entità: le entità denominate come schede con titolo, gli oggetti annidati come schede semplici che prendono il nome dalla loro relazione, con riferimenti (1–1) e collegamenti (1–N) come archi tratteggiati. Segue le modifiche in tempo reale e, facendo clic su una scheda entità, questa si apre nella vista SCHEMA.
Ogni riga dell'editor rappresenta una proprietà dello schema con i suoi attributi chiave visibili a colpo d'occhio:
Le proprietà nidificate (come city in headquarters) sono indentate per mostrare la gerarchia. L'icona della lente d'ingrandimento contrassegna le chiavi di ricerca, ovvero i campi usati per identificare l'entità.
Un set di valori limita una proprietà di testo a un elenco fisso di valori consentiti — uno stato, un voto, un codice di classificazione. L'arricchimento non può quindi restituire nulla al di fuori di quell'elenco, evitando che lo stesso concetto arrivi con tre grafie diverse tra un'esecuzione e l'altra.
Premi + sulle schede dei tipi, scegli Enum e assegnagli un nome. La nuova scheda apre il suo elenco di membri.
Aggiungi, rinomina, riordina o rimuovi i valori. Aggiungi una nota a un membro quando il suo significato non è ovvio dal nome.
Imposta il Tipo di qualsiasi proprietà di testo sul set di valori (o su un suo array) dal gruppo Set di valori nel menu a discesa dei tipi.
Reimposta il Tipo della proprietà su string, oppure elimina il set di valori — le proprietà che lo utilizzano tornano a essere proprietà di testo ordinarie.
Usa un set di valori solo per un vocabolario che puoi elencare completamente. Se un'entità reale necessita di un valore che hai omesso, il modello è costretto a scegliere il valore errato più vicino invece di segnalare il problema — quindi un campo aperto (un nome, una descrizione, una categoria di testo libero) dovrebbe rimanere testo semplice. Per lo stesso motivo la generazione dello schema propone i set di valori in modo prudente, e tutto ciò che propone è modificabile qui.
Fai clic su una riga di proprietà o premi Invio per passare alla modalità di modifica. In modalità di modifica puoi modificare:
L'editor di schema supporta un flusso di lavoro completamente guidato da tastiera per una modifica efficiente:
| Scorciatoia | Azione |
|---|---|
| Arrow Up / Down | Spostarsi tra le proprietà (tenere premuto Maiusc per estendere la selezione) |
| Arrow Left / Right | Comprime o espande l’oggetto selezionato |
| Home / End | Vai alla prima o all'ultima proprietà |
| Enter | Attiva/disattiva la modalità di modifica sulla proprietà selezionata |
| Delete / Backspace | Rimuovi la proprietà selezionata |
| Ctrl+A / Cmd+A | Seleziona tutte le proprietà |
| Escape | Esci dalla modalità di modifica o cancella la selezione |
Per riordinare manualmente occorre disattivare l'interruttore Ordinato. Per impostazione predefinita l'editor elenca le proprietà in ordine alfabetico e lì il trascinamento è disabilitato: un ordine creato a mano che un'impostazione di visualizzazione potrebbe sovrascrivere in silenzio varrebbe ben poco. Deselezionando Ordinato si passa alla disposizione propria dello schema e si abilita il trascinamento; una linea di inserimento mostra esattamente dove verrà collocata la proprietà e l'ordine risultante viene salvato con lo schema. È possibile trascinare all'interno di un gruppo di dominio di competenza o tra gruppi diversi per modificare l'assegnazione del dominio.
Quando il raggruppamento per competenza è abilitato, spostando una proprietà in un gruppo diverso si aggiorna automaticamente la relativa assegnazione di competenza. Questo rende intuitiva la riorganizzazione di schemi di grandi dimensioni — basta trascinare un campo da “Analista finanziario” a “Esperto normativo” e la sua competenza si aggiorna di conseguenza.
Sotto l'albero delle proprietà, il pannello di modifica IA vi consente di modificare lo schema utilizzando il linguaggio naturale. Digitate un'istruzione come “aggiungi un riferimento parent_company” e l'IA applica la modifica preservando la struttura esistente.
Dopo ogni generazione o modifica, l'AI fornisce 5 suggerimenti di miglioramento visualizzati come chip cliccabili. Fare clic su un suggerimento per compilare automaticamente il campo di modifica e applicarlo. I suggerimenti riguardano la completezza dei dati, la qualità, le relazioni, l'internazionalizzazione e i miglioramenti specifici del dominio.
Scopri di più sulla modifica degli schemi con l'IA nella guida Generazione di schemi con l'IA.
Leggere il nome di una proprietà nel contesto del suo oggetto padre: quante cose distinte potrebbe richiedere? Esattamente una è chiara. Con due o più, la proprietà riporta un badge ambigua — ambra quando le letture coincidono in gran parte e differiscono solo nei casi limite, rosso quando produrrebbero dati sostanzialmente diversi. Passare il puntatore sul badge per leggere le interpretazioni concorrenti ammesse dal nome e la descrizione riscritta che ne fissa esattamente una. Viene segnalato anche un nome a cui il padre non ha nulla da rispondere: in quel caso il tooltip elenca le letture considerate e scartate, e la correzione è una ridenominazione o una rimozione — nessuna descrizione può dare a un'entità una proprietà che non possiede.
L'icona a scudo nella barra degli strumenti analizza le proprietà ancora prive di annotazione e passa a una rianalisi completa una volta che tutto è annotato. Ogni esecuzione è una piccola chiamata IA a pagamento.
Su uno schema salvato il badge suggerisce una descrizione riscritta, mai una ridenominazione: lo schema è in produzione, quindi fissare il significato nella descrizione lascia intatto il contratto dati. Una descrizione che si limita a ripetere il nome non aggiunge nulla e la proprietà viene valutata come se ne fosse priva.
Rinominare una proprietà o modificarne la descrizione ne elimina l'annotazione — il verdetto era stato emesso su entrambe. L'editor evidenzia queste proprietà e propone un ricontrollo.
Disattivi il controllo per uno schema dal menu delle opzioni aggiuntive: badge e avvisi scompaiono, e la riattivazione su uno schema mai analizzato esegue automaticamente il controllo.
L'intero funzionamento — i due verdetti, le interpretazioni alla base di ciascuno e il motivo per cui la correzione è una rinomina prima che lo schema esista ma una descrizione una volta che è attivo — è illustrato nella guida Controllo di ambiguità.
Il selettore di schema consente di creare, caricare, fissare, duplicare ed eliminare gli schemi. Gli schemi vengono salvati per organizzazione e sono accessibili a tutti i membri del team.
Le modifiche vengono salvate automaticamente dopo una pausa di 2 secondi, con deduplicazione basata sull'hash del contenuto per evitare scritture non necessarie.
Fissate gli schemi usati di frequente per mantenerli in cima all'elenco del selettore.
Crea una copia di qualsiasi schema per sperimentare modifiche senza intaccare l'originale.
Gli schemi eliminati possono essere ripristinati. L'eliminazione permanente è un'azione separata.