智能体子代理容量核验工作流

智能体子代理容量核验工作流

3个实用技能 · 3步完成 · 每一步都能单独使用

把混合模型编排中的“子代理真实上下文窗口小于协调器继承的压缩阈值”变成可复核证据：先整理每个模型与容量合同，再审计阈值可达性和安全余量，最后生成等待负责人决定的发布闸门。套餐只处理脱敏 JSON，不连接模型、网关、队列或部署系统。

3个可下载技能 · 每个技能可单独运行

3步自动化工作流

🔵 1 智能体子代理容量合同整理

技能文件：agent-subagent-capacity-normalizer

解决什么： 协调器、子代理和兼容网关的模型身份、上下文上限与压缩阈值可能分散在不同配置中，继承关系不透明。

What you get: READY/REVIEW、每个子代理的真实容量、有效压缩阈值、阈值继承标记、字段缺口和 capacity_contract_hash。

↓ 本步结果自动进入下一步

🟢 2 智能体上下文阈值错配审计

技能文件：agent-context-threshold-mismatch-auditor

解决什么： 当压缩阈值高于子代理可承受的上下文窗口，或安全余量不足时，子代理可能先撞上限而不是先压缩，导致任务整体失败。

What you get: PASS/REVIEW/BLOCKED、错配类型、受影响 agent_ref、模型身份缺口、launch_allowed=false 和 capacity_mismatch_hash。

↓ 本步结果自动进入下一步

🟠 3 智能体子代理容量发布闸门

技能文件：agent-subagent-capacity-release-gate

解决什么： 静态审计通过不等于可以立即改模型、调整阈值或启动新的子代理；负责人还需要检查部署范围和可复现证据。

What you get: READY_FOR_HUMAN_CAPACITY_REVIEW/HOLD、human_decision=PENDING、agent_spawn_execute=false、capacity_change_execute=false、deployment_execute=false 和 capacity_release_gate_hash；这是最终交付。

实际示例

脱敏样例包含一个 1,000,000 token 协调器、一个 372,000 token 子代理和一个 800,000 token 子代理。第一步标记研究子代理继承了协调器 900,000 的阈值；第二步识别阈值高于子代理容量且余量不足，输出 BLOCKED；第三步输出待人工复核包。示例只验证离线字段和分支，不代表任何真实模型、网关或部署结果。

适合谁

• 运行混合模型、多级子代理或第三方兼容网关的 Agent 工程团队

• 需要在上线前核对 coordinator/worker 上下文窗口与 compaction 阈值的平台团队

• 负责长任务失败、模型路由、重试成本和生产稳定性的 QA 人员

• 在修改模型、阈值或子代理配置前需要保留可复现证据的服务商

买家只需提供

• 脱敏 coordinator、subagents、model_ref 和 gateway_ref

• 每个模型的 context_window_tokens、compaction_threshold_tokens 和是否显式指定模型

• 余量策略、是否允许继承阈值、负责人、部署引用和复现记录引用

• 不提供 API key、Cookie、原始提示词、客户数据、真实请求内容或可执行部署凭据

使用方式

1. 使用 Python 3.10 或更高版本，把容量与策略摘要写成 UTF-8 JSON；模型名、网关和引用应使用脱敏值。

2. 依次运行容量合同整理、阈值错配审计和人工发布闸门，也可以单独运行任一步。

3. 由有权限的负责人在测试环境确认模型路由、压缩策略、上下文窗口和部署方式；套餐不会改配置、启动 Agent 或调用网关。

交付与验收

• 三个独立技能目录，每个包含元数据、技能说明、标准库 Python 执行器、文档和脱敏样例。

• 三步可重复运行：容量合同、阈值错配审计、人工发布闸门；每个技能也能单独使用。

• 缺模型、容量、阈值、余量或人工引用时输出明确 REVIEW/BLOCKED/HOLD 分支；阈值高于子代理容量时不得输出放行。

• 正常合同和完整人工资料输出 READY_FOR_HUMAN_CAPACITY_REVIEW；任何分支都保留 human_decision=PENDING 与所有外部动作 false 标记。

服务说明

脚本只处理买家有权使用且已经脱敏的本地 JSON，不连接模型、网关、Agent、队列、CI、网络或数据库，不读取凭据，不执行模型切换、阈值修改、子代理启动或部署。静态容量检查不能证明服务端真实上限、网关行为、SDK版本兼容或运行时成本；最终结论必须由买家在适用环境中复核。套餐不包含模型目录、API额度、网关接入、生产部署、持续监控或故障值守。