nexus/wiki/concepts/Identity-Resolution.md

title, type, tags, sources, last_updated

title	type	tags	sources	last_updated
Identity Resolution	concept	identity entity-resolution multi-agent data-matching	identity-graph-operator	2026-04-25

Identity Resolution（身份解析）

Definition

将来自不同来源的多条记录归一化为同一 canonical entity_id 的过程——确保同一个真实世界实体（人/公司/产品）在系统中只对应一个唯一标识符，所有 Agent 共享这一规范视图。

Core Workflow

原始记录 → 规范化(Normalize) → 阻塞(Blocking) → 评分(Scoring) → 聚类(Clustering) → Canonical Entity

1. 规范化：邮箱小写、电话 E.164 格式、昵称扩展（Bill→William）
2. 阻塞：用 blocking key（email domain / phone prefix / name soundex）快速筛选候选对，避免 O(n²) 全图扫描
3. 评分：字段级加权相似度（email exact match = 1.0，name fuzzy = 0.82）
4. 聚类：高置信度候选归入同一 cluster，生成 canonical entity_id

Key Properties

• 确定性：相同输入必须返回相同 entity_id（由 Identity Graph Operator 强制执行）
• 证据驱动：每条合并决策必须有 per-field evidence，拒绝"看起来相似"断言
• 并发安全：通过乐观锁（version field）防止并发写入冲突
• 可审计：完整事件历史（entity.created / merged / split / updated）

Confidence Thresholds

置信度	操作
> 0.95	直接合并（单 Agent 高置信）
0.60–0.95	提案审查（多 Agent 协作）
< 0.60	创建新实体

Relationship to Related Concepts

• Identity Resolution ⊂ Master-Data-Management（MDM）：身份解析是 MDM 在多 Agent 系统中的分布式实现，增加了并发协调维度
• Identity Resolution 应用层：Personal CRM 联系人去重、Identity-Graph-Operator 企业级多 Agent 协调

Related Agents

• identity-graph-operator：Identity Resolution 能力在多 Agent 系统中的 Agent 化封装