工具循环检测

1. 循环检测（enabled）- 默认禁用。监视滚动的 工具调用历史，查找重复模式和未知工具重试。
2. 压缩后护栏 - 只要 enabled 没有被显式设为 false 就会启用。每次压缩重试后都会武装，并在 代理在窗口内重复相同的（tool、args、result）三元组时中止运行。

​

这样设计的原因

• 检测没有进展的重复序列。
• 检测高频无结果循环（同一工具、相同输入、重复错误）。
• 检测已知轮询工具的特定重复调用模式。
• 打破上下文溢出 -> 压缩 -> 相同循环的循环，而不是让它们无限运行。

​

配置块

{
  tools: {
    loopDetection: {
      enabled: false, // rolling-history 检测器的总开关
    },
  },
}

{
  agents: {
    entries: {
      "safe-runner": {
        default: true,
        tools: {
          loopDetection: {
            enabled: true,
          },
        },
      },
    },
  },
}

​

字段行为

​

推荐设置

• 对于较小的模型，设置 enabled: true。旗舰模型通常不需要滚动历史检测，并且可以将主开关保持为 false，同时仍然受益于压缩后保护机制。
• 若要禁用所有功能，包括压缩后保护机制，请显式设置 tools.loopDetection.enabled: false。

​

压缩后护栏

{
  tools: {
    loopDetection: {
      // 主开关；设为 false 可连同滚动检测器一起禁用护栏
      enabled: true,
    },
  },
}

• 当结果仍在变化时，护栏绝不会中止；只有窗口内结果字节级完全相同才会触发它。
• 它只会在一次压缩重试后的紧接阶段启用，而不会在运行中的其他时刻启用。

​

日志和预期行为

• 警告会首先出现。
• 当某种模式持续超过警告阈值后，系统会进行阻止。
• 在嵌入式代理循环中，第一次严重循环会在该工具批次中的任何工具运行之前阻止整个工具批次。随后，模型还会使用其正常工具再获得一次响应机会。
• 在这次响应期间，模型可以直接回答、提出问题，或使用不同的工具或不同的参数继续操作。
• 同一运行中再次出现严重循环时，系统会阻止其整个工具批次并结束本次运行。新的用户运行会以全新的恢复额度开始。
• 压缩后的防护机制会发出 compaction_loop_persisted 错误，其中会标明触发问题的工具和相同调用的次数。

​

相关内容