跳到正文

Agent 运行框架工程

Harness Engineering

高级通用

Agent 运行框架工程(Harness Engineering)是围绕 AI Agent 配置工具、权限、运行状态和验证流程的工程工作。它解决 Agent 改代码时可能越权、丢失进度或未经测试就交付的问题。

你可能会说:「让 AI 自动改代码时,工具权限、失败重试和测试验收能有固定安排。」

读之前建议先了解(这是一个高级概念)

动手看看

领取任务运行配置修复助手准备修复运行框架限定权限代码工作区尚未修改测试验证尚未验证
1

助手接到优惠券计算错误的修复任务。框架装载工具清单、可修改目录和已有进度,让它知道能做什么、做到哪了。

要点

  1. 1

    把任务放进可控的运行环境

    你让 Agent 改网站时,可以给它独立的工作目录,限定可访问的文件和可执行的命令。因为模型会临时选择动作,先划好运行边界,它就不会在修页面时碰到生产数据。

  2. 2

    让工具调用有边界和反馈

    工具不只是接上就行。比如执行命令要有超时,写文件后要能查看差异,危险操作要等你确认。这样 Agent 才能根据真实返回结果继续,而不是把“命令已发出”当成“任务已完成”。

  3. 3

    把任务进度留在模型之外

    一次任务可能跨多轮对话,你可以在外部记录目标、已改文件、测试结果和待解决问题。因为对话上下文可能被截断,这些记录能帮 Agent 接着做,也方便你回看它为什么这么改。

  4. 4

    用检查结果决定是否交付

    让 Agent 交付前执行构建和相关测试,把失败信息交回给它修复;仍然失败就停下并报告。重点不是让模型口头保证正确,而是用可重复的检查判断这次修改能否交付。

容易混淆的地方

它不是某个现成的 Agent 框架库:库可以提供调用接口,运行框架工程还要决定在你的项目里怎么隔离、记录、验证和收尾。它也不等于提示词工程:提示词告诉模型怎么做,外部运行机制决定它实际能做什么,以及失败时如何处理。

什么时候用

适合用

  • 你做一个自动修复网站缺陷的 Agent,需要限制它能改的文件,并让它在交付前运行测试。
  • 你让 Agent 连续处理后台工单,希望它中断后能恢复进度,并留下每次工具操作的记录。
  • 你在团队中开放 AI 改代码功能,需要对执行命令、人工确认和交付检查采用一致的流程。

不适合用

  • 只想让 AI 润色一段首页文案,没有工具执行或持续任务,用普通对话加人工审稿更直接。
  • 网站只需要按固定规则发送表单确认邮件,不需要模型自主选择动作,用普通后端流程即可。
  • 眼下只是想判断某项功能值不值得做,还没确定任务和验收方式,先做产品发现比搭 Agent 运行环境合适。

练一练

团队想让 Agent 自动修复网站的小缺陷。它已经会读写文件和执行命令,但偶尔改到无关目录,测试失败后也会直接报告完成。下一步最贴近运行框架工程的是?

让 AI 帮你做

请为这个自动修复网站缺陷的 Agent 设计运行框架:限定可访问目录和命令,记录任务进度与文件差异,设置命令超时;交付前运行相关测试,失败时提供结果供修复,仍失败则停止并报告。先说明方案,再修改代码。

接下来学什么