Datentypen
Ein Datentyp legt die Struktur eines Wissenseintrags fest: seine Felder, wie Werte geprüft werden, welche Felder einen Eintrag identifizieren und welche Felder nara durchsucht. Jeder Eintrag im Wissen folgt genau einem Datentyp. Auch Tools nutzen Datentypen für ihre Argumente und Ergebnisse.
Die Seite Datentypen
Abschnitt betitelt „Die Seite Datentypen“Schalte den Expertenmodus ein, öffne Bausteine unter Automatisierung in der Admin-Konsole, und wähle den Tab Datentypen (/admin/knowledge-types). Die Liste zeigt jeden Typ mit Namen, Nutzung, ob nara ihn verwaltet, seiner Version und seinem Status. Die verwalteten Typen pflegt nara; deine eigenen legst du daneben an.
Neuer Datentyp öffnet das Studio. Beschreibe den Eintrag, den du brauchst, prüfe die vorgeschlagenen Felder, und veröffentliche. Einen bestehenden Typ änderst du auf dieselbe Weise.
Was ein Datentyp festlegt
Abschnitt betitelt „Was ein Datentyp festlegt“| Teil | Bedeutung |
|---|---|
| Felder | Ein JSON-Schema mit Strings, Zahlen, Ganzzahlen, Booleans, Enums, Objekten und Verweisen. |
| Verweise | Ein Feld, das auf Einträge eines anderen Datentyps verweist. Es folgt der neuesten oder einer festen Version. |
| Identität | Die Felder, die einen Eintrag identifizieren, damit nara erkennt, wenn zwei Einträge dasselbe beschreiben. |
| Suchfelder | Die Felder, die nara für die Suche einbettet und indiziert. Die Textsuche findet außerdem den Schlüssel eines Eintrags, die exakte Suche auch seine ID. |
| Nutzung | Wissen (gespeicherte Einträge), Parameter (Tool-Argumente), Return (Tool-Ergebnisse). |
| Sichtbarkeit | Sichtbar: erscheint in der Wissens-App; Systemseitig ausgeblendet: bleibt intern; Ausgeblendet (Legacy): ausgemusterter Typ. |
Versionen
Abschnitt betitelt „Versionen“Jede veröffentlichte Änderung erzeugt eine neue Version. Verweise folgen ihrem Modus Neueste oder Fixiert, so entscheidest du, ob abhängige Typen einer Änderung folgen. Wenn bereits Einträge existieren, migriert nara sie auf die neue Version und veröffentlicht sie erst, wenn jeder Eintrag passt.