Entities (enregistrement Joint)

La forme record (orientée entité) résout une JointEntity pour une ou plusieurs clés primaires — colonnes structurées, preuves Lance et attributs dérivés en un seul appel gouverné. C’est la forme derrière le tool MCP entity_get.

Était un endpoint, maintenant une forme

/osl/joint/resolve a été supprimé. C’est désormais un SELECT sur osl.entities.<Joint> au sein d’OSL-SQL ; son resolver est le backend de cette forme.

La forme

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

SELECT * renvoie tous les exposed_attributes déclarés. Les clés sont requises — un ensemble de clés vide est refusé (pas de full-scan). Les résultats sont ordonnés selon la liste de clés ; une clé absente revient marquée manquante plutôt que fabriquée.

Resolved entity (shape)

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

Réserve sur le slice

Les attributs dont la source est une métrique ou une colonne voisine à travers des modèles sont actuellement différés et se résolvent en null — le join cross-model et le moteur de métriques sont next-level. Les colonnes structurées directes, les jambes non structurées et les attributs derived se résolvent dès aujourd’hui.

Gouverné par le même modèle

Chaque attribut est soumis aux grants de l’appelant : les colonnes non accordées reviennent caviardées (⟦redacted⟧), les colonnes obligées masquées, les jambes Lance servies à la version de caviardage requise. Un refus total renvoie un E2101 non révélateur — le moteur ne dévoile jamais quelle politique a refusé.

Voir aussi

• La surface de query (OSL-SQL) — les cinq formes.
• Accès et capacités — les grants et le MEET derrière ceci.