Deep Dive: Namespace-Regeln
Namespace-Regeln ermöglichen es Administratoren, das Verhalten der KI-Suche global zu steuern, ohne jeden Agenten einzeln konfigurieren zu müssen.
Vierzehn Regeln kommen ab Werk mit. Sie legt die Migration
V81an — nicht der Bootstrap, denn der läuft bei einem Update bewusst nur für die mitgelieferten Skills. Eine Installation, die von einer älteren Version kommt, bekäme sonst die Spalten des Gedächtnismodells ohne dessen Konfiguration.Die Migration fügt nur hinzu: Eine Regel, deren Muster bereits existiert, bleibt unangetastet. Wer eine mitgelieferte Regel geändert oder absichtlich gelöscht hat, behält seinen Stand über Updates hinweg.
1. Ranking-Boni
Abschnitt betitelt „1. Ranking-Boni“Mit dem Ranking-Bonus kannst du steuern, welche Informationsquellen bevorzugt werden sollen.
- Prinzip: Ein Bonus zwischen
0.0und1.0wirkt als prozentualer Aufschlag auf die Ähnlichkeit und ergibt die Relevanz.0.2bedeutet also +20 % — nicht+0.2als absoluter Wert. - Anwendungsfall: Gib
vector.global.knowledge.faqeinen Bonus von0.2, damit offizielle Antworten immer über zufälligen Chat-Notizen erscheinen. - Augenmaß: Werte über
0.3heben schwache Treffer über die Mindest-Score-Schwelle, die sie aus eigener Ähnlichkeit nie erreicht hätten. Die mitgelieferten Regeln bewegen sich zwischen0.03und0.12.
2. LLM Instruktion Templates
Abschnitt betitelt „2. LLM Instruktion Templates“Dies ist ein mächtiges Feature, um die Antwortqualität zu erhöhen. Findet die KI einen Treffer aus einem Namespace mit Instruktionstext, wird dieser Text dem Treffer im Kontext vorangestellt.
- Beispiel: Für den Namespace
vector.global.business.legalhinterlegst du: “Zitiere bei Informationen aus diesem Bereich immer den entsprechenden Paragraphen: {{content}}” - Wirkung: Der Agent wird automatisch zum “juristischen Berater”, sobald er Wissen aus dieser Quelle abruft.
- Platzhalter:
{{content}}markiert die Stelle, an der die Treffer eingesetzt werden. Fehlt er, werden sie an den Text angehängt. - Einmal je Gruppe: Treffen mehrere Ergebnisse dieselbe Regel, erscheint der Instruktionstext einmal über allen — nicht einmal pro Treffer.
Die Konvention (QUELLE) und (MEMORY)
Abschnitt betitelt „Die Konvention (QUELLE) und (MEMORY)“Die mitgelieferten Vorlagen beginnen mit einem Etikett in Klammern, und das ist keine Kosmetik: Es entscheidet, ob ein Treffer zitiert wird.
| Etikett | Wofür | In der Antwort |
|---|---|---|
(QUELLE) | Korpus — Rezepte, Anleitungen, Dokumentation, persönliche Unterlagen | wird als Quelle genannt |
(MEMORY) | Gedächtnis — Notizen, Vorlieben, Arbeitsanweisungen, Zwischenstände | wird nicht genannt |
Das Etikett deckt sich mit der Gedächtnisklasse: Alle Namespaces der Klasse document tragen (QUELLE), alle übrigen (MEMORY). Wer eine eigene Vorlage schreibt, sollte sich daran halten.
Ein zitierter Korpus-Treffer erscheint am Ende der Antwort als dritte Form neben URL und Dateipfad:
##### Quellen- Gedächtnis `vector.global.privat.recipes`Warum das nötig ist. Der injizierte Block ist für den Nutzer unsichtbar. Ob eine Antwort aus seiner eigenen Sammlung stammt oder aus dem allgemeinen Wissen des Modells, sieht er ihr sonst nicht an — beide lesen sich gleich sicher. Belegt an einem Fall, in dem derselbe Agent auf dieselbe Frage einmal ein erfundenes und einmal das gespeicherte Rezept lieferte, ohne dass die Antworten sich unterschieden hätten.
Was nie zitiert wird, und zwar unabhängig vom Etikett: was der Nutzer im laufenden Gespräch gesagt hat, was der Agent in diesem Zug gerade gespeichert hat, und sein eigenes Wissen. Ein Eintrag ohne Etikett wird ebenfalls nicht genannt — im Zweifel schweigen.
Der Text landet nicht im System-Prompt, sondern am Ende der letzten Nutzernachricht. Grund ist das Prompt-Caching; Details in der technischen Referenz.
3. Gedächtnisklasse
Abschnitt betitelt „3. Gedächtnisklasse“Eine Regel kann eine Standard-Klasse für ihren Namespace festlegen. Jeder Eintrag, der dorthin geschrieben wird, bekommt sie automatisch — der Agent muss nichts angeben.
| Klasse | Wofür |
|---|---|
| Episodisch | Etwas, das geschehen ist, zu einer Zeit |
| Semantisch | Ein Fakt, der gilt, bis er ersetzt wird |
| Prozedural | Eine Regel oder Arbeitsanweisung |
| Arbeitskontext | Nur für die laufende Aufgabe nötig |
| Dokument (Korpus) | Eingelesenes Quellmaterial, kein Gedächtnis |
Die Regel ist ein Standard, keine Festlegung. Ein Namespace enthält in der Praxis gemischte Klassen —
…preferencesetwa trägt neben echten Präferenzen auch Fakten und Arbeitsanweisungen. Deshalb kann jeder einzelne Eintrag beim Schreiben eine abweichende Klasse führen, und eine spätere Änderung der Regel wirkt nicht rückwirkend auf den Bestand.Die Klasse steht bewusst nicht im Namespace-Namen. Sie kann sich ändern — eine Episode, die sich als dauerhafter Fakt erweist, wechselt die Klasse, ohne den Namespace zu verlassen. Ohne Klasse bleibt das Feld leer; das ist ehrlicher als ein geratener Wert.
Feld leer lassen („Kein Standard”), wenn ein Namespace zu gemischt ist, um eine sinnvolle Vorgabe zu tragen.
4. Pattern Matching
Abschnitt betitelt „4. Pattern Matching“Regeln gelten für Namespace-Muster, nicht für einzelne Namespaces:
| Schreibweise | Bedeutung |
|---|---|
${user_id} | genau ein Segment — die Regel gilt für jeden Nutzer |
* | beliebiger Rest, z.B. vector.agent.* |
Eine Regel deckt immer auch die Unter-Namespaces ihres Musters ab. Treffen mehrere Instruktionsregeln zu, gewinnt die längste.
🛠️ Technischer Hintergrund
Abschnitt betitelt „🛠️ Technischer Hintergrund“Für eine detaillierte mathematische Erklärung des Such- und Ranking-Algorithmus (inkl. Cosine Similarity, Recency Decay und Namespace-Boni), konsultieren Sie bitte die: