逐日AI微信小程序
21 天手搓一个 Coding Agent
第 1 周 · D6🔒 锁定约 4 小时

错误处理与自纠:失败回灌、退避重试、死循环检测与取消中断

把六类真实故障一次处理干净:工具失败、参数非法、网关限流、命令超时、流中断、模型打转。原则只有一条——能让模型自己改的错误就回灌给它,不能的才向用户抬头,并且任何时候用户都能按下取消。

今日目标 0/3

登录后可以勾选并保存进度。

今日目标

  1. 能把 Agent 运行时的错误分成回灌自纠、重试退避、直接抬头三类,并说清判据
  2. 能实现带抖动的退避重试,并解释为什么工具失败不该重试整轮
  3. 能实现取消信号从按键一路传到子进程的完整链路,并检测出模型在打转

前五天我们零散地遇到过好几类失败,今天把它们放在一起处理一遍。读完回到页面顶部把三条目标勾掉。

小白版讲解

犯错之后怎么办:把错误原样告给他,比替他改更有效

新人第一次动手一定会撞墙:改了个文件,测试红了;敲了条命令,参数写错了。

带他的人有两种做法:替他改,或者把报错原样贴给他加一句「你看这行说的是缩进对不上」。前者当天效率高,但他下次还是不会。

Agent 这边更极端:你根本没有「替它改」这个选项。 你能改的是文件和命令,改不了它下一步想干什么——那只取决于它在上下文里读到了什么。所以处理 Agent 的错误只有一种手段:把错误变成它下一轮能读到的文字。 这件事叫工具结果回灌(tool result feedback),我们从第三天就在用,今天才把它当成一条纪律。

这条纪律有个反直觉的结论:工具的失败信息不是给人看的日志,而是给模型看的行为规范。 同一个失败写成两种文字,模型的行为完全不同:

TextText
写法一:edit_file failed: no match
写法二:在 src/calc.js 里找不到那段 old_string,没有改动任何内容。
        常见原因是缩进或换行不一致,或者文件已经被改过了——请先 read_file 再重试。

第一种,模型会原地把同样的调用再发一次(它以为是偶发抖动)。第二种,它会先去读文件。这两行字的差别就是「这个 Agent 能不能自己走出困境」的差别,而它不在模型里,在你写的那句话里。今天要做的,就是把这条纪律推广到六类故障上,并且承认它有边界。

登录并关联后阅读全文

请先登录网页,并在账户页关联微信小程序账号。关联后每天可免费阅读 1 篇;额外文章需在小程序看广告解锁。

小程序码

微信扫码打开「逐日AI」,进入相同课程和章节,选择看广告解锁,完成后刷新本页。

面试题库

  • Agent 运行时的错误怎么分类?哪些该回灌给模型让它自纠,哪些该直接报给用户?How do you classify errors at agent runtime? Which ones go back to the model to self-correct, and which surface to the user?
    国内高频海外高频基础#error-handling#agent-loop

    🔒 解锁本章后查看答题要点。

  • 重试与退避你会怎么实现?为什么要加抖动?哪些错误绝对不该重试?How would you implement retries and backoff? Why add jitter, and which errors must never be retried?
    国内高频海外高频进阶#retry#backoff

    🔒 解锁本章后查看答题要点。

  • 用户按下取消,你的取消信号要穿过哪几层才算真的停下来?When the user presses cancel, which layers must the cancellation signal reach before things have really stopped?
    国内高频海外高频深入#cancellation#subprocess

    🔒 解锁本章后查看答题要点。

评论