AI Agent / 系统课时
验证任务完成条件
验证任务完成条件
智能体执行任务后不能仅凭一次成功响应宣布完成。本课介绍如何建立多条件验收机制,让 Agent 同时检查代码变化、构建状态、测试结果和用户目标,减少遗漏和误判。
学习目标
- 理解智能体为什么需要显式完成条件。
- 设计包含代码、验证和目标确认的验收规则。
- 实现任务结束前的自动检查流程。
为什么不能依赖模型判断完成
大型代码任务通常包含多个隐含要求,例如修改文件、保持编译通过、通过测试以及满足用户描述。如果只检查模型是否返回了一段解释,可能出现代码未保存、测试未执行或需求遗漏等情况。
完成状态应该来自可验证事实,而不是模型主观判断。Agent 需要把任务目标转换为多个验收条件,并在全部满足后进入完成状态。

设计完成条件模型
一个实用的完成条件通常包含多个布尔检查项。每个检查项都需要有明确的数据来源,例如 Git diff 判断代码变化,构建命令判断编译状态,测试结果判断行为正确性。
yaml
completionRules:
codeChanged: true
buildPassed: true
testsPassed: true
requirementChecked: true预期结果
text
所有条件均为 true 时,任务状态可以进入 completed。条件设计时应避免过度简单。例如“代码修改完成”并不代表“任务完成”,因为修改后的代码可能无法运行,也可能没有覆盖用户真正提出的问题。
实现验收检查流程
Agent Runtime 可以在执行循环结束阶段调用验证器,由验证器读取工具执行记录并生成最终判断。
ts
interface CompletionResult {
completed: boolean;
failedChecks: string[];
}
function validateCompletion(checks: Record<string, boolean>): CompletionResult {
const failedChecks = Object.entries(checks)
.filter(([, passed]) => !passed)
.map(([name]) => name);
return {
completed: failedChecks.length === 0,
failedChecks,
};
}
const result = validateCompletion({
codeChanged: true,
buildPassed: true,
testsPassed: false,
});预期输出
text
{
completed: false,
failedChecks: ["testsPassed"]
}这种设计让 Agent 能明确知道失败原因,并继续执行修复流程,而不是直接结束任务。
避免错误完成状态
常见问题包括只检查模型输出、不检查运行结果、忽略用户未明确表达但实际存在的验收要求。生产环境中的智能体应该保守判断:无法证明完成时,保持处理中状态并要求进一步验证。
完成条件也需要根据任务类型调整。代码重构关注测试和兼容性,文档生成关注结构和内容完整性,部署任务则需要关注服务状态和健康检查。
验证机制的核心不是增加更多检查,而是让每个检查都对应一个真实风险。只有可观察、可验证的条件,才能支撑可靠的自动化执行。
按自己的节奏,确认真正理解。