Entidades (registro Joint)

La forma registro (orientada a entidad) resuelve una JointEntity para una o más claves primarias — columnas estructuradas, evidencia Lance y atributos derivados en una sola llamada gobernada. Es la forma detrás del tool MCP entity_get.

Era un endpoint, ahora es una forma

/osl/joint/resolve ha sido eliminado. Ahora es un SELECT sobre osl.entities.<Joint> dentro de OSL-SQL; su resolver es el backend de esa forma.

La forma

SELECT name, segment, country, recent_meeting_topics, meeting_summary
FROM osl.entities.Customer
WHERE customer_id IN ('9c1e…f04a', 'e4f8…2a91')

SELECT * devuelve todos los exposed_attributes declarados. Las claves son obligatorias — un conjunto de claves vacío se rechaza (sin full-scan). Los resultados se ordenan según la lista de claves; una clave ausente vuelve marcada como faltante en lugar de fabricarse.

Entidad resuelta (forma)

{
  "customer_id": "9c1e…f04a",
  "name": "Anna Vidal",
  "segment": "retail-premium",
  "country": "ES",
  "recent_meeting_topics": [
    { "text": "…", "score": 0.91, "cite": { "source": "gong://…", "doc_id": "meet-…", "chunk_id": "chk-…" } }
  ],
  "meeting_summary": "Anna has asked in recent meetings about […]"
}

Salvedad del slice

Los atributos cuyo origen es una métrica o una columna vecina entre modelos están actualmente diferidos y resuelven a null — el join entre modelos y el motor de métricas son de siguiente nivel. Las columnas estructuradas directas, las piernas no estructuradas y los atributos derived resuelven hoy.

Gobernada por el mismo modelo

Cada atributo está sujeto a los grants del llamante: las columnas sin grant vuelven redactadas (⟦redacted⟧), las columnas con obligación enmascaradas, las piernas Lance servidas en la versión de redacción requerida. Una denegación total devuelve un E2101 no revelador — el motor nunca revela qué política denegó.

Relacionado

• La superficie de consultas (OSL-SQL) — las cinco formas.
• Acceso y capacidades — los grants y MEET detrás de esto.