Neuronen-Metadaten

Neuronen-Metadaten sind eine kleine Menge deklarierter Labels, die Sie an ein Neuron anhängen können — ein Produkt, eine Kundenliste, eine Datenschutzklassifizierung, eine Prüfmarkierung. Ihr Zweck ist das Filtern: eine Suche oder Auflistung auf den relevanten Teil des Brains einzugrenzen, damit ein Agent die zehn richtigen Neuronen erhält statt der zweihundert plausiblen.

Metadaten werden nie als Text durchsucht und nie eingebettet. Ihre Bearbeitung lässt Embedding, Chunks und Inhalts-Hash des Neurons unberührt, sodass das Kennzeichnen von tausend Neuronen keinen Neuindexierungsaufwand verursacht.

Die Registrierung: erst deklarieren, dann schreiben

Jedes Brain hat sein eigenes Metadatenfeld-Register. Ein nicht deklarierter Schlüssel kann weder geschrieben noch gefiltert werden — das ist beabsichtigt. Frei gewählte Schlüssel driften auseinander („customer“ bei einem Neuron, „customer_id“ beim nächsten), und ein KI-Agent hat keine Möglichkeit herauszufinden, was er sagen darf. Das Register ist der Vertrag.

Verwalten Sie es auf der Brain-Seite unter Metadatenfelder. Nur der Brain-Eigentümer sieht diese Registerkarte. Bei einem Brain ohne deklarierte Felder ruht die Funktion einfach: nichts zu schreiben, nichts zu filtern.

Ein Feld bearbeiten und löschen

• Das Bearbeiten der Beschreibung oder der zulässigen Werte ändert nichts an bereits gespeicherten Daten.
• Das Ändern des Typs oder des Mehrfachwert-Flags ist ebenfalls erlaubt und überschreibt gespeicherte Werte nie. Vorhandene Werte bleiben genau so erhalten, wie sie sind, und passen weiterhin wie gespeichert auf Filter; nur neue Schreibvorgänge werden gegen die neue Definition geprüft. Ein Wert, der nicht mehr konform ist, kann höchstens nicht mehr auf einen Filter passen — er kann nie etwas beschädigen.
• Das Löschen eines Felds behält die Daten. Werte, die bereits an Neuronen hängen, bleiben erhalten, werden aber inaktiv: Ein Filter mit dem gelöschten Schlüssel wird abgelehnt, und die Werte erscheinen wieder, sobald Sie den Schlüssel erneut deklarieren.

Werte schreiben

Auf der Seite eines Neurons bietet die Karte Metadaten ein Feld pro deklariertem Feld. Lassen Sie ein Feld leer, um diesen Wert zu entfernen; Alle Metadaten löschen leert das Objekt vollständig. Agenten tun dasselbe über aiqbee_create_neuron und aiqbee_update_neuron, wo metadata ein Merge-Patch ist: Gesendete Schlüssel werden über die gespeicherten Werte gelegt, ein JSON-null löscht einen Schlüssel, und die Zeichenfolge clear leert alles.

Limits: höchstens 20 Schlüssel pro Neuron und 8 KB serialisiertes JSON. Werte sind flach — Skalare oder Listen von Skalaren bei einem Feld mit mehreren Werten. Keine verschachtelten Objekte.

Filterung

Wählen Sie auf der Brain-Seite unter der Neuronenliste ein Feld und einen Wert, um einen Filter-Chip hinzuzufügen. Chips sind Links, sodass Sie eine gefilterte Ansicht als Lesezeichen speichern oder teilen können. Über MCP ist dasselbe ein metadata_filter-Argument bei aiqbee_search und aiqbee_list_neurons.

Filter lassen sich mit allem anderen kombinieren — Textsuche, Neuronentyp und Zugriffskontrolle. Ein Neuron, das Sie nicht sehen dürfen, bleibt verborgen, unabhängig davon, ob ein Metadatenfilter gesetzt ist.

Werte werden in den deklarierten Typ umgewandelt, sodass das Filtern eines number-Feldes nach "5" den Wert 5 findet. Das Filtern nach einem Schlüssel, den das Brain nicht deklariert, wird mit der Liste der deklarierten Schlüssel abgelehnt — so kann sich ein Agent in einem Durchgang selbst korrigieren, statt stillschweigend keine Ergebnisse zu erhalten.

Lizenzierung: eine kostenpflichtige Funktion und was bei Ablauf geschieht

Neuronen-Metadaten sind eine kostenpflichtige Funktion, ebenso wie Audit-Verlauf und erweiterte Sicherheit — siehe Lizenzierung & Stufen. Die Sperre ist bewusst asymmetrisch, und gerade diese Asymmetrie macht ein Downgrade verkraftbar.

Wenn eine Lizenz also abläuft oder herabgestuft wird: Nichts wird gelöscht und nichts ausgeblendet. Jeder Wert, den Sie mit Lizenz geschrieben haben, bleibt am Neuron, bleibt in der Oberfläche und in Tool-Ergebnissen sichtbar und bleibt filterbar. Nur Schreibvorgänge sind blockiert. Entfernen bleibt absichtlich möglich, damit Sie nie in einem Zustand festsitzen, den Sie nicht verlassen können. Eine erneute Lizenzierung stellt das Schreiben sofort wieder her — es gibt nichts wiederherzustellen oder neu zu importieren. Metadaten werden auch mit einem OKF-Export übertragen; wird dieses Bundle in eine Hive ohne die Berechtigung importiert, werden die Werte gespeichert, aber die Feldregistrierung wird nicht angelegt.

Ausgegraute Steuerelemente sind eine Gefälligkeit; die Prüfung erfolgt serverseitig und gilt gleichermaßen für die Web-Oberfläche und die MCP-Tools. Eine abgelaufene Lizenz ist ein eigener, weiter gefasster Fall: Der gesamte Hive wird schreibgeschützt, Metadaten eingeschlossen.

Was Metadaten nicht sind

Es sei wiederholt, weil die Feldnamen den Irrtum nahelegen. Ein Feld namens company_ids oder privacy_level sieht aus wie eine Berechtigung. Das ist es nicht, und Hive behandelt es nicht als solche.

• Jeder Benutzer mit Lesezugriff auf das Brain kann jedes Neuron und alle seine Metadaten sehen, unabhängig davon, was die Bezeichnungen sagen.
• Jeder Aufrufer kann den Filter einfach weglassen.
• In Suche, Auflistung oder Abruf wird nirgends anhand von Metadaten über die Sichtbarkeit entschieden.

Um tatsächlich einzuschränken, wer ein Neuron lesen darf, verwenden Sie die Neuronentyp-Sicherheit (erweiterte Sicherheit): Markieren Sie das Neuron als typgesichert und erteilen Sie seinen Neuronentyp den Benutzern, Gruppen oder Dienstkonten, die es sehen sollen. Das ist der durchgesetzte Mechanismus, der auf jedem Lesepfad greift. Metadaten stehen daneben als Beschreibung, nie als Schutz.