SuperAPI AI 工具集

waterfall-enrichment

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:针对同一批记录按优先级调用多个数据提供商(瀑布式),首个命中即停止,使覆盖率等于多个提供商并集,且按记录而非按提供商计费;适用于联系人补全、公司补全和邮箱验证。

主要能力:

  • 联系人补全 enrichContact:输入 full_name、domain 或 linkedin 等。
  • 公司补全 enrichCompany:仅有 domain 或公司 linkedin 时使用。
  • 邮箱验证 verifyEmail:验证补全得到的地址。

使用方式:环境安装与登录(幂等,可跳过已完成项):

npm install -g @cargo-ai/cli cargo-ai login --email you@company.com cargo-ai login --email you@company.com --code 123456

新账号无需单独注册、无浏览器步骤,首次使用自动创建账号与工作区,赠 100 免费额度且无需信用卡。用 cargo-ai whoami 确认登录状态。

批量执行示例(保持原样):

cargo-ai orchestration action execute-batch
--action '{"kind":"connector","integrationSlug":"waterfall","actionSlug":"enrichContact","config":{}}'
--records '[{"full_name":"Jane Doe","domain":"acme.com"},{"linkedin":"https://linkedin.com/in/someone"}]'
--wait-until-finished

将 actionSlug 换为 enrichCompany 或 verifyEmail,并传入对应记录字段。

操作为异步:--wait-until-finished 会阻塞至完成;否则返回 run/batch UUID,可用 cargo-ai orchestration run get <uuid>(2 秒间隔)或 cargo-ai orchestration batch get <uuid>(5 秒)轮询。

成本(每记录):

  • waterfall.verifyEmail:0.1 额度
  • waterfall.enrichCompany:1 额度
  • waterfall.enrichContact:2 额度

限制与注意事项:

  • 首次不要在全量列表上运行;先抽样 10–20 条报告命中率与成本,待用户确认后再全量运行,并报价记录数与额度估算。
  • 瀑布按记录计费,在未筛选列表上运行成本高于单一提供商。
  • 应把最便宜的环节排在前,已有邮箱应先行验证再决定是否进入补全环节。
  • 补全出的邮箱仍属推测,需验证后使用。
  • 若本会话已提供 cargo-gtm,应改用完整包而非本独立技能,避免同一请求被路由两次。

资料未提供完整的失败模式、回退方案及验证门细节(这些位于 cargo-gtm/provider-playbooks/waterfall.md)。完整 GTM 能力可通过 npx skills add getcargohq/cargo-skills 获取。