用途:在起草或分诊邮件前,把姓名或部分邮箱解析为真实邮箱地址,并补充 CRM/联系人上下文。
主要能力:find-contact 按姓名或部分邮箱查找联系人,大小写不敏感,查询按空白拆分为多个词且必须全部匹配,结果按交互频率 count 排序;Google People API 中已保存联系人起始 count 为 5,未保存但有过邮件往来者起始更低,收发邮件会累加 contact_frequency 表中的 sendCount/receiveCount。get-hubspot-contact 是唯一一等 CRM 动作,按邮箱返回姓名、电话、公司、职位、生命周期阶段、线索状态,以及最多 5 个关联交易和 5 个关联工单,使用用户在设置中配置的 HubSpot API 密钥。
使用方式:优先用 find-contact 而非直接询问用户邮箱或猜测 firstinitiallastname@company.com 这类模式,例如 find-contact --query="<name or partial email>" --limit=5。若返回零匹配,应告知用户,不要编造邮箱。结果按 owner 缓存数分钟,刚在 Google Contacts 添加的联系人可能不会立即出现。未配置 HubSpot 密钥时返回 { error: "HubSpot API key not configured" },应如实说明。HubSpot 的交易搜索、工单创建、属性元数据等需改用 provider-api-catalog / provider-api-docs 配合 provider-api-request。
适用场景:邮件撰写、收件人解析、邮件分诊时补充 CRM 上下文。
限制:Gong、Pylon、Apollo 在 Mail 中仅 UI 侧边栏可见,没有对应 agent 动作,provider-api-request 在本应用会拒绝这三个 provider;不要伪造结果。相关技能包括 email-drafts、draft-queue、actions。