Fathom Performance Tuning 是一个面向 Fathom API 的性能优化技能,用于在会议数据同步与逐字稿下载场景中降低延迟、减少限流错误。
【用途】 Fathom 的会议智能 API 提供逐字稿下载、会议批量同步与行动项聚合。资料指出,逐字稿负载较大(每份约 50–500KB),批量同步历史会议时会造成明显的延迟瓶颈;同时 API 存在每分钟 60 次请求的速率限制,需要谨慎分批。该技能的目标就是针对这些问题给出可落地、可衡量的优化做法。
【主要能力】
- 缓存策略:使用带 TTL 的内存缓存。逐字稿在生成后不可变,可缓存 1 小时;行动项会变化,缓存 2 分钟;会议数据缓存 5 分钟。
- 批量操作:将逐字稿下载按每批 50 条分组,批次之间等待 61 秒,以符合每分钟 60 次请求的限制。
- 连接池:通过 HTTPS Agent 启用 keepAlive,maxSockets 为 6、maxFreeSockets 为 3、timeout 为 45 秒;由于逐字稿下载负载大,采用较长超时和较少并发连接。
- 限流管理:捕获 429 状态,读取 Retry-After 头并等待相应时间后重试。
- 监控指标:跟踪下载次数、缓存命中数、限流次数和平均延迟。
- 性能清单:包括逐字稿 1 小时 TTL 缓存、用 webhook 替代轮询获取新会议、每 50 条一批并间隔 60 秒、行动项 2 分钟 TTL、HTTP keep-alive 45 秒超时、跟踪限流并依据 Retry-After 退避、并行获取相互独立的会议元数据与逐字稿、在客户端聚合行动项以减少 API 往返。
- 错误处理:针对 429 限流、逐字稿超时、行动项过期、逐字稿缺失(会议仍在处理)、批次中途网络中断导致的部分同步失败,给出对应的排查与修复方向。
【使用方式】 资料给出的示例流程是:使用合成会议数据测量处理与 CRM 同步延迟,改动一个受控的并发设置,并与基线进行聚合对比;如果错误率上升或后续跟进行为不正确,则回滚。同时明确要求不得为了提升性能而绕过审查或数据保留控制。前置条件包括:具备处理延迟、同步/投递错误、质量和已批准的数据与同意策略的基线;准备合成会议元数据、指定负责人,以及可回滚的性能变更阈值。输出为带有数据与同意护栏、负责人和回滚记录的实测性能建议。
【适用场景】 适用于需要批量同步 Fathom 历史会议、下载大量逐字稿,或频繁读取行动项并希望降低延迟与限流报错的集成场景。
【限制与约束】 技能强调变更必须一次只改一个受控设置、可回滚,并在质量、同意、投递或可靠性出现回归时回滚;测量不得使用会议内容作为诊断数据。除资料中明确给出的内容外,本技能的具体收费、价格、支持平台等事实暂未提供。