Datentypen

Datentypen definieren die Struktur von Memory-Objekten. Jeder Datentyp ist eine JSON-Schema-Definition, die beschreibt, welche Felder ein Objekt besitzt, wie Werte validiert werden und welche Teile für Identität und semantische Suche relevant sind. Jedes Objekt in Memory entspricht genau einem Datentyp.

Die Data-Types-Seite

Öffnen Sie Data Types unter /admin/memory-types (Admin-Seitenleiste, Bereich Knowledge). Die Liste zeigt für jeden Typ den Type-Namen, die Usage groups, ob er Managed ist, die aktuelle Version, das Datum der letzten Änderung (Updated) und den Status. Unveröffentlichte Typen sind standardmäßig ausgeblendet — aktivieren Sie Show unpublished, um sie anzuzeigen. Eine Canvas-Ansicht steht ebenfalls zur Verfügung.

Managed-Typen werden von nara bereitgestellt und gepflegt; eigene Typen legen Sie daneben an.

Einen Datentyp erstellen

Klicken Sie auf Create Data Type und füllen Sie die Definition aus:

Benennen. Vergeben Sie einen Display Name (Anzeige in der UI), einen technischen Type name (verwendet von Agents und der API) sowie eine Description, die Agents erklärt, was der Typ repräsentiert.
JSON Schema aufbauen. Definieren Sie die Felder des Objekts im visuellen Builder oder wechseln Sie in die Code-Ansicht. Verfügbare Eigenschaftstypen: String, Number, Integer, Boolean, Enum, Object und Reference. Eine Reference verweist auf einen anderen Datentyp und verknüpft Objekte im Knowledge Graph; wählen Sie den Versionsmodus — Latest, um immer der neuesten Version des referenzierten Typs zu folgen, oder Pinned, um eine bestimmte Version festzuschreiben.
Identity Schema festlegen. Wählen Sie eine Teilmenge der Felder, die ein Objekt eindeutig identifiziert. nara erkennt damit, wenn zwei Datensätze dasselbe beschreiben — zum Beispiel während der Ingestion.
Embedding Schema konfigurieren. Wählen Sie die Felder, deren Inhalt für die semantische Suche eingebettet werden soll, und aktivieren Sie Automatic embeddings, damit nara die Embeddings beim Anlegen oder Aktualisieren von Objekten automatisch berechnet. Nur eingebettete Felder beeinflussen die Ergebnisse von Query Memory.
Usage categories setzen. Legen Sie fest, wo der Typ verwendet werden darf: Knowledge (gespeichertes Organisationswissen), Parameter (Eingabe für Workflow-Agents) oder Return (Ausgabe von Workflow-Agents). Ein Typ kann mehreren Kategorien angehören.
Visibility setzen. Visible-Typen erscheinen in den normalen Objektansichten; System hidden-Typen werden intern verwendet und aus nutzerseitigen Listen herausgehalten; Hidden legacy kennzeichnet ausgemusterte Typen.

Veröffentlichung und Versionierung

Mit Publish stellen Sie einen Datentyp bereit; unveröffentlichte Typen erscheinen in der Liste nur bei aktiviertem Show unpublished, und mit Unpublish ziehen Sie einen Typ wieder zurück. Datentypen sind versioniert — die Liste zeigt die aktuelle Version jedes Typs, und Referenzen anderer Typen lösen gemäß ihrem Latest- oder Pinned-Modus auf. So steuern Sie, ob abhängige Typen Schemaänderungen automatisch folgen.

Jeder Typ zeigt einen Nutzungszähler, sodass Sie vor dem Zurückziehen oder Umbauen eines Typs sehen, wie viel davon abhängt.