entity similar

entity similar findet Notizen, die thematisch nah an einer Referenz-Entität liegen — die Antwort auf die Frage „welche meiner Notizen passen zu dieser hier?", auch wenn sie nicht über Tags oder Frontmatter-Verlinkungen verbunden sind.

Mehr zu den verschiedenen Ähnlichkeits-Verfahren von Apparat steht in den Grundbegriffen.

Wofür ist das?

• Stoff-Sammlung um eine Referenz herum. Ausgangsnotiz Maria Beispiel; finde thematisch verwandte Notizen, ohne sie händisch zu durchsuchen.
• Sich durch ein Themenfeld weiterklicken. Drei Mal entity similar hintereinander, jeweils mit der besten neuen Treffer-NanoID — du landest schnell in der inhaltlichen Nachbarschaft.
• Direkter Zugriff auf der Kommandozeile auf dieselbe inhaltliche Nähe, die im Web-Editor der Abschnitt Eingehende & verwandte Einträge im Beziehungen-Tab anbietet.

Aufruf

apparat entity similar V1StGXRa
apparat entity similar V1StGXRa --vault=recherche --limit=20
apparat entity similar V1StGXRa --type=person

Die Referenz-Entität selbst wird immer aus dem Ergebnis ausgeschlossen.

Beispielausgabe

Vault "recherche" — entities similar to V1StGXRa:

  AnNaQu3z  Anna Quelle                 person          d=0.2913  (title)
  Qw9pLm2n  Beispiel-Organisation       organization    d=0.3401  (body)
  …

Spalten: NanoID, Titel, Typ, Distanz (kleiner = thematisch näher), Fundstelle innerhalb der Entität.

Voraussetzungen

• Der Vektor-Index muss befüllt sein. Eine Referenz-Entität, die noch nicht im Index steht — etwa weil der Hintergrund-Worker den Backlog noch nicht abgearbeitet hat — bricht mit einer entsprechenden Fehlermeldung ab. Lösung: vector rebuild oder warten, bis der Worker durch ist (siehe vector drift).
• Der Embedding-Dienst muss nicht laufen — die Anfrage nutzt das bereits gespeicherte Bedeutungs-Profil der Referenz-Entität. entity similar funktioniert auch bei abgeschaltetem Embedding-Dienst.

Wirkung der Filter

Wie bei entity search --semantic: die Suche läuft über den gesamten Index, der Filter wirkt auf das Ergebnis. Ein sehr enger Filter kann dazu führen, dass weniger als --limit Zeilen ankommen — --limit einfach erhöhen.

Fehler

• „Entity „…" has no title chunk in the vector index." — Die Referenz-Entität ist im Index nicht repräsentiert. Siehe oben.
• Falsche NanoId — Apparat meldet sich mit „Entity „…" has no title chunk", weil die ID schlicht im Index nicht existiert. Stimmt die ID? entity show <id> ist der schnelle Sanity-Check.
• --limit mit nicht-numerischem oder Null/Negativ-Wert — Apparat bricht mit Code 1 ab.