AI Agent / 系统课时

执行构建验证

执行构建验证

本课解决智能体修改代码后无法判断结果是否可靠的问题。通过自动执行编译、构建或测试命令,智能体能够获得真实工程反馈,发现语法错误、依赖问题和运行约束,并形成修改后的验证闭环。

学习目标

  • 理解构建验证在智能体执行流程中的作用
  • 掌握调用项目验证命令的方法
  • 学会根据构建结果调整后续动作

构建验证的核心价值

代码修改只是智能体执行任务的一部分,验证结果才决定修改是否有效。构建过程会将隐藏问题暴露出来,例如类型错误、依赖缺失、配置错误或测试失败。

一个完整闭环通常包含:

  1. 分析需求
  2. 修改代码
  3. 执行验证命令
  4. 解析反馈
  5. 根据结果继续修复或结束任务

选择正确验证命令

不同项目的验证入口不同,智能体需要使用上一阶段识别出的命令。

例如 Node.js 项目可能使用:

bash
npm run build

预期输出

text
vite build completed
build succeeded

实际日志内容可能因项目配置不同而变化。

Java 项目可能使用:

bash
mvn test

预期输出

text
Tests run: <COUNT>, Failures: 0
BUILD SUCCESS

其中 <COUNT> 表示实际测试数量。

收集并理解反馈

智能体执行命令后,不应只判断成功或失败,还需要提取关键上下文。

有效反馈包括:

  • 错误文件路径
  • 行号信息
  • 错误类型
  • 失败测试名称
  • 构建阶段

例如编译失败时,应定位具体错误,而不是重复执行相同命令。

python
import subprocess

result = subprocess.run(
    ["npm", "run", "build"],
    capture_output=True,
    text=True
)

if result.returncode == 0:
    print("验证通过")
else:
    print(result.stderr)

预期输出

text
验证通过

如果失败,则输出实际构建错误信息。

失败处理策略

构建失败后,智能体需要区分问题类型。

失败类型 处理方式
语法错误 修改代码后重新验证
依赖缺失 检查安装配置
环境变量缺少 补充运行环境
测试失败 分析业务逻辑

不要无限循环执行构建。每次失败都应该产生新的分析结果,否则会浪费执行资源。

建立安全验证边界

自动执行命令需要控制风险。开发环境中的构建和测试通常安全,但发布、迁移数据库或删除操作需要额外确认。

智能体可以将命令分级:

  • 只读检查:直接执行
  • 本地验证:默认执行
  • 修改环境:需要确认
  • 生产操作:必须人工授权

本课总结

  • 构建验证让智能体获得真实工程反馈,是执行闭环的重要环节。
  • 验证结果不仅判断成功失败,还需要解析错误上下文。
  • 高风险命令必须设置确认机制,避免自动化扩大影响范围。

下一课预告

下一课将继续学习如何根据执行反馈调整智能体行为,让任务规划、工具调用和结果判断形成更稳定的自动化循环。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行构建验证

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通