Retrieval (RETRIEVE)

El retrieval es una fuente de relación dentro de OSL-SQL: la función de tabla RETRIEVE(...). Ya no existe un endpoint /osl/retrieve separado — haces SELECT sobre RETRIEVE(...) en un body de POST /osl/query.

Era un endpoint, ahora es una forma

/osl/retrieve ha sido eliminado. Su resolver gobernado es ahora el backend de la forma RETRIEVE (y del tool MCP doc_search). La misma aplicación, una sola superficie.

La forma

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

• facet — una UnstructuredFacet declarada.
• query — texto natural; el motor lo embebe con el modelo declarado en la faceta.
• top_k — debe satisfacer ≤ facet.retrieval.max_top_k.
• Los filtros de metadata los aplica el store gobernado (predicados de fila por sujeto) antes del recorte por overfetch de la ACL.

Cada passage devuelto lleva un bloque cite (source · doc · chunk) y su clave de entidad desnormalizada, para que los resultados puedan atribuirse y correlacionarse.

Passage (forma)

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

Con una op de proyección

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

SUMMARIZE/SIMILARITY/… son operadores de proyección — mapas unarios sobre passages ya gobernados.

Cómo se gobierna el retrieval

• Versión de redacción. La faceta se sirve en la versión de redacción requerida por el sujeto — exacta-o-deny. Los campos de metadata redactados se listan en redacted_fields.
• ACL a nivel de fila. Deny-by-default: un actor sin grant obtiene cero passages.
• Aislamiento. La consulta abre solo la tabla Lance de la versión seleccionada — sin canal lateral a vectores menos redactados.

Cross-modal es fail-closed

Cuando una pierna RETRIEVE se une a una entidad estructurada (… JOIN RETRIEVE(...) ON x.k = r.k), la clave de join debe estar en claro en la salida gobernada del passage o el join no devuelve nada (403 E0515). Una clave enmascarada nunca correlaciona con una en claro. Ver el join cross-modal.

Relacionado

• La superficie de consultas (OSL-SQL) — las cinco formas.
• Acceso y capacidades — grants, versiones de redacción, MEET.
• Para una previsualización gobernada de unos pocos chunks, usa POST /osl/sample.