SuperAPI AI 工具集

recovery-cohort-builder

数据与分析

查看项目

更新于 10-16 06:17

技能介绍

用途:该技能用于构建“挽回队列(recovery cohort)”,从 Zoho Billing 抓取最近 7 天的两类报告——Lost Opportunities(丢失商机)与 Abandoned Carts(弃购购物车),合并归一化为统一结构并按 lost_value 降序排序,最终输出单个 JSON 文件供 recovery-strategy 技能使用。

主要能力:并行调用 ZohoBilling_get_lost_opportunities_report 与 ZohoBilling_get_abandoned_carts_report(参数 from_date、to_date,格式 YYYY-MM-DD,to_date 为今天,from_date 为 7 天前);将两个来源字段映射为统一 schema,含 source、record_id、customer_name、email、plan_name、lost_value、currency、days_since_event、event_date、stage、raw;缺失或 null 字段在输出中设为 null 而不丢弃该行;days_since_event 按今天与 event_date 的日期间隔计算。

排序与输出:lost_opportunity 记录整体排在前(源顺序),abandoned_cart 在后;同一来源内按 lost_value DESC。保存路径为 <workspace>/recovery-runs/<DATE>/cohort-raw.json,目录不存在则创建;并向用户打印包含各来源记录数、丢失总值、合计与保存路径的摘要。

边界处理:某来源无数据则在摘要中记为 0 条而不报错;lost_value 为 null 或非数值时按 0 排序但不丢弃;同一 record_id 在两个报告里重复出现时两者均保留,并加 duplicate_flag: true 供下游复核;日期解析失败时 event_date 与 days_since_event 置 null 并标记该行。

限制:资料未提供安装方式、依赖与运行环境要求;currency 等字段来源于 API 默认;具体字段映射需按 API 实际返回尝试候选字段。