Agent stopped due to max iterations.
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ă
Max Iterations: 2, agentul trebuie să calculeze 3 lucruriMax Iterations: 10Fiecare apel de unealtă consumă o iterație.
2Unealtă care dă eroare
Agentul cheamă de 10 ori o unealtă HTTP care răspunde 404Repară URL-ul uneltei; agentul primește rezultatul din primaAgentul reîncearcă la nesfârșit când nu primește ce caută.
3Descriere neclară
Tool description: „unealtă”Tool description: „Află prețul unui produs după id”Modelul alege uneltele după descriere.
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.
Reparația
1. AI Agent → Options → Max Iterations: 10. 2. Execute workflow: „Totalul ofertei cu reducere este 12145.5 lei.”
De ce merge
Agentul are nevoie de 3 apeluri ale calculatorului (prețul laptopurilor, al monitoarelor, totalul), dar limita de 2 îl oprea înainte de ultimul. Cu limita 10, termină toate calculele și dă răspunsul final.
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
Error in sub-node 'OpenAI Chat Model' Eroarea nu e în nodul AI principal, ci într-un sub-nod legat de el (model, memorie, unealtă, embeddings). Deschide sub-nodul numit în mesaj, citește eroarea lui (credențiale lipsă, cheie greșită, parametru gol) și repar-o acolo. A Chat Model sub-node must be connected and enabled Nodul AI (AI Agent, Basic LLM Chain, Text Classifier, Information Extractor) nu are un model de limbaj legat la intrarea Chat Model de jos, sau modelul legat e dezactivat. Adaugă un Chat Model (de exemplu OpenAI Chat Model) pe intrarea Chat Model și activează-l. The service is receiving too many requests from you API-ul a răspuns 429 Too Many Requests: workflow-ul trimite prea multe cereri într-un timp scurt (de obicei câte una pentru fiecare item). Trimite mai puține cereri (Execute Once când datele sunt aceleași, loturi cu Batching) sau pune pauze între ele și retry cu așteptare. Î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.
