Workflow Editor - Entity Enricher-documentatie

Workfloweditor

De pagina waar je één enrichment van begin tot eind opbouwt — sampledata, schema, modellen, resultaten. In het midden staat de schemaboom: een visuele editor met slepen-en-neerzetten om te herordenen, inline bewerken, toetsenbordnavigatie en AI-ondersteunde aanpassingen.

Overzicht

In de schemaboom bekijk en bewerk je je verrijkingsschema's zonder zelf JSON te schrijven. Eigenschappen worden getoond als een interactieve boom, gegroepeerd per expertisedomein, zodat je in één oogopslag ziet welke velden bij welk vakgebied horen. Elke wijziging wordt bijgehouden met een ongedaan maken/opnieuw-geschiedenis en na 2 seconden debounce automatisch opgeslagen.

Belangrijkste mogelijkheden

Expertisegroepering

Eigenschappen gegroepeerd op expertisedomein met inklapbare secties. Groepering aan/uit zetten.

Slepen en neerzetten

Als de weergave Gesorteerd uit staat, kun je eigenschappen binnen of tussen groepen herschikken door te slepen — de indeling wordt op het schema opgeslagen. Visuele indicatoren voor het doelgebied laten zien waar items terechtkomen.

Inline bewerken

Klik op een eigenschap om de naam, het type, de beschrijving en de voorbeelden rechtstreeks in de boom te bewerken.

Toetsenbordnavigatie

Pijltjestoetsen om te navigeren en in of uit te klappen, Enter om te bewerken, Delete om te verwijderen, Ctrl+A om alles te selecteren. Ongedaan maken en opnieuw uitvoeren zijn knoppen in de werkbalk, en de geschiedenis blijft behouden als je van schema wisselt of de pagina herlaadt.

Zoeken en filteren

Tekst zoeken om velden in grote schema's te vinden: eerst eigenschapsnamen, met terugval op beschrijvingen en voorbeelden wanneer geen naam overeenkomt. Geneste treffers worden getoond met alleen het pad dat ernaartoe leidt.

Ongedaan maken / Opnieuw

Volledige geschiedenis voor handmatige bewerkingen. AI-gegenereerde wijzigingen vervangen zonder ongedaan-maken-vermeldingen toe te voegen.

Types en waardensets

De tabbladen bovenaan bevatten de benoemde types van het schema. De +-knop maakt een Object (een geneste entiteit met eigen eigenschappen) of een Enum (een gesloten lijst met toegestane waarden waarnaar je elke teksteigenschap kunt laten verwijzen).

Diagramweergave

De DIAGRAM-weergave naast SCHEMA en JSON tekent het schema als een entiteitsdiagram — benoemde entiteiten als kaarten met titel, geneste objecten als gewone kaarten met de naam van hun relatie, en referenties (1–1) en koppelingen (1–N) als stippellijnen. De weergave volgt je bewerkingen live, en als je op een entiteitskaart klikt, wordt die geopend in de SCHEMA-weergave.

De eigenschappenboom

Elke rij in de editor vertegenwoordigt een schema-eigenschap met de belangrijkste kenmerken in één oogopslag zichtbaar:

SelNaam van eigenschapTypeBeschrijving
□company_name
🔍
stringJuridische bedrijfsnaam
□revenuenumberJaaromzet in USD
□headquartersobjectHoofdkantoor
□ citystringNaam van de gemeente
□ country
🔍
stringLand waar het hoofdkantoor is gevestigd
□gmp_statusbooleanStatus GMP-certificering

Geneste eigenschappen (zoals city onder headquarters) worden ingesprongen om de hiërarchie te tonen. Het vergrootglaspictogram markeert zoeksleutels — velden die worden gebruikt om de entity te identificeren.

Waardesets (enums)

Een waardenset beperkt een teksteigenschap tot een vaste lijst met toegestane waarden — een status, een beoordeling, een classificatiecode. Verrijking kan dan niets teruggeven dat buiten die lijst valt, waardoor hetzelfde concept niet in drie verschillende spellingen over runs heen binnenkomt.

Werken met waardesets

Maak er een

Druk op + op de type-tabbladen, kies Enum en geef het een naam. Het nieuwe tabblad opent zijn ledenlijst.

Leden bewerken

Voeg waarden toe, hernoem, herorden of verwijder ze. Geef een lid een notitie wanneer de betekenis niet duidelijk is uit de naam.

Gebruik het

Stel het Type van een teksteigenschap in op de waardenset (of op een array daarvan) via de groep Waardensets in het typemenu.

Maak ongedaan

Zet het Type van de eigenschap terug naar string, of verwijder de waardenset — eigenschappen die het gebruiken worden weer gewone teksteigenschappen.

Gebruik een waardenset alleen voor een vocabulaire dat je volledig kunt opsommen. Als een echte entiteit een waarde nodig heeft die je hebt weggelaten, wordt het model gedwongen de dichtstbijzijnde verkeerde te kiezen in plaats van het probleem te melden — dus een open veld (een naam, een beschrijving, een vrije-tekstcategorie) kan beter gewone tekst blijven. Schemageneratie stelt om dezelfde reden waardensets voorzichtig voor, en alles wat het voorstelt is hier te bewerken.

Eigenschappen bewerken

Klik op een eigenschapsrij of druk op Enter om naar de bewerkmodus te schakelen. In de bewerkmodus kun je het volgende wijzigen:

NaamDe eigenschapssleutel in de JSON-uitvoer. Gebruik snake_case voor consistentie.
TypeKies uit string, number, integer, boolean, array of object. Het wijzigen van het type werkt de uitvoerindeling van de enrichment bij.
BeschrijvingContextuele beschrijving die de AI begeleidt tijdens de enrichment. Meer detail leidt tot betere resultaten.
VoorbeeldenTwee of drie realistische voorbeeldwaarden. Deze helpen de AI het verwachte formaat en de inhoud te begrijpen.
ExpertiseWelke domeinexpert deze waarde levert. Bepaalt de groepering bij verrijking met meerdere expertisedomeinen.
NullableOf een echte instantie deze waarde daadwerkelijk kan missen. Niet-nullable velden zijn vereist voor toelating tot de database — een verrijking die ze niet kan invullen wordt door de kwaliteitscontrole afgewezen. Niet beschikbaar voor een database key (een null-waarde identificeert geen enkele rij) en voor een bewaard veld (je invoer levert deze altijd).
MeertaligOf het veld in meerdere talen moet worden verrijkt.
BehoudenOf de oorspronkelijke invoerwaarde ongewijzigd moet blijven. Voor waarden die je eigen systeem beheert — een database-id, een interne SKU, een klantreferentie — niet voor openbare identificatoren (CAS, ISBN, EAN, een ticker) die de enrichment voor je kan opzoeken. Elke enrichment moet er dan een waarde voor opgeven.

Sneltoetsen

De schema-editor ondersteunt een volledig toetsenbordgestuurde workflow voor efficiënt bewerken:

SneltoetsActie
Arrow Up / DownNavigeer tussen eigenschappen (houd Shift ingedrukt om de selectie uit te breiden)
Arrow Left / RightHet geselecteerde object in- of uitklappen
Home / EndSpring naar de eerste of laatste eigenschap
EnterBewerkmodus in-/uitschakelen voor geselecteerde eigenschap
Delete / BackspaceGeselecteerde eigenschap verwijderen
Ctrl+A / Cmd+AAlle eigenschappen selecteren
EscapeBewerkmodus verlaten of selectie wissen

Herordenen door slepen en neerzetten

Handmatig herordenen vereist dat je de schakelaar Gesorteerd uitzet. De editor toont eigenschappen standaard alfabetisch en slepen is daar uitgeschakeld — een handmatige volgorde die een weergave-instelling stilzwijgend kan overschrijven, is weinig waard. Zet je Gesorteerd uit, dan schakelt de editor over op de eigen volgorde van het schema en wordt slepen mogelijk; een visuele invoeglijn laat precies zien waar de eigenschap terechtkomt, en de resulterende volgorde wordt met het schema opgeslagen. Je kunt binnen een expertisegroep slepen of tussen groepen om de domeintoewijzing te wijzigen.

Wanneer expertisegroepering is ingeschakeld, werkt het slepen van een eigenschap naar een andere groep automatisch de expertisetoewijzing ervan bij. Dit maakt het herorganiseren van grote schema's intuïtief — sleep gewoon een veld van “Financieel analist” naar “Regelgevingsexpert” en de expertise wordt navenant bijgewerkt.

AI-bewerkingspaneel

Onder de eigenschappenboom kun je met het AI-bewerkingspaneel het schema aanpassen met natuurlijke taal. Typ een instructie zoals “voeg een parent_company-referentie toe” en de AI past de wijziging toe met behoud van je bestaande structuur.

AI-suggesties

Na elke generatie of bewerking biedt de AI 5 verbetersuggesties die worden getoond als klikbare chips. Klik op een suggestie om het bewerkingsveld automatisch in te vullen en toe te passen. Suggesties hebben betrekking op datavolledigheid, kwaliteit, relaties, internationalisatie en domeinspecifieke verbeteringen.

Lees meer over AI-schemabewerking in de gids AI-schemageneratie.

Ambiguïteitsbadges

Lees de naam van een eigenschap in de context van het bovenliggende object: hoeveel verschillende dingen zou ze kunnen vragen? Precies één is duidelijk. Bij twee of meer krijgt de eigenschap een badge ambigu — amber wanneer de lezingen elkaar grotendeels overlappen en alleen randgevallen verschillen, rood wanneer ze wezenlijk andere data zouden opleveren. Beweeg over de badge om de concurrerende interpretaties te lezen die de naam toelaat, en de herschreven beschrijving die er precies één van vastlegt. Een naam waarop de ouder niets te antwoorden heeft, wordt ook gemarkeerd: daar somt de tooltip de lezingen op die zijn overwogen en verworpen, en is de oplossing een hernoeming of een verwijdering — geen enkele beschrijving kan een entiteit een eigenschap geven die ze niet heeft.

Knop Opnieuw controleren

Het schildpictogram in de werkbalk analyseert eigenschappen die nog geen annotatie hebben, en schakelt over op een volledige heranalyse zodra alles is geannoteerd. Elke run is een kleine, in rekening gebrachte AI-aanroep.

Hier is de oplossing een beschrijving

Bij een opgeslagen schema stelt de badge een herschreven beschrijving voor, nooit een hernoeming: het schema is live, dus de betekenis vastleggen in de beschrijving laat het datacontract intact. Een beschrijving die alleen de naam herhaalt, voegt niets toe; de eigenschap wordt dan beoordeeld alsof ze er geen heeft.

Verouderde annotaties

Een eigenschap hernoemen of de beschrijving ervan bewerken verwijdert de annotatie — het oordeel was op beide gebaseerd. De editor markeert deze eigenschappen en biedt een hercontrole aan.

Schakelaar per schema

Schakel de controle voor een schema uit via het overloopmenu — badges en waarschuwingen verdwijnen, en opnieuw inschakelen bij een nooit-geanalyseerd schema voert de controle automatisch uit.

De volledige werking — de twee uitkomsten, de interpretaties erachter en waarom de oplossing een hernoeming is vóórdat het schema bestaat, maar een beschrijving zodra het actief is — vind je in de handleiding Ambiguïteitscontrole.

Schemabeheer

Met de schemaselector kun je schema's aanmaken, laden, vastzetten, dupliceren en verwijderen. Schema's worden per organisatie opgeslagen en zijn toegankelijk voor alle teamleden.

Automatisch opslaan

Wijzigingen worden automatisch opgeslagen na een pauze van 2 seconden, met content-hash-deduplicatie om onnodige schrijfacties te voorkomen.

Schema's vastmaken

Maak veelgebruikte schema's vast om ze bovenaan de selectielijst te houden.

Dupliceren

Maak een kopie van een schema om met wijzigingen te experimenteren zonder het origineel te beïnvloeden.

Soft delete

Verwijderde schema's kunnen worden hersteld. Permanent verwijderen is een aparte actie.

Volgende stappen