Tunnista entiteetit piilottamatta monitulkintaisuutta

Entity Resolution vertaa jo tiedossa olevia identiteettisignaaleja kanonisiin entiteetteihin. Se palauttaa päätöksen, ei pelkkää parasta arvausta: vahva osuma on resolved, monitulkintainen osuma on review_required ja ilman riittävää näyttöä tietue jää unmatched-tilaan. Data Enrichment käyttää sisäisesti samaa päätöstä, joten synkroninen tunnistus ja asynkroninen rikastus eivät ole ristiriidassa.

Käytä vakaata record.id-tunnistetta, joka voidaan yhdistää lähdejärjestelmään. Lähetä vain tunnetut identiteettikentät ja valitse strict-, balanced- tai broad-politiikka. Kutsu vaatii entities:resolve-oikeuden.

curl -X POST https://api.enrich.nordicdevhouse.com/v1/entity-resolution/resolve \
  -H "Authorization: Bearer enrich_live_••••••••" \
  -H "Content-Type: application/json" \
  -d '{
    "record": {
      "id": "crm_1842",
      "type": "Organization",
      "fields": {"company_name": "Northstar Logistics Oy", "business_id": "2841842-1", "country": "FI"}
    },
    "confidence_policy": "balanced"
  }'

canonical_entity täytetään vain resolved-tulokselle. candidates pysyy pistejärjestyksessä, jotta tarkistusnäkymä voi näyttää uskottavat vaihtoehdot. decision kertoo käytetyn politiikan, kynnyksen, marginaalin ja syyn; evidence selittää pisteisiin vaikuttaneet signaalit.

{
  "client_record_id": "crm_1842",
  "status": "resolved",
  "entity_type": "Organization",
  "canonical_entity": {"id": "org_fi_2841842_1", "type": "Organization", "label": "Northstar Logistics Oy", "properties": {"businessId": "2841842-1"}, "confidence": 0.98, "evidence_ids": ["ev_ytj_northstar"]},
  "candidates": [{"rank": 1, "score": 0.999, "reasons": ["exact_business_id", "name_match", "country_match"], "entity": {"id": "org_fi_2841842_1", "type": "Organization", "label": "Northstar Logistics Oy", "properties": {"businessId": "2841842-1"}, "confidence": 0.98, "evidence_ids": ["ev_ytj_northstar"]}}],
  "decision": {"policy": "balanced", "threshold": 0.9, "required_margin": 0.08, "top_score": 0.999, "margin": 0.129, "outcome": "resolved", "reason": "strong_identifier_match"},
  "evidence": [{"id": "ev_ytj_northstar", "source": "prh_ytj", "observed_at": "2026-08-12T09:00:00Z", "url": "https://example.test/registry/northstar"}],
  "review_case_id": null,
  "resolved_at": "2026-08-15T12:00:00Z"
}

Northstar-nimi ilman yritystunnusta, verkkotunnusta, sähköpostia tai muuta erottavaa signaalia voi osua useaan organisaatioon. API palauttaa tarkoituksella review_required-tilan ja järjestetyt ehdokkaat eikä valitse yhtä hiljaisesti.

Kun tarvitset yhden välittömän identiteettipäätöksen, kutsu /entity-resolution/resolve. Kun tarvitset kestävän erän ja hyväksyttyjä faktoja, lähetä /enrichment-jobs general-entity@1-profiililla. Jokainen rikastustietue sisältää saman tunnistustuloksen ja näytön, ja monitulkintaiset tietueet pysyvät tarkistettavina.

POST /entity-resolution/evaluations ajaa enintään 1 000 merkittyä tietuetta strict-, balanced- ja broad-politiikoilla muuttamatta kanonista dataa. Vertaa tarkkuutta, recallia, vääriä osumia, puuttuvia osumia ja tarkistusastetta ennen politiikan julkaisua.

{
  "policies": ["strict", "balanced"],
  "cases": [{
    "record": {"id": "known-1", "entity_type": "Organization", "fields": {"business_id": "2841842-1"}},
    "expected_entity_id": "org_fi_2841842_1"
  }]
}

Listaa odottavat tapaukset /review-cases-reitiltä ja lähetä accepted, rejected tai unresolved sekä expected_version. Hyväksyntä valitsee korkeimmalle sijoitetun ehdokkaan, muodostaa hyväksytyt faktat uudelleen, poistaa review_required-tilan ja tuottaa valmistumistapahtuman. Vanhentunut expected_version palauttaa 409:n, joten kaksi tarkistajaa ei voi ylikirjoittaa toisiaan.

POST /entity-resolution/duplicates/detect löytää todennäköiset duplikaatit automaattisesti ja selittää tunnisteiden, normalisoidun nimen, maan, domainin, sähköpostin ja puhelimen vaikutuksen. Havainto ei koskaan yhdistä hiljaisesti: identity:write-kutsuja hyväksyy tai hylkää ehdotuksen odotettua graafiversiota vasten, ratkaisee ominaisuusristiriidat näkyvästi ja julkaisee uuden muuttumattoman version. Hyväksytyllä klusterilla on append-only-historia, ja se voidaan purkaa tarkkaan yhdistämistä edeltäneeseen snapshotiin niin kauan kuin merge-versio on aktiivinen.