Agent Harness 的终点:从执行引擎走向 Quality Gate
把 Trace、Evidence、Failure Regression、Eval 收束到 Merge / Release Gate,让 Agent 的结果从“能运行”走向“可交付”。
Agent Harness 系列 #15
上一篇:Harness 和 Eval 平台到底是什么关系?
写到这里,Harness 已经不再只是:
Model + Tool Loop
它逐渐拥有:
- Policy;
- Trace;
- Evidence;
- Recovery;
- Failure Corpus;
- Regression;
- Eval。
那么最后一个问题是:
这些能力最终改变了什么?
如果答案只是:
Dashboard 更漂亮了。
还不够。
真正的终点应该是:
它能影响交付。
一、Quality Gate 是什么
Quality Gate 的本质非常简单:
Can this change move forward?
例如:
- 能不能 Merge;
- 能不能 Deploy;
- 能不能升级模型;
- 能不能发布新 Prompt;
- 能不能让 Agent 获得更高权限。
Gate 把 Reliability 从“观察”变成“约束”。
二、Gate 不应该只看最终 Pass
一个 Agent Run 可能:
Final Result = PASS
但同时:
critical evidence missing
high-risk tool unverified
known regression failed
forbidden action attempted
这种结果不应该进入下一阶段。
所以 Gate 条件至少要同时看:
Outcome
Evidence
Process Risk
Regression
Policy
三、一个最小 Gate Contract
例如代码变更:
gate: code-agent-merge
required:
outcome: success
evidence_complete: true
tests_passed: true
critical_regression_passed: true
unresolved_p1_failure: false
policy_violation: false
on_fail:
action: block_merge
这里最关键的是:
Gate 输入全部来自可追溯事实。
不是让 Agent 最后再回答一句:
我认为可以合并。
四、Hard Gate 和 Soft Gate
不是所有信号都适合直接阻断。
Hard Gate
明确不可接受:
- Security violation;
- Data corruption;
- Critical Regression;
- Missing mandatory Evidence;
- Unauthorized Tool;
- Required tests failed。
直接 BLOCK。
Soft Gate
需要人工判断:
- Retry Density 上升;
- Cost 显著增加;
- Trajectory 变长;
- Judge Score 轻微下降。
可以:
WARN
REVIEW
OBSERVE
不要一开始就把所有指标变成硬门禁,否则误报会迅速消耗团队信任。
五、Gate 最好至少有四种结果
不要只做 Pass / Fail。
建议:
ALLOW
BLOCK
REVIEW
INCONCLUSIVE
ALLOW
证据充分,规则满足。
BLOCK
命中明确不可接受条件。
REVIEW
高风险但需要人工判断。
INCONCLUSIVE
关键 Evidence 缺失,系统无法确认。
尤其是 INCONCLUSIVE 很重要。
不知道,不等于通过。
六、Gate 应该放在哪
对于 Coding Agent:
Change
↓
Agent
↓
Harness
↓
Verification
↓
Gate
↓
Merge
对于模型 / Prompt 升级:
New Version
↓
Regression Eval
↓
Gate
↓
Rollout
对于企业 Workflow:
Agent Result
↓
Evidence
↓
Gate
↓
Approval / Next Step
Gate 应该靠近真正的交付边界。
七、不要让 Gate 变成另一个 Judge
Gate 本身应该尽量简单。
它消费:
- deterministic checks;
- evaluator results;
- risk signals;
- policy results。
然后执行明确规则。
例如:
if security_violation:
return BLOCK
if mandatory_evidence_missing:
return INCONCLUSIVE
if critical_regression_failed:
return BLOCK
if risk_score > review_threshold:
return REVIEW
return ALLOW
复杂判断应该在前面的 Verification / Eval 层完成。
Gate 负责决策。
八、真正完整的闭环
现在把整个系列收回来:
Change
↓
Agent
↓
Harness
↓
Trace
↓
Evidence
↓
Verification
↓
Failure / Root Cause
↓
Regression
↓
Eval
↓
Quality Gate
↓
Merge / Release
其中:
- Harness 控制执行;
- Trace 保存事实;
- Evidence 证明结果;
- Failure 解释问题;
- Regression 防止复发;
- Eval 比较质量;
- Gate 决定交付。
这就是我理解的 AI Engineering Reliability 闭环。
九、Harness 为什么会走到这里
因为 Agent 越来越强以后,系统真正缺的不是:
再多一个能调用工具的 Agent。
而是:
谁来保证它的执行是可接受的。
所以 Harness 的演化方向很自然:
Agent Runner
↓
Execution Runtime
↓
Reliability Boundary
↓
Delivery Gate
这也是为什么我不把 Harness 只看成一个 Agent Framework 概念。
它最终会进入软件交付系统。
十、什么时候说明系统真的成熟了
我会看五个问题:
- 一次 Agent Run 能不能完整重建?
- 最终结果有没有独立 Evidence?
- 真实失败能不能自动进入 Regression?
- 新版本能不能证明没有重新引入旧 Failure?
- 高风险结果能不能自动阻断 Merge / Release?
如果这五个问题都能回答“可以”,Agent Reliability 才真正从理念变成工程能力。
结语
Agent Harness 的终点不是:
把 Loop 跑得更漂亮。
而是:
让 Agent 的执行可以进入真实交付体系。
从“模型说完成了”,走到:
执行受控
结果可验证
失败可定位
问题可回归
风险可阻断
这才是 Harness 真正值得长期建设的原因。
Agent Harness 系列
从基础概念到 Quality Gate,完整目录见:
继续阅读这个系列
Agent Harness:从入门到 Reliability →- Agent Harness 是什么?为什么它正在成为 Agent 工程的关键一层
- Agent、Framework、Workflow、Runtime、Harness 到底有什么区别?
- 2026 Agent Harness / Runtime 工具盘点:主流方案怎么选
- OpenAI Agents SDK 教程:安装、Tool、Session 与 Trace
- smolagents 教程:用 CodeAgent 跑通一个 Agent Loop
- 手写 Agent Harness:用 Python 实现 Loop、Tool、Policy 与 Trace
- 一个 Agent Loop 到底是怎么跑起来的?
- Agent 为什么需要 Harness:模型负责决策,系统负责约束
- Harness 到底应该管什么?从 Agent Loop 到 Reliability Boundary
- Trace 不是日志:Harness 应该记录哪些执行证据?
- Agent 调错工具怎么办:Timeout、Retry、Budget 与 Side Effect
- 结果正确就够了吗?给 Agent 设计 Evidence Contract
- 一次 Agent 失败,怎么变成一条 Regression Case?
- Harness 和 Eval 平台到底是什么关系?
- Agent Harness 的终点:从执行引擎走向 Quality Gate · 当前篇
- 让 Agent 下班后继续跑:有界自主运行怎么设计?
沿着问题继续探索
从执行机制走向验证与交付。