用途:控制 AssemblyAI 账户容量,通过显式账户限额、队列和重试预算管理请求,并将数据、凭证、花费与重放决策分开治理。
主要能力:清点提交、轮询、回调、网关调用与流式并发;记录当前账户限额与观测到的响应头;按操作类别分配独立的有界资源池;优先使用回调而非激进轮询,并使用持久化准入队列;遵循 Retry-After 或带抖动的有上限指数退避;重试提交前核对 transcript ID,并在饱和时告警。
当前契约:AssemblyAI 文档说明每五分钟 20,000 次 API 请求,另有按操作区分的并发限制。限制作用于账户级别,项目密钥只是镜像容量而非叠加。实际并发与自动扩缩因账户而异,应以当前仪表盘和文档为准。
认证:实际调用时从批准的密钥管理器注入 ASSEMBLYAI_API_KEY,仅在发往配置的第一方主机的 Authorization 头中发送原始值。切勿打印、提交、放入 URL 或暴露给不可信客户端。回调密钥与临时流式令牌是独立凭证。
工具纪律:使用 Read、Glob、Grep 检查仓库代码、配置、夹具与证据;仅在获批的实现或文档变更中使用 Write 和 Edit。不得仅因调用本技能就调用 AssemblyAI、上传音频、开启流式会话、铸造令牌、重放回调、部署、轮换密钥或删除 transcript。
审批边界:实时音频处理、生产凭证或端点变更、付费模型或容量变更、内容保留、回调重放、部署或删除,均需有责任负责人批准。只读仓库检查与合成离线验证不授权实时厂商操作。
失败模式:更多密钥不会带来更多账户容量;认证与校验失败不可重试;无界轮询会放大故障并与提交竞争。
输出:返回操作范围、环境、区域、契约面、授权类别、模型与功能决策、确定性验证结果、无内容标识符、风险、清理或回滚状态,以及简洁的通过/失败回执。排除凭证、签名 URL、音频、transcript 文本、提示词和客户衍生内容。
验证:重跑最小相关确定性检查,将实际状态与请求结果及当前第一方契约比对,确认证据中不含敏感字段,并在报告成功前确认回滚、终止或删除状态。