AI 简明手册
Agent 工程:从能跑到可控 · 让任务跨轮次继续为什么 Agent 跑不了长任务

为什么 Agent 跑不了长任务

定义

长任务常见两类故障:一次尝试铺得太开,后半程被上下文压力拖住;或者只跑通局部路径,就把任务误判为完成。本页先教你识别这两种故障,持久交接的一种具体实现见下一词条“双角色 Harness”。

先搭一个心智模型

长任务更像接力赛而不是一次冲刺。每一棒都要留下“目标、已完成、证据、下一步和恢复入口”,否则下一轮只能重新猜路线。

说明

高层目标往往包含许多可独立验收的功能。若一次尝试同时展开,工具输出、中间决策和未完成分支会不断占用上下文,后续步骤只能从残缺线索猜测。

另一种失败是把“核心路径能跑”误认为全部完成。没有逐项验收时,遗漏的边界条件、回归测试和清理工作不会自动暴露。

判断是否遇到长任务故障,可以看三个信号:开始重复读取同一信息、无法说明哪些验收项仍未完成、换一个上下文后只能重新摸索。出现这些信号后,再进入下一篇设计持久交接。

跟着一个例子走

一次重构为什么越做越慢

任务包括盘点依赖、修改代码、迁移数据和运行回归测试,Agent 已经工作很久,却说不清剩余范围。

  1. 识别上下文过载

    同一文件被反复读取,早期决定找不到依据,新步骤不断覆盖旧步骤。

  2. 识别过早完成

    主路径能运行,但迁移检查、失败用例和回归结果没有逐项证据。

  3. 把问题转成交接设计

    此时不应继续堆提示,而应转到下一词条“双角色 Harness”,建立可恢复的目标、状态和验证记录。

回到概念

先分清是上下文过载还是验收缺失,再设计交接;两类故障的症状不同,不能只靠“再试一次”解决。

边界与误区

  • 为什么 one-shot 容易让长任务失败: 任务越大,中间状态和验证证据越多,单个上下文越难同时保持全局目标与当前细节。回答更长并不会消除这个容量与注意力问题。

  • 怎样区分“任务真的完成”和“Agent 过早收尾”: 回到可检查的验收项逐条核对,而不是看模型是否给出了完成声明。缺少测试结果、产物或边界条件证据,就仍是未验证状态。

来源与核验

  1. [anthropic-long-running-harnesses] Anthropic:Effective harnesses for long-running agents

核验日期:2026-08-31