Wykrywanie pętli narzędzi

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

1. Wykrywanie pętli (tools.loopDetection.enabled) — domyślnie wyłączone. Obserwuje kroczącą historię wywołań narzędzi pod kątem powtarzających się wzorców i ponowień dla nieznanych narzędzi.
2. Strażnik po Compaction (tools.loopDetection.postCompactionGuard) — domyślnie włączony, chyba że tools.loopDetection.enabled jest jawnie ustawione na false. Uzbraja się po każdej próbie ponowienia po Compaction i przerywa uruchomienie, gdy agent wyemituje tę samą trójkę (tool, args, result) w ramach okna.

​

Dlaczego to istnieje

• Wykrywanie powtarzalnych sekwencji, które nie robią postępu.
• Wykrywanie częstych pętli bez wyniku (to samo narzędzie, te same dane wejściowe, powtarzające się błędy).
• Wykrywanie konkretnych wzorców powtarzanych wywołań dla znanych narzędzi odpytujących.
• Zapobieganie cyklom przepełnienie kontekstu, następnie Compaction, następnie ta sama pętla, które działałyby bez końca.

​

Blok konfiguracji

{
  tools: {
    loopDetection: {
      enabled: false, // master switch for the rolling-history detectors
      historySize: 30,
      warningThreshold: 10,
      criticalThreshold: 20,
      unknownToolThreshold: 10,
      globalCircuitBreakerThreshold: 30,
      detectors: {
        genericRepeat: true,
        knownPollNoProgress: true,
        pingPong: true,
      },
      postCompactionGuard: {
        windowSize: 3, // armed after compaction-retry; runs unless enabled is explicitly false
      },
    },
  },
}

{
  agents: {
    list: [
      {
        id: "safe-runner",
        tools: {
          loopDetection: {
            enabled: true,
            warningThreshold: 8,
            criticalThreshold: 16,
          },
        },
      },
    ],
  },
}

​

Zachowanie pól

​

Zalecana konfiguracja

• Dla mniejszych modeli ustaw enabled: true i pozostaw progi z wartościami domyślnymi. Modele flagowe rzadko potrzebują wykrywania na podstawie kroczącej historii i mogą pozostawić przełącznik główny na false, nadal korzystając ze strażnika po Compaction.
• Utrzymuj progi w kolejności warningThreshold < criticalThreshold < globalCircuitBreakerThreshold.
• Jeśli występują fałszywe alarmy:
  • Zwiększ warningThreshold i/lub criticalThreshold.
  • Opcjonalnie zwiększ globalCircuitBreakerThreshold.
  • Wyłącz tylko konkretny detektor powodujący problemy (detectors.<name>: false).
  • Zmniejsz historySize, aby kontekst historyczny był mniej rygorystyczny.
• Aby wyłączyć wszystko (w tym strażnika po Compaction), jawnie ustaw tools.loopDetection.enabled: false.

​

Strażnik po Compaction

{
  tools: {
    loopDetection: {
      // master switch; set false to disable the guard along with the rolling detectors
      enabled: true,
      postCompactionGuard: {
        windowSize: 3, // default
      },
    },
  },
}

• Niższe windowSize jest bardziej rygorystyczne (mniej prób przed przerwaniem).
• Wyższe windowSize daje agentowi więcej prób odzyskania działania.
• Strażnik nigdy nie przerywa, gdy wyniki się zmieniają, tylko gdy wyniki są bajtowo identyczne w całym oknie.
• Jest celowo wąski: uruchamia się tylko bezpośrednio po próbie ponowienia po Compaction.

​

Dzienniki i oczekiwane zachowanie

• Ostrzeżenia pojawiają się najpierw.
• Tłumienie następuje, gdy wzorce utrzymują się po przekroczeniu progu ostrzeżeń.
• Progi krytyczne blokują następny cykl narzędzi i ujawniają jasny powód wykrycia pętli w rekordzie uruchomienia.
• Strażnik po Compaction emituje błędy compaction_loop_persisted z nazwą narzędzia powodującego problem i liczbą identycznych wywołań.

​

Powiązane