SuperAPI AI 工具集

persona-rate-limits

通用与其它

查看项目

更新于 10-15 23:28

技能介绍

用途:分析和控制 Persona 的请求速率与产品配额,用实时的环境限额和产品专属配额信号替代固定的限流表。生产环境文档默认每分钟 300 次,但实际以 Dashboard 配置和响应头为准。

主要能力:按读取、幂等 POST、会话操作、对账、消耗产品配额的校验工作分类并分配独立工作通道;读取 RateLimit-Limit、RateLimit-Remaining、RateLimit-Reset、Quota-Limit、Quota-Remaining、Quota-Reset 等实时信号;按环境和受限产品做低于边界的预算;在 429 时按重置或重试指引退避;保护写操作并支持配额耗尽的升级处理。

使用方式:先准备端点与操作清单、预期量、当前环境限额与产品配额、持久化的操作与重试状态。分类后按令牌桶分配预算;剩余不足 15% 时建议限流;无更具体指引时使用 5、10、20、40 秒的指数退避并加抖动和有限预算;POST 使用 Idempotency-Key 并持久化相同参数,超时或限流后先对账再重试;配额耗尽只暂停受影响通道。速率控制工作器使用与环境作用域一致且带日期的鉴权方式,遥测只记录头部值,不记录密钥或 PII。

限制:不要假设每个端点返回相同头值;无明确操作批准前不得创建、恢复、批准、拒绝、轮换、撤销、部署或改动生产资源;一次成功请求不等于身份决策成功。缺失信息暂未提供。