nexus/wiki/concepts/Evidence-based-Merge-Proposal.md

title, type, tags, sources, last_updated

title	type	tags	sources	last_updated
Evidence-based Merge Proposal	concept	multi-agent identity coordination decision-making	identity-graph-operator	2026-04-25

Evidence-based Merge Proposal（证据驱动合并提案）

Definition

多 Agent 身份协调中的标准提案协议——当发现两个实体应合并时，不直接执行 merge 操作，而是构造包含完整 per-field evidence 的提案，供其他 Agent 审查后再执行。

Structure

{
  "entity_a_id": "a1b2c3d4-...",
  "entity_b_id": "e5f6g7h8-...",
  "confidence": 0.87,
  "evidence": {
    "email_match": { "score": 1.0, "values": ["wsmith@acme.com", "wsmith@acme.com"] },
    "name_match": { "score": 0.82, "values": ["William Smith", "Bill Smith"] },
    "phone_match": { "score": 1.0, "values": ["+155****0142", "+155****0142"] },
    "reasoning": "Same email and phone. Name differs but 'Bill' is a known nickname for 'William'."
  }
}

When to Propose vs. Direct Merge

场景	动作	原因
单 Agent，置信度 > 0.95	直接合并	无歧义，无其他 Agent 需协商
多 Agent，置信度中等	提案合并	让其他 Agent 审查证据
Agent 不同意既有合并	提案拆分（含 member_ids）	不直接撤销，由多方验证
修正数据字段	带 expected_version 的直接变更	字段更新无需多 Agent 审查

Core Principles

• 永远不带证据不合并："These look similar" 不是证据，per-field comparison scores + confidence thresholds 才是证据
• 提案优于断言：提出 merge（带证据）而非直接执行，让对方 Agent 有机会审查
• 反压不覆盖：当 Agent 间存在冲突（一个提出 merge，另一个提出 split），不直接覆盖另一方证据，而是呈现反证据让最强证据胜出

Conflict Resolution

当两个 Agent 对同一对实体给出矛盾提案时：

1. 标记为 conflict 状态
2. 双方添加评论讨论证据
3. 等待人类或仲裁 Agent 最终裁决
4. 永不通过"强行覆盖"解决冲突