Workflow Editor – Entity Enricher Dokumentation

Workflow-Editor

Die Seite, auf der Sie eine Anreicherung durchgängig aufbauen – Sample-Daten, Schema, Modelle, Ergebnisse. Im Zentrum steht der Schema-Baum: ein visueller Editor mit Drag-and-drop-Sortierung, Inline-Bearbeitung, Tastaturnavigation und KI-gestützten Änderungen.

Übersicht

Im Schema-Baum können Sie Ihre Anreicherungsschemas ansehen und ändern, ohne JSON von Hand zu schreiben. Eigenschaften werden als interaktiver Baum dargestellt, gruppiert nach Fachgebiet, sodass Sie auf einen Blick sehen, welche Felder zu welchem Spezialbereich gehören. Jede Änderung wird mit Undo-/Redo-Verlauf nachverfolgt und nach 2 Sekunden Verzögerung automatisch gespeichert.

Wichtige Fähigkeiten

Expertise-Gruppierung

Eigenschaften nach Fachbereich gruppiert, mit einklappbaren Abschnitten. Gruppierung ein-/ausschalten.

Drag-and-Drop

Bei deaktivierter Ansicht „Sortiert“ ordnen Sie Eigenschaften innerhalb von Gruppen oder gruppenübergreifend per Drag-and-drop neu – die Anordnung wird im Schema gespeichert. Visuelle Markierungen der Ablageposition zeigen, wo die Elemente landen.

Inline-Bearbeitung

Klicken Sie auf eine beliebige Eigenschaft, um Namen, Typ, Beschreibung und Beispiele direkt im Baum zu bearbeiten.

Tastaturnavigation

Pfeiltasten zum Navigieren sowie zum Ein- und Ausklappen, Enter zum Bearbeiten, Entf zum Entfernen, Strg+A zum Auswählen aller Elemente. Rückgängig und Wiederholen sind Schaltflächen in der Symbolleiste, und der Verlauf bleibt beim Wechseln des Schemas oder beim Neuladen der Seite erhalten.

Suchen & Filtern

Textsuche zum Auffinden von Feldern in großen Schemata: zuerst Eigenschaftsnamen, dann als Rückfall Beschreibungen und Beispiele, wenn kein Name passt. Verschachtelte Treffer werden nur mit dem Pfad angezeigt, der zu ihnen führt.

Rückgängig / Wiederherstellen

Vollständiger Verlauf für manuelle Bearbeitungen. KI-generierte Änderungen ersetzen bestehende Werte, ohne Rückgängig-Einträge hinzuzufügen.

Typen & Wertesätze

Die Tabs oben enthalten die benannten Typen des Schemas. Die Schaltfläche + erstellt entweder ein Objekt (eine verschachtelte Entität mit eigenen Eigenschaften) oder ein Enum (eine geschlossene Liste zulässiger Werte, auf die Sie jede Texteigenschaft verweisen können).

Diagrammansicht

Die Ansicht DIAGRAMM neben SCHEMA und JSON stellt das Schema als Entitätsdiagramm dar — benannte Entitäten als Karten mit Titel, verschachtelte Objekte als einfache Karten, die nach ihrer Beziehung benannt sind, mit Referenzen (1–1) und Verknüpfungen (1–N) als gestrichelte Kanten. Sie folgt Ihren Änderungen live, und ein Klick auf eine Entitätskarte öffnet diese in der Ansicht SCHEMA.

Der Property-Baum

Jede Zeile im Editor stellt eine Schema-Eigenschaft dar, deren wichtigste Attribute auf einen Blick sichtbar sind:

AuswEigenschaftsnameTypBeschreibung
□company_name
🔍
stringRechtlicher Firmenname
□revenuenumberJahresumsatz in USD
□headquartersobjectUnternehmenszentrale
□ citystringName der Gemeinde
□ country
🔍
stringLand, in dem sich der Hauptsitz befindet
□gmp_statusbooleanGMP-Zertifizierungsstatus

Verschachtelte Eigenschaften (wie city unter headquarters) sind eingerückt, um die Hierarchie darzustellen. Das Lupensymbol markiert Suchschlüssel – Felder, die zur Identifizierung der Entity verwendet werden.

Wertelisten (Enums)

Ein Wertesatz beschränkt eine Texteigenschaft auf eine feste Liste zulässiger Werte – einen Status, eine Bewertung, einen Klassifizierungscode. Die Anreicherung kann dann nichts außerhalb dieser Liste zurückgeben, wodurch verhindert wird, dass dasselbe Konzept über mehrere Durchläufe hinweg in drei verschiedenen Schreibweisen ankommt.

Arbeiten mit Wertelisten

Einen erstellen

Klicken Sie auf + bei den Typ-Tabs, wählen Sie Enum und benennen Sie es. Der neue Tab öffnet dessen Elementliste.

Elemente bearbeiten

Werte hinzufügen, umbenennen, neu anordnen oder entfernen. Versehen Sie ein Element mit einer Notiz, wenn seine Bedeutung nicht aus dem Namen hervorgeht.

Verwenden

Setzen Sie den Typ einer beliebigen Texteigenschaft auf den Wertesatz (oder auf ein Array davon) aus der Gruppe „Wertesätze“ im Typ-Dropdown.

Rückgängig machen

Setzen Sie den Typ der Eigenschaft zurück auf String oder löschen Sie den Wertesatz – Eigenschaften, die ihn verwenden, werden wieder zu gewöhnlichen Texteigenschaften.

Verwenden Sie einen Wertesatz nur für ein Vokabular, das Sie vollständig auflisten können. Wenn eine reale Entität einen Wert benötigt, den Sie ausgelassen haben, muss das Modell den am nächsten liegenden falschen Wert wählen, anstatt das Problem zu melden – daher sollte ein offenes Feld (ein Name, eine Beschreibung, eine Freitext-Kategorie) einfacher Text bleiben. Die Schema-Generierung schlägt Wertesätze aus demselben Grund zurückhaltend vor, und alles, was sie vorschlägt, ist hier bearbeitbar.

Eigenschaften bearbeiten

Klicken Sie auf eine Eigenschaftszeile oder drücken Sie die Eingabetaste, um in den Bearbeitungsmodus zu wechseln. Im Bearbeitungsmodus können Sie Folgendes ändern:

NameDer Property-Schlüssel in der JSON-Ausgabe. Verwenden Sie snake_case für Konsistenz.
TypWählen Sie aus string, number, integer, boolean, array oder object. Das Ändern des Typs aktualisiert das Ausgabeformat der Anreicherung.
BeschreibungKontextbezogene Beschreibung, die die KI während der Anreicherung leitet. Mehr Details führen zu besseren Ergebnissen.
BeispieleZwei oder drei realistische Beispielwerte. Diese helfen der KI, das erwartete Format und den erwarteten Inhalt zu verstehen.
ExpertiseWelcher Fachexperte diesen Wert liefert. Bestimmt die Gruppierung bei der Anreicherung mit mehreren Fachdomänen.
NullableOb einer realen Instanz dieser Wert tatsächlich fehlen kann. Nicht-nullbare Felder sind für die Aufnahme in die Datenbank erforderlich – eine Anreicherung, die sie nicht füllen kann, wird vom Quality-Gate abgelehnt. Nicht verfügbar bei einem Datenbankschlüssel (ein Null-Wert identifiziert keine Zeile) und bei einem beibehaltenen Feld (Ihre Eingabe liefert ihn immer).
MehrsprachigOb das Feld in mehreren Sprachen angereichert werden soll.
BeibehaltenOb der ursprüngliche Eingabewert unverändert bleiben soll. Für Werte, die Ihr eigenes System besitzt – eine Datenbank-ID, eine interne SKU, eine Kundenreferenz – nicht für öffentliche Bezeichner (CAS, ISBN, EAN, ein Ticker-Symbol), die die Anreicherung für Sie nachschlagen kann. Jede Anreicherung muss dann einen Wert dafür liefern.

Tastenkombinationen

Der Schema-Editor unterstützt einen vollständig tastaturgesteuerten Workflow für effizientes Bearbeiten:

TastenkürzelAktion
Arrow Up / DownZwischen Eigenschaften navigieren (Shift gedrückt halten, um die Auswahl zu erweitern)
Arrow Left / RightDas ausgewählte Objekt ein- oder ausklappen
Home / EndZur ersten oder letzten Eigenschaft springen
EnterBearbeitungsmodus für ausgewählte Eigenschaft umschalten
Delete / BackspaceAusgewählte Eigenschaft entfernen
Ctrl+A / Cmd+AAlle Eigenschaften auswählen
EscapeBearbeitungsmodus verlassen oder Auswahl aufheben

Neuanordnung per Drag-and-Drop

Zum manuellen Umsortieren müssen Sie den Schalter Sortiert ausschalten. Der Editor listet Eigenschaften standardmäßig alphabetisch auf, und Ziehen ist dort deaktiviert – eine von Hand erstellte Reihenfolge, die eine Ansichtseinstellung stillschweigend überschreiben könnte, wäre wenig wert. Deaktivieren Sie „Sortiert“, wechselt die Ansicht zur eigenen Anordnung des Schemas und Ziehen wird möglich; eine visuelle Einfügelinie zeigt genau, wo die Eigenschaft landet, und die resultierende Reihenfolge wird mit dem Schema gespeichert. Sie können innerhalb einer Fachbereichsgruppe oder gruppenübergreifend ziehen, um die Zuordnung zum Fachbereich zu ändern.

Wenn die Expertise-Gruppierung aktiviert ist, aktualisiert das Ablegen einer Eigenschaft in einer anderen Gruppe automatisch ihre Expertise-Zuordnung. Das macht die Neuorganisation großer Schemas intuitiv – ziehen Sie ein Feld einfach von „Financial Analyst“ zu „Regulatory Expert“, und seine Expertise wird entsprechend aktualisiert.

KI-Bearbeitungsbereich

Unterhalb des Eigenschaftsbaums können Sie im KI-Bearbeitungsbereich das Schema mit natürlicher Sprache anpassen. Geben Sie eine Anweisung wie „eine parent_company-Referenz hinzufügen“ ein, und die KI wendet die Änderung an, während Ihre bestehende Struktur erhalten bleibt.

KI-Vorschläge

Nach jeder Generierung oder Bearbeitung liefert die KI 5 Verbesserungsvorschläge, die als anklickbare Chips angezeigt werden. Klicken Sie auf einen Vorschlag, um das Bearbeitungsfeld automatisch auszufüllen und ihn anzuwenden. Die Vorschläge umfassen Datenvollständigkeit, Qualität, Beziehungen, Internationalisierung und domänenspezifische Erweiterungen.

Erfahren Sie mehr über die KI-gestützte Schema-Bearbeitung im Leitfaden KI-Schema-Generierung.

Mehrdeutigkeits-Badges

Lesen Sie den Namen einer Eigenschaft im Kontext ihres übergeordneten Objekts: Nach wie vielen verschiedenen Dingen könnte er fragen? Genau eines ist eindeutig. Bei zwei oder mehr erhält die Eigenschaft ein Badge mehrdeutig – bernsteinfarben, wenn sich die Lesarten weitgehend überschneiden und nur Randfälle abweichen, rot, wenn sie zu deutlich unterschiedlichen Daten führen würden. Fahren Sie über das Badge, um die konkurrierenden Interpretationen zu lesen, die der Name zulässt, sowie die neu formulierte Beschreibung, die genau eine davon festlegt. Ein Name, auf den das übergeordnete Objekt nichts zu antworten hat, wird ebenfalls markiert: Dort listet der Tooltip die geprüften und verworfenen Lesarten auf, und die Korrektur besteht in einer Umbenennung oder einer Entfernung – keine Beschreibung kann einer Entität eine Eigenschaft geben, die sie nicht besitzt.

Schaltfläche „Erneut prüfen“

Das Schild-Symbol in der Symbolleiste analysiert Eigenschaften, die noch keine Annotation haben, und wechselt zu einer vollständigen Neuanalyse, sobald alles annotiert ist. Jeder Lauf ist ein kleiner abgerechneter KI-Aufruf.

Hier ist die Lösung eine Beschreibung

Bei einem gespeicherten Schema schlägt das Badge eine neu formulierte Beschreibung vor, nie eine Umbenennung: Das Schema ist live, daher lässt das Festlegen der Bedeutung in der Beschreibung den Datenvertrag unangetastet. Eine Beschreibung, die nur den Namen wiederholt, bringt nichts – die Eigenschaft wird dann bewertet, als hätte sie gar keine.

Veraltete Annotationen

Das Umbenennen einer Eigenschaft oder das Bearbeiten ihrer Beschreibung verwirft ihre Annotation – das Urteil beruhte auf beidem. Der Editor hebt diese Eigenschaften hervor und bietet eine erneute Prüfung an.

Umschalter pro Schema

Deaktivieren Sie die Prüfung für ein Schema über das Überlaufmenü – Badges und Warnungen verschwinden, und das erneute Aktivieren bei einem nie analysierten Schema führt die Prüfung automatisch aus.

Die vollständige Funktionsweise – die beiden Urteile, die Interpretationen dahinter und warum die Lösung vor dem Anlegen des Schemas eine Umbenennung ist, sobald es aktiv ist jedoch eine Beschreibung – beschreibt der Leitfaden Mehrdeutigkeitsprüfung.

Schemaverwaltung

Mit der Schema-Auswahl können Sie Schemas erstellen, laden, anheften, duplizieren und löschen. Schemas werden pro Organisation gespeichert und sind für alle Teammitglieder zugänglich.

Automatisches Speichern

Änderungen werden nach einer Pause von 2 Sekunden automatisch gespeichert, mit Content-Hash-Deduplizierung, um unnötige Schreibvorgänge zu vermeiden.

Schemas anheften

Heften Sie häufig verwendete Schemas an, um sie oben in der Auswahlliste zu halten.

Duplizieren

Erstellen Sie eine Kopie eines beliebigen Schemas, um Änderungen auszuprobieren, ohne das Original zu beeinträchtigen.

Soft Delete

Gelöschte Schemas können wiederhergestellt werden. Das endgültige Löschen ist eine separate Aktion.

Nächste Schritte