Entità (Joint record)

La forma record (entity-first) risolve una JointEntity per una o più chiavi primarie — colonne strutturate, evidenza Lance e attributi derivati in un’unica chiamata governata. È la forma dietro il tool MCP entity_get.

Era un endpoint, ora è una forma

/osl/joint/resolve è stato rimosso. Ora è un SELECT su osl.entities.<Joint> dentro OSL-SQL; il suo resolver è il backend di quella 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 * restituisce tutti gli exposed_attributes dichiarati. Le chiavi sono obbligatorie — un insieme di chiavi vuoto viene rifiutato (niente full-scan). I risultati sono ordinati secondo la lista delle chiavi; una chiave assente torna marcata come mancante invece di essere fabbricata.

Entità risolta (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 […]"
}

Avvertenza sullo slice

Gli attributi la cui sorgente è una metrica o una colonna vicina tra modelli sono attualmente differiti e risolvono a null — il join cross-model e il motore di metriche sono next-level. Le colonne strutturate dirette, le gambe non strutturate e gli attributi derived risolvono oggi.

Governato dallo stesso modello

Ogni attributo è soggetto alle concessioni del chiamante: le colonne non concesse tornano oscurate (⟦redacted⟧), le colonne obbligate mascherate, le gambe Lance servite alla versione di oscuramento richiesta. Una negazione totale restituisce un E2101 non rivelatore — il motore non rivela mai quale policy ha negato.

Correlati

• La superficie di query (OSL-SQL) — tutte e cinque le forme.
• Accesso e capacità — le concessioni e il MEET dietro tutto questo.