Harness 核心 · Agent 工程概念

脚手架工程：从试验品到产品

定义

Agent Harness（脚手架）是把模型、工具和环境组织成可运行系统的工程层。它负责工具契约、状态持久化、权限、错误处理和可观测性，使一次演示能重复执行并定位失败。

说明

裸模型只能提出工具调用；Harness 要负责校验参数、执行工具、记录结果、控制并发与超时，并把可恢复失败反馈给模型。

状态层保存会话、任务进度和检查点，权限层限制模型能做什么，可观测层记录调用、用量和失败原因。不同产品会组合不同机制，但这些职责必须有明确归属。

Harness 与运行护栏的边界是：本词条回答系统由哪些工程层组成；“运行护栏”词条专门说明步数、时间、输出和上下文预算如何终止失控循环。

边界与误区

为什么说 Agent 工程大部分是脚手架： 因为 Agent 会在真实环境中调用外部工具、消耗 Token、执行长时间任务，工程层需要处理失败、超时、异常输入和状态恢复等问题。没有这些能力，模型能力再强也难以稳定交付。
检查点恢复和日志分别解决什么问题： 检查点恢复让任务失败后可以从最近完成的状态继续，而不是从头开始；日志用于追溯执行过程，便于排查生产问题和分析成本。