SuperAPI AI 工具集

resolve-before-create

数据与分析

查看项目

更新于 10-16 06:27

技能介绍

用途

resolve-before-create 用于在任何工作流创建 CRM 记录之前,为每个拟创建的联系人或账户生成一个基于证据的身份判定。它适用于导入、数据丰富或手动创建联系人及账户的场景,目的是在写入之前先判断该记录应当创建、关联到已有记录、交由人工复核,还是被拒绝。

主要能力

规范化但不破坏证据

技能要求保留原始输入,再派生用于比较的规范化值。具体做法包括:将域名和邮箱转为小写、移除 URL 协议与路径、统一空白字符、将法律后缀从公司名称中分离。同时明确不得为了强行匹配而剥离有意义的子域名、国家区分或名称词元。

识别最强可用键

对人员,优先使用已验证邮箱、提供商身份、账户关系、全名和角色。对账户,优先使用规范域名、已验证外部身份、法律实体、地址和规范化名称。技能指出,仅凭公司名称是弱证据;共享的消费者邮箱域名不构成账户身份。

广泛搜索,窄口径决策

搜索范围包括活跃与归档记录、备用邮箱、曾用域名、别名、父子关系,以及组织保留窗口内已合并的标识符。每个强键独立搜索,避免某一字段的格式错误掩盖已有记录。随后构建候选配对,比较佐证与冲突证据,返回四种决策之一:

  • Link(关联):某个候选明确无歧义,新数据应归属其上。
  • Create(创建):搜索所有强键后不存在可信候选。
  • Review(复核):仍存在多个候选,或重要证据相互冲突。
  • Reject(拒绝):输入缺乏最低身份证据,或违反排除规则。

数值评分参考 references/match-rubric.md,评分用于支持决策,但不能覆盖硬冲突。

规划动作

对于关联决策,需指明每个新值写入哪个已有记录,以及该更新是填补空白还是替换数据;不得用未验证的丰富数据覆盖已验证值。

对于创建决策,需包含已搜索的键、搜索时间、候选数量、拟议负责人、来源、同意或合法使用背景,以及必需的关系。账户应尽可能携带稳定域名;当关系已知时,联系人不应被创建为无主、无账户的记录。

对于复核决策,需向人工展示最小必要证据集:候选标识符、匹配字段、冲突、近期活动、归属和下游关系,不应让复核者重新发现匹配。

应用前重新解析

在应用动作之前,必须重复搜索。其他工作流可能在规划之后已创建了记录。若出现新候选,则使创建决策失效并重新解析。

监控闸门

跟踪拟创建数、阻止的重复、模糊复核、错误关联、错误创建和解析时间。对已批准的创建和关联进行抽样。技能指出,一个把所有情况都路由到复核来阻止重复的闸门并不算有效;同样,一个宣称高自动化却制造昂贵错误关联的闸门也不算有效。

按来源调查突然增加的情况。激增通常意味着导出格式变化、上游标识符丢失、新收购,或某个集成搜索的人群比它写入的人群更窄。

使用方式

该技能以技能(skill)形式提供,来源为 swan-gtm/gtm-skills,页面地址为 https://www.skills.sh/swan-gtm/gtm-skills/resolve-before-create。具体安装命令与调用方式暂未提供。技能引用了两个参考文件:references/match-rubric.md(数值评分)和 references/worked-resolution.md(常见域名、邮箱和子公司案例)。

适用场景

适用于任何在 CRM 中创建联系人、账户记录之前的工作流,尤其是批量导入、数据丰富和手动录入场景。

限制与规则

技能明确以下规则:

  • 必须保留原始来源值并记录搜索证据。
  • 必须在创建前立即重新运行解析。
  • 对冲突的强标识或不可逆合并必须要求人工复核。
  • 绝不仅凭规范化名称匹配账户。
  • 未经批准绝不用较弱的丰富数据替换已验证数据。
  • 绝不为了规避模糊匹配而创建记录。

技能还描述了“良好实践”与“平庸版本”的对比:良好实践要求每个创建决策列出搜索的键和人群,精确标识符驱动高置信匹配,名称仅作佐证而非证明,冲突强制复核,创建前重新解析,新记录带有归属、来源和已知关系,复核者看到可操作证据。平庸版本只检查精确邮箱或公司名、忽略归档记录、先创建后去重,或因模糊分数越过阈值而忽略矛盾证据进行关联。