Retrieval (RETRIEVE)

Le retrieval est une source de relation au sein d’OSL-SQL : la fonction de table RETRIEVE(...). Il n’y a plus d’endpoint /osl/retrieve séparé — vous faites un SELECT sur RETRIEVE(...) dans un body POST /osl/query.

Était un endpoint, maintenant une forme

/osl/retrieve a été supprimé. Son resolver gouverné est désormais le backend de la forme RETRIEVE (et du tool MCP doc_search). Même enforcement, une seule surface.

La forme

SELECT text, score, customer_id
FROM RETRIEVE(facet => 'meeting_transcripts',
              query => 'european equity exposure',
              top_k => 5)

• facet — une UnstructuredFacet déclarée.
• query — texte naturel ; le moteur l’embed avec le modèle déclaré dans la facette.
• top_k — doit satisfaire ≤ facet.retrieval.max_top_k.
• Les filtres de metadata sont appliqués par le store gouverné (prédicats de lignes par sujet) avant le trim d’overfetch de l’ACL.

Chaque passage renvoyé porte un bloc cite (source · doc · chunk) et sa clé d’entité dénormalisée, pour que les résultats puissent être attribués et corrélés.

Passage (shape)

{
  "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": []
}

With a projection op

SELECT SUMMARIZE(text) AS summary, score
FROM RETRIEVE(facet => 'meeting_transcripts', query => 'churn risk', top_k => 3)

SUMMARIZE/SIMILARITY/… sont des opérateurs de projection — des maps unaires sur des passages déjà gouvernés.

Comment le retrieval est gouverné

• Version de caviardage. La facette est servie à la version de caviardage requise du sujet — exact-or-deny. Les champs de metadata caviardés sont listés dans redacted_fields.
• ACL row-level. Deny-by-default : un actor sans grant obtient zéro passage.
• Isolation. La query n’ouvre que la table Lance de la version sélectionnée — pas de side-channel vers des vecteurs moins caviardés.

Le cross-modal est fail-closed

Quand une jambe RETRIEVE est jointe à une entité structurée (… JOIN RETRIEVE(...) ON x.k = r.k), la clé de join doit être en clair dans la sortie gouvernée du passage, sinon le join ne renvoie rien (403 E0515). Une clé masquée ne corrèle jamais avec une clé en clair. Voir le join cross-modal.

Voir aussi

• La surface de query (OSL-SQL) — les cinq formes.
• Accès et capacités — grants, versions de caviardage, MEET.
• Pour une prévisualisation gouvernée de quelques chunks, utilisez POST /osl/sample.