沙盒的额度由两个变量决定:活跃实例总上限与单团队上限。前者管整个部署的天花板,后者管单个团队能占多少。只设其中一个,另一侧就会成为意外瓶颈。
两个额度的作用范围
AGENT_SANDBOX_MAX 是活跃实例总上限,默认 100,应用会话与技能编辑共用这一份。AGENT_SANDBOX_MAX_PER_TEAM 是单团队上限,默认不限。商业版以管理台配置优先于环境变量。两个额度同时生效时,实际可用量取两者中更紧的那个。总上限是部署级参数,改一次影响全部团队,不适合按团队频繁调整;需要按团队区分时用团队额度,总上限只在物理容量变化时动。
配比矩阵
| 方案 | 适用条件 | 风险 |
|---|---|---|
| 只设总上限 | 团队数量少、互相信任、峰值可预测 | 单个团队能占满全部实例,其他人排队 |
| 总上限加团队上限 | 多团队共用一套部署 | 两个值要一起调,单改一处会互相卡住 |
| 只设团队上限 | 团队数量固定且总和小于物理容量 | 总量失去保护,团队数增加后超配 |
第二种是多数场景的默认选择。配比时按峰值计算,不用均值:把各团队同时运行的实例数相加,再加一部分余量作为总上限;团队上限按单团队历史峰值上浮。两个值都写进变更记录,避免只记得改了一个。
优先级与切换代价
商业版的管理台配置优先于环境变量。改环境变量之前先确认管理台里没有同一项的改动,否则重启之后取值会回退,实例数看起来“自己变回去了”。调整动作只影响新建或重建的实例,已运行的实例不受影响,所以调整后要重建一个实例验证,再用监控比对实际占用。
超卖倍率会改变调度时的资源预留:CPU 与内存的超卖倍率默认为 1,取值不低于 1,限 Kubernetes 运行态与 OpenSandbox Server 0.2.1 及以上版本,只影响新建或重建的实例,资源上限不变。倍率影响资源预留量,系统与团队实例上限仍由配额分别控制。
切换成本主要在验证环节:改完额度要复测实例创建失败时的返回信息,确认限制来自总额度还是团队额度;两者的报错文案接近,靠猜分不出来。
容量规划按三步走:先统计各团队历史峰值,再按峰值之和加余量定总上限,最后按单团队峰值上浮定团队上限。三步都做完再动超卖倍率,顺序反了会把额度问题当成调度问题,越调越乱。
数据来源
| Source | Version | Document |
|---|---|---|
| FastGPT | v4.17.3 | self-host/upgrading/4-17/4173 |
| FastGPT | v4.16.0 | self-host/upgrading/4-16/4160 |