NOTEEngineering2026年8月11日3 分钟阅读

好工具需要可行动的错误

错误信息应告诉 Agent 下一步怎么改,而不只是宣告失败。

很多 Agent 项目把注意力集中在模型选择和提示词上,但真正塑造它工作方式的,往往是模型之外的那层系统:它提供哪些工具、保留哪些上下文、何时停止,以及失败后怎样继续。

可以把这层系统称为 Agent Harness。它不是一个单独的框架,而是一组决定 Agent 行为边界的工程选择。模型升级可能提高上限,Harness 的清晰度则决定日常表现是否稳定。

如果一次失败无法被定位到输入、状态、工具或策略中的某一层,Harness 的边界还不够清楚。

下一次调试 Agent 时,先不要改 prompt。先问:它当时看见了什么、允许做什么、系统记录了什么。这三个问题通常更接近原因。