并发控制
运行时会在请求到达提供方之前应用统一的并发门控。当多项能力或路由共用同一个上游限制时,一条规则就可以同时覆盖它们。
规则
每条规则包含最大并发数 max、为前台任务保留的名额 reserve,以及匹配的语言模型路由和能力。
一次调用可以同时匹配多条规则。只有所有规则都有容量时才会开始;等待期间不会占用任何名额。未匹配规则的调用立即执行。
前台任务优先于后台任务,同一优先级内按先进先出调度。后台任务最多使用 max - reserve 个名额,前台任务可以使用完整上限。
例如,max: 4、reserve: 1 的规则最多允许三个后台调用同时运行。第四个后台调用会等待,为交互式请求保留一个名额。如果已经有四个前台调用在运行,保留名额不会凭空产生第五个位置。
每条规则都应对应一个真实的共享瓶颈。账户限制可能横跨多项能力,由 GPU 支持的本地路由则可能需要单独规则。请求必须同时满足所有匹配规则,因此可以用重叠规则表达两种限制,而不必把调度逻辑放进使用方。
时间限制
maxWaitSeconds 限制排队时间。超时会以 unavailable 类别的 AiError 拒绝调用。默认值为 1,800 秒;零表示不限制。
maxHoldSeconds 防止某个调用永不释放名额。超时后门控会释放其计数并记录警告,但不保证底层厂商请求已经中止。配置档案中的默认值为 1,800 秒;当前设置表单尚未公开此选项。
流式语言模型和 TTS 调用会一直占用名额,直到流结束、出错、取消或被丢弃。文件转录受门控管理;实时流式转录使用独立的长连接会话接口。
嵌入优化
嵌入请求可以去重和合批。内容相同的待处理请求共享工作;预取结果也可短暂保留,供随后的前台调用复用。缓存键包含提供方、模型和请求选项,因此不会跨配置混用结果。
设置页面会显示每条规则的活动调用数、队列长度、最长等待时间和运行中的调用。
运维建议
- 从实测的提供方或硬件限制开始,不必为每项服务都添加规则。
- 仅在后台工作可能延迟交互时预留容量。
- 根据调用方的有效生命周期设置
maxWaitSeconds;页面已离开后才返回的结果仍是浪费。 - 将
maxHoldSeconds视为计数保护,而不是请求取消。使用方仍应传入AbortSignal。 - 队列增长时,先检查运行中调用再提高
max:瓶颈可能是未消费的流或提供方变慢。