OpenRouter四层防护 拦截Agent无限循环
OpenRouter 官方教程《How to Stop an AI Agent Stuck in an Infinite Loop》于2026年11月12日发布,用可复现实验拆解 AI Agent 因工具反复失败而陷入无限循环的成因,给出四层防护与实测成本对比,属于可直接迁移到自有自动化脚本的完整工作流教程。
成因:每轮重发完整对话
原文指出,Agent 循环只在模型不再请求工具、直接给出最终回答时结束;当工具持续失败而系统指令仍要求完成任务,模型会把「再试一次」判断为合理下一步。默认循环没有重试计数器,且每轮重发完整 conversation,输入 token 与单轮成本逐轮放大——文中一次运行里 input 从131 tokens 增至3262 tokens,单轮成本接近原来的4倍。复现实验中一个固定抛错的 fetch_invoice 工具触发41次完全相同的调用,最终靠 stepCountIs(40) 才结束。
四层防护
① doom-loop detection:在 callModel 开启 doomLoop,按工具名+归一化参数做指纹,默认第3次重复被 block、第6次结束运行;② loopKey:把 invoice_id 归一化为纯数字,防止模型改大小写、加空格或前缀绕过指纹;③ stopWhen caps:同时设 stepCountIs、maxCost 与连续失败计数,给单次运行兜底;④ API key credit limit / workspace budget:在 OpenRouter 服务端设置 limit 与 limit_reset,即使代码有 bug 或漏配防护也能封顶总花费。原文强调前三层只覆盖单次运行,第四层在服务端执行,应作为最后一道。
实测数据
在6个模型各跑3次、共18组运行中,开启检测后16组在2次真实工具调用后结束;汇总口径为工具调用数从314降至64、花费从0.29美元降至0.05美元。无检测的18组中有4组一直重试到40步上限。同一输入下 Grok 4.7 三次分别调用41、12、41次,说明循环具有随机性,一次干净测试不能证明 agent 不会循环。
落地提示:无人值守的报表、批处理类 Agent 应至少同时配置单次成本上限与服务端 key 额度。文中「整夜跑掉数千美元」是风险描述而非本次实测值,workspace budget 的403示例也明确来自文档、未在实验中触发,引用时不宜当作实测结论。
内容为 AI 聚合整理,完整信息以官方发布为准。