Zum Inhalt springen
OpenDome

Retrieval (RETRIEVE)

Retrieval ist eine Relationsquelle innerhalb von OSL-SQL: die RETRIEVE(...)-Table-Function. Es gibt keinen separaten /osl/retrieve-Endpoint mehr — du SELECTest aus RETRIEVE(...) in einem POST /osl/query-Body.

Die Form

Abschnitt betitelt „Die Form“
SELECT text, score, customer_id
FROM RETRIEVE(facet => 'meeting_transcripts',
              query => 'european equity exposure',
              top_k => 5)
  • facet — eine deklarierte UnstructuredFacet.
  • query — natürlicher Text; die Engine bettet ihn mit dem in der Facette deklarierten Modell ein.
  • top_k — muss ≤ facet.retrieval.max_top_k erfüllen.
  • Metadata-Filter werden vom gesteuerten Store (pro-Subject-Zeilen-Prädikate) vor dem ACL-Overfetch-Trim angewandt.

Jede zurückgegebene Passage trägt einen cite-Block (Source · Doc · Chunk) und ihren denormalisierten Entity-Schlüssel, sodass Ergebnisse zugeordnet und korreliert werden können.

{
  "text": "Anna wants to increase EU equity exposure […]",
  "score": 0.91,
  "customer_id": "9c1e…f04a",
  "cite": { "source": "gong://…", "doc_id": "meet-2026-05-08-7a3c", "chunk_id": "chk-…" },
  "redacted_fields": []
}

Wie Retrieval gesteuert wird

Abschnitt betitelt „Wie Retrieval gesteuert wird“
  • Redaktionsversion. Die Facette wird in der vom Subject geforderten Redaktionsversion bedient — exact-or-deny. Redigierte Metadata-Felder sind in redacted_fields aufgeführt.
  • Row-level ACL. Deny-by-default: Ein Actor ohne Grant erhält null Passagen.
  • Isolation. Die Query öffnet nur die Lance-Tabelle der ausgewählten Version — kein Seitenkanal zu weniger redigierten Vektoren.

Verwandt

Abschnitt betitelt „Verwandt“