...
Eroare n8n · Noduri AI: agent, model, memorie, parser

Agent stopped due to max iterations.

Pe scurt

Agentul a făcut mai mulți pași (apeluri de unelte) decât permite Max Iterations și s-a oprit înainte de răspuns. Mărește Max Iterations dacă sarcina chiar cere mai mulți pași, sau clarifică promptul și descrierile uneltelor ca agentul să nu se învârtă în cerc.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un AI Agent lucrează în bucle: modelul decide ce unealtă să cheme, primește rezultatul, decide din nou, până dă răspunsul final. Fiecare buclă e o iterație. Ca să nu ruleze la nesfârșit (și să nu consume tokeni fără limită), n8n oprește agentul după Max Iterations (implicit 10) cu Agent stopped due to max iterations.

Două situații diferite: sarcina chiar are nevoie de mulți pași (de exemplu verificarea a 5 produse, câte un apel pe produs), iar limita e prea mică; sau agentul se învârte în cerc, pentru că o unealtă dă erori, descrierea ei e neclară sau promptul nu spune când să se oprească.

În primul caz mărești limita; în al doilea, citește pașii agentului (Logs) și repară unealta sau instrucțiunile. Mărirea limitei nu rezolvă o buclă, doar o face mai scumpă.

De ce apare: cauzele frecvente

1Limită prea mică

Greșit
JSON
Max Iterations: 2, agentul trebuie să calculeze 3 lucruri
Corect
JSON
Max Iterations: 10

Fiecare apel de unealtă consumă o iterație.

2Unealtă care dă eroare

Greșit
JSON
Agentul cheamă de 10 ori o unealtă HTTP care răspunde 404
Corect
JSON
Repară URL-ul uneltei; agentul primește rezultatul din prima

Agentul reîncearcă la nesfârșit când nu primește ce caută.

3Descriere neclară

Greșit
JSON
Tool description: „unealtă”
Corect
JSON
Tool description: „Află prețul unui produs după id”

Modelul alege uneltele după descriere.

Repară tu

Repară eroarea, direct în pagină

AI Agent calculează oferta pentru o firmă cu unealta Calculator (3 calcule), dar are Max Iterations = 2 și se oprește cu „Agent stopped due to max iterations”. Setează Max Iterations la 10 și rulează: agentul trebuie să dea totalul ofertei, 12145.5 lei.

Indiciu

Max Iterations e în Options ale nodului AI Agent.

Alte forme ale mesajului

  • Agent stopped due to iteration limit or time limit.
  • Agent stopped due to max iterations.

Cum o eviți pe viitor

  • Scrie descrieri clare pentru fiecare unealtă.
  • Spune în System Message când să se oprească și ce să facă dacă nu găsește informația.
  • Urmărește în Logs câți pași face agentul la cererile obișnuite și pune limita puțin peste.

Întrebări frecvente

Cât ar trebui să fie Max Iterations?

Cât îi trebuie unei cereri obișnuite plus o marjă. Pentru agenți simpli, 5–10.

Pot vedea pașii agentului?

Da: în output, cu opțiunea Return Intermediate Steps, sau în panoul Logs al execuției.

Erori înrudite

← Toate erorile n8n

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață n8n de la zero, cu exerciții la fiecare lecție

Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.