Agent Harness 不只是 Tool Loop

更新于 2026-09-22

**「能调工具、能循环」只是 harness 的骨架，不是 harness。** 一个 Agent 服务如果只是「固定系统提示词 + 硬编码工具 + 框架提供的 Tool Loop」，那它只是 MVP —— 缺的是记忆、技能注册表、上下文工程和运行生命周期。

最小骨架 vs 完整 harness

调用 ToolLoopAgent 之类的现成 loop，说明循环本身不用自己写；但 harness 的其余部分不会因此出现。判断一个 Agent 服务成熟度时，逐项问上面右列 —— 缺的那一列才是真正的工作量。

另：写入类工具的安全边界（提案 → 用户确认 → 执行）是骨架里做对了的部分，应该保留而不是重写（见阻塞式工具与提案确认）。

它的定义就是 Agent = LLM + Tools + Loop：

用户消息 → 调模型 → 模型要调 tool？
                     是 → 执行 tool → 结果塞回消息 → 再调模型 …
                     否 → 输出最终 text，结束

停止条件（源码注释）：模型不再返回 tool-calls（正常结束）／tool 没有 execute（要外部接）／tool 需要 approval（needsApproval）／命中 stopWhen（默认约 20 步）。

它是一个 SDK 自带的 tool-calling 状态机，不是自研类、也不是 LangGraph / Mastra；业务库、鉴权、propose-confirm 都在它外面。旧名叫 Experimental_Agent，现已正名。

→ 这正是本节的主题：把「循环」外包出去，剩下的 harness（记忆、技能注册表、上下文工程、运行生命周期）一件都不会因此出现。