Kelaria Docs

Farbschema

Ontologie-Editor (Liste) ​

Im Ontologie-Editor legen Sie fest, welche Konzepte (Entity-Typen) und welche Beziehungen (Relation-Typen) in Ihrem Projekt existieren. Das Ergebnis ist das Fundament, auf dem die KI-Agenten später Ihr Fachwissen aus Dokumenten strukturiert extrahieren.

Rollen und Berechtigungen

Bearbeiten dürfen Tenant-Admin, Curator und Expert. Reader sehen die Ontologie schreibgeschützt — alle Felder sind ausgegraut, Buttons zum Hinzufügen oder Löschen sind nicht sichtbar.

1. Editor öffnen ​

  1. Wählen Sie Ihr Projekt über den Projekt-Umschalter im Header.
  2. Klicken Sie in der linken Sidebar auf Ontologie.

Hat das Projekt noch keine Ontologie, erscheint der Button ✦ Ontologie generieren lassen. Damit starten Sie den KI-gestützten Bootstrap-Dialog (nur für Writer verfügbar; Reader sehen den Button ausgegraut).

2. Aufbau der Oberfläche ​

Der Editor zeigt in der Listenansicht drei Spalten nebeneinander:

SpalteInhalt
Entity-TypenListe aller Objekt-Klassen (z. B. GeraeteModell, Bauteil)
Relation-TypenListe aller Beziehungstypen (z. B. hat_komponente)
DetailFormular für den gerade ausgewählten Typ

Klicken Sie einen Eintrag an — das Detail-Panel rechts zeigt sofort seine Eigenschaften.

Ansicht wechseln

Oben links schalten die Buttons Liste und Graph zwischen der Spaltenansicht und der interaktiven Graphansicht um. Beide Ansichten teilen denselben Bearbeitungszustand und dasselbe Detail-Panel.

3. Entity-Typ bearbeiten ​

Wählen Sie einen Eintrag in der Spalte Entity-Typen. Im Detail-Panel stehen folgende Felder:

  • Name (PascalCase) — Pflichtfeld. Erstes Zeichen groß, keine Leerzeichen (z. B. GeraeteModell). Ein Tooltip erklärt das Format.
  • Beschreibung — Freitext, der den Typ für das Team verständlich macht.
  • Synonyme (kommagetrennt) — alternative Bezeichnungen, die die KI beim Lesen von Dokumenten berücksichtigt (z. B. Heizgerät, Therme).
  • Attribute — Eigenschaften dieses Typs; siehe Abschnitt 5.
  • Erbt von (Parent-Type, optional) — wählen Sie aus dem Dropdown einen anderen Entity-Typ als übergeordnete Klasse.

4. Relation-Typ bearbeiten ​

Wählen Sie einen Eintrag in der Spalte Relation-Typen:

  • Name (snake_case) — Pflichtfeld. Nur Kleinbuchstaben und Unterstriche, kein Leerzeichen (z. B. hat_komponente). Ein Tooltip erklärt das Format.
  • Beschreibung — Freitext.
  • Synonyme (kommagetrennt) — alternative Bezeichnungen.
  • Von / Nach — Quell- und Ziel-Entity-Typ der Beziehung (jeweils ein Dropdown mit allen vorhandenen Entity-Typen).
  • Kardinalität — 1 : 1, 1 : n, n : 1 oder n : m.

5. Attribute verwalten ​

Jeder Entity-Typ kann beliebig viele Attribute tragen. Pro Attribut legen Sie fest:

FeldBedeutung
NameBezeichnung des Attributs
TypDatentyp: string, integer, float, boolean, date, datetime, enum oder reference
EinheitOptional, z. B. °C oder kW
ListeHaken setzen, wenn das Attribut mehrere Werte aufnehmen kann

Für die Sondertypen erscheint ein zusätzliches Eingabefeld:

  • enum — Geben Sie die erlaubten Werte kommagetrennt ein (z. B. aktiv, inaktiv, defekt). Mindestens ein Wert ist Pflicht; fehlt er, blockiert die Validierung das Speichern.
  • reference — Wählen Sie im Dropdown den Ziel-Entity-Typ, auf den dieses Attribut verweist. Der Ziel-Typ muss in der Ontologie vorhanden sein.

Neues Attribut anlegen: Plus-Symbol neben der Überschrift Attribute.

Attribut entfernen: Papierkorb-Symbol in der jeweiligen Zeile.

6. Typen hinzufügen und löschen ​

Entity-Typ hinzufügen: Button + Entity oben rechts in der Entity-Spalte. Der neue, noch unbenannte Typ erscheint sofort in der Liste und wird im Detail-Panel geöffnet.

Relation-Typ hinzufügen: Button + Relation in der Relation-Spalte. Der Button ist deaktiviert, solange noch keine Entity-Typen vorhanden sind.

Typ löschen: Im Detail-Panel ganz unten — roter Button Entity-Typ löschen bzw. Relation-Typ löschen. Wird ein Entity-Typ gelöscht, entfernt der Editor automatisch alle Relation-Typen, die auf diesen Typ verweisen.

Löschen vor dem Speichern

Gelöschte Typen werden erst beim nächsten Speichern dauerhaft entfernt. Laden Sie die Seite neu, um alle ungespeicherten Änderungen zu verwerfen und zum letzten gespeicherten Stand zurückzukehren.

7. Änderungen prüfen und speichern ​

Sobald Sie etwas geändert haben, zeigt die Fußzeile (Änderungen ungespeichert). Der Speichern-Button ist aktiv.

  1. Optional: Klicken Sie auf Änderungen ansehen, um vor dem Speichern eine Übersicht der hinzugefügten, geänderten und entfernten Typen zu sehen.
  2. Klicken Sie auf Speichern als V_n_ (z. B. Speichern als V4).

Jede Speicherung legt eine neue, nummerierte Version an — ältere Stände bleiben erhalten.

Schlägt die Prüfung vor dem Speichern fehl, erscheint eine verständliche Fehlermeldung, zum Beispiel:

  • Mindestens ein Entity-Typ hat keinen Namen.
  • Enum-Attribut „status" in Entity „Anlage" braucht mindestens einen Wert.
  • Relation-Typ „hat_komponente" muss snake_case sein.
  • Jemand anderes hat in der Zwischenzeit V5 gespeichert. Bitte neu laden und Edits wiederholen.

Bei einem Konflikt durch gleichzeitiges Bearbeiten erscheint zusätzlich der Button Erneut versuchen.

8. Versionen und Export ​

Versionen: Der Button Versionen (Uhr-Symbol, oben rechts) öffnet ein Dropdown mit der gesamten Versions-Historie — Versionsnummer, Quelle und optionales Label. Die aktive Version ist mit (aktiv) gekennzeichnet.

Versionen wiederherstellen

Nur Tenant-Admins sehen den Button V_n_ als aktive setzen unter älteren Versionen und können damit einen früheren Stand zur neuen aktiven Version machen.

Export: Der Button Export (Pfeil-nach-unten-Symbol) bietet Als YAML und Als JSON zum Herunterladen der aktuellen Ontologie. Der Export steht allen Rollen ab Reader zur Verfügung.

Nächste Schritte ​

Kelaria — ein Produkt von RAUSCH Technology.

© 2026 RAUSCH Technology