vector search
vector search ist der rohe Blick in den Vektor-Index: Es übersetzt eine frei formulierte Anfrage in eine Bedeutungs-Repräsentation und listet die nächstgelegenen Abschnitte einer Notiz auf — mit ihrer Distanz, der Notiz, zu der sie gehören, und der Art des Abschnitts. Weder Graph noch Index werden dabei verändert.
Wofür ist das?
- Diagnose der Bedeutungssuche. Wenn die Bedeutungssuche oder der Chat ein überraschendes Ergebnis liefert, zeigt
vector searchdie ungefilterte Wahrheit darunter: welcher Abschnitt einer Notiz tatsächlich zur Anfrage passte und wie nah.entity search --semanticfasst pro Notiz zusammen und blendet Titel und Typ ein — hier bleibt alles auf Abschnitts-Ebene, unsortiert nach Notiz. - Index tunen. Nach einer Änderung an der Zerlegung der Notizen in Abschnitte oder einem Modellwechsel siehst du sofort, ob sich die Trefferlage und die Distanzen wie erwartet verschieben.
Aufruf
apparat vector search "barrierefreie web-formulare" --vault=recherche
| Option | Bedeutung |
|---|---|
| `--vault=<name | path |
--limit=<n> |
Maximale Anzahl roher Abschnitts-Treffer. Standard: 10. Muss eine ganze Zahl ≥ 1 sein. |
Der erste, positionale Wert ist die Anfrage in natürlicher Sprache — anders als bei der Volltextsuche keine Operatoren, sondern eine Formulierung, deren Bedeutung verglichen wird.
Beispielausgabe
Vault "recherche" — raw vector hits for "barrierefreie web-formulare": #1 d=0.1842 V1StGXRa V1StGXRa:0 title #2 d=0.2311 AnNaQu3z AnNaQu3z:2 section: Einleitung #3 d=0.2874 V1StGXRa V1StGXRa:1 body
Jede Zeile ist ein Treffer: Rang, Distanz (d=), Notiz, Abschnitts-Kennung und Art des Abschnitts.
Leerer oder noch nicht gefüllter Index:
Vault "recherche" — raw vector hits for "barrierefreie web-formulare": (no matches)
Felder im Detail
- #. Rang in aufsteigender Distanz — Rang 1 ist der nächste Treffer.
- Distance. Abstand zwischen Anfrage und Abschnitt; kleiner ist näher. Absolutwerte sind nur innerhalb eines Index vergleichbar, nicht über Modelle hinweg.
- Entity. Die Notiz, zu der der Abschnitt gehört. Mehrere Zeilen können dieselbe Notiz nennen — das ist der Unterschied zur zusammengefassten Bedeutungssuche.
- Chunk. Kennung des einzelnen Abschnitts innerhalb der Notiz.
- Kind. Art des Abschnitts — Titel, Eigenschaften, Beziehungen, Fließtext oder ein benannter Abschnitt (dann mit dessen Überschrift).
Exit-Codes
| Code | Bedeutung |
|---|---|
| 0 | Anfrage gelaufen — auch wenn kein Treffer gefunden wurde. |
| 1 | Leere Anfrage, ungültiges --limit, Vault nicht auflösbar, Embedding-Dienst nicht erreichbar, oder die Vektor-Datenbank ist nicht öffenbar (z. B. fehlende Extension auf dem Host). |