SuperAPI AI 工具集

fathom-rate-limits

通用与其它

查看项目

更新于 10-16 07:06

技能介绍

Fathom Rate Limits 是一个面向 Fathom API 集成的技能,用于处理 Fathom API 的速率限制。据资料,Fathom 对每个用户在全部 API 密钥上强制实施每分钟 60 次请求的上限;由于会议记录和行动项常在一次通话日结束后被批量拉取,这一限制会成为处理大量会议积压团队的实际约束。记录端点尤其吃重,因为它们会返回完整会话文本,因此分页和谨慎的节流对任何把会议情报同步到 CRM 或项目跟踪器的集成都很关键。

前置条件

需要:当前提供方限制、聚合基线、稳定的请求/事件 ID、合成测试数据,以及容量负责人。

使用方式

资料给出的操作要点包括:为会议、同步和后续跟进操作限定并发并保持幂等性;使用脱敏的聚合指标监控节流、队列积压时长、错误和重复操作风险;在出现瞬时限制时采用带抖动的退避,并在重放失败工作前先降低负载。输出为:一个具备有界重试、幂等性、脱敏监控和安全恢复责任归属的速率感知工作流。

速率限制参考

列表 meetings:60 请求 / 1 分钟 / 每用户。获取 transcript:60 请求 / 1 分钟 / 每用户。行动项:60 请求 / 1 分钟 / 每用户。会议摘要:60 请求 / 1 分钟 / 每用户。Webhook 管理:10 请求 / 1 分钟 / 每用户。

实现与策略

资料包含一个 FathomRateLimiter 类,实现 60 令牌的令牌桶式限流与队列等待;一个 fathomRetry 函数,在收到 429 时读取 Retry-After 头并加入随机抖动等待后重试,在收到 5xx 时按指数退避重试;以及一个 syncAllTranscripts 批量同步函数,按 batchSize(默认 10)分批并发拉取 transcript,并在批次之间等待 12 秒。

错误处理

资料列出常见问题与处理方式:429 Too Many Requests 表示超出每用户每分钟 60 次上限,应等待 Retry-After 后继续;transcript 为空表示会议仍在处理中,应以 30 秒间隔轮询直至就绪;刷新时出现 401 表示 OAuth 令牌过期,应在批次开始前轮换令牌;长会议超时表示音频时长超过 2 小时,应使用 Accept-Encoding: gzip 请求;行动项缺失表示 AI 提取尚未完成,应在延迟 5 分钟后重试。

适用场景

适合将 Fathom 会议记录、摘要与行动项批量同步到 CRM 或项目跟踪器的集成,以及需要处理大量会议积压、避免重复后续操作的团队。

限制与注意事项

资料强调,不得在未检查稳定 ID、同意状态和当前状态的情况下重试会议或 CRM 后续跟进操作。示例中的做法是在获批限制以下逐步增加合成开发负载,记录聚合的 429、延迟和完成情况,并在节流时应用退避。下一步可参见 fathom-performance-tuning。其余细节暂未提供。