Schemas

Memory Configuration

Schemas definieren die Struktur von Memory-Objekten. Sie legen fest, welche Felder existieren, wie Werte validiert werden und welche Teile eines Objekts für Identität oder Suche wichtig sind.

Was ein Schema definieren kann

• Felder und Typen
• Validierungsregeln
• Identitätsfelder
• Ein Embedding-Schema für die semantische Suche
• Die UI-Darstellung im Admin-Bereich

Ein Schema erstellen

1. Navigiere zu Admin > Memory > Types und wähle Create Type.

2. Vergib einen eindeutigen Typnamen.

3. Optional kannst du Display Name und Description ergänzen.

4. Definiere das JSON Schema.

5. Optional kannst du ein idSchema für Identität festlegen.

6. Optional kannst du ein embeddingSchema definieren, um die semantische Suche auf wichtige Felder zu fokussieren.

7. Speichere das Schema. Es startet im Entwurfsstatus.

Eigenschaftstypen

Gängige Typen in JSON Schema sind:

Typ	Beschreibung
string	Textwerte
number	Numerische Werte
boolean	Wahr/Falsch-Felder
array	Listen
object	Verschachtelte Strukturen

Typgruppen

Gruppe	Zweck
PARAMETER	Eingabe-Schemas für Tools
RETURN	Ergebnis-Schemas für Tools
KNOWLEDGE	Business-Wissensschemas wie FAQ, Produkte oder Guides

Veröffentlichen und Zurückziehen

Schemas können als Entwurf oder veröffentlicht vorliegen:

• Unveröffentlicht — sichtbar und bearbeitbar, aber nicht für neue Objekte nutzbar
• Veröffentlicht — aktiv und für Objekte und Importe nutzbar

Schemas aktualisieren

Beim Aktualisieren prüft die Plattform, ob Änderungen noch mit vorhandenen Objekten kompatibel sind. Vorsicht ist besonders bei Pflichtfeldern und strukturellen Änderungen wichtig.

Schema-Komposition

Schemas können andere veröffentlichte Schemas referenzieren. Das ist hilfreich, wenn du größere Strukturen aus kleineren, wiederverwendbaren Bausteinen zusammensetzen willst.

Beispiele:

• Ein Troubleshooting-Schema referenziert ein Symptom-Schema
• Ein Bundle-Schema referenziert ein Produkt-Schema

Für die meisten Nutzer ist wichtig: das ist Komposition und Wiederverwendung, nicht ein Thema, bei dem die interne Beziehungsmodellierung im Vordergrund steht.

Identity Schema (idSchema)

Das idSchema legt fest, welche Felder ein Objekt eindeutig identifizieren. Damit können Importe und Upserts vorhandene Objekte aktualisieren, statt Duplikate zu erzeugen.

Das ist besonders nützlich für wiederholte Importe.

Embedding-Schema

Mit dem optionalen Embedding-Schema legst du fest, welche Teile eines Objekts in die semantische Indizierung einfließen.

Das ist sinnvoll, wenn:

• das vollständige Objekt viel Rauschen enthält
• IDs, Zeitstempel oder interne Felder die Suche verwässern würden
• du die Suche auf Beschreibungen, Zusammenfassungen, Symptome oder Schritte fokussieren willst

Wenn du kein Embedding-Schema angibst, nutzt die Plattform den gespeicherten Objektinhalt als Grundlage.

Schema-Nutzung

Auf der Detailseite eines Schemas kannst du unter anderem sehen:

• Anzahl der Objekte
• Verwandte Typen
• Gruppenzugehörigkeiten

Nächste Schritte

Objects Erstelle und importiere Memory-Objekte, die deinen Schemas entsprechen.

Explorer Durchsuche Memory-Objekte in einer Ordnerstruktur.

Knowledge Graph Verbinde Objekte durch typisierte Beziehungen.