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

Model output doesn't fit required format

Pe scurt

Ai cerut un format fix (Require Specific Output Format + Structured Output Parser), dar textul modelului nu se potrivește cu schema: lipsesc câmpuri, tipuri diferite sau JSON invalid (ori chiar exemplul din parser nu e JSON valid). Verifică exemplul JSON din parser, descrie clar formatul în prompt și activează Auto-fixing dacă e nevoie.

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

Ce înseamnă

Cu Require Specific Output Format activ, n8n îi cere modelului să răspundă după o schemă și apoi verifică răspunsul cu Structured Output Parser. Dacă răspunsul nu e JSON valid sau nu respectă schema, nodul se oprește cu Model output doesn't fit required format (la versiuni mai vechi: Could not parse LLM output, Failed to parse).

Cauze: exemplul din parser nu e JSON valid (ghilimele simple, chei fără ghilimele, virgulă la final), deci schema e greșită de la început; promptul cere altceva decât schema; câmpurile din schemă au nume ambigue; modelul e prea mic pentru structuri complicate; răspunsul a fost tăiat (Max Tokens prea mic).

Reparații: un exemplu JSON valid și simplu, descrieri de câmpuri în prompt, Max Tokens suficient și, pentru cazurile rare, Auto-fixing Output Parser, care îi cere modelului să-și corecteze răspunsul.

De ce apare: cauzele frecvente

1Exemplu JSON invalid

Greșit
JSON
{titlu: 'Laptop', pret: 0}
Corect
JSON
{"titlu": "Laptop", "pret": 0}

JSON cere ghilimele duble la chei și la texte.

2Prompt care cere alt format

Greșit
JSON
Prompt: „Scrie o descriere frumoasă” + parser cu {titlu, pret}
Corect
JSON
Prompt: „Întoarce titlul și prețul produsului”

Promptul și schema trebuie să ceară același lucru.

3Răspuns tăiat

Greșit
JSON
Max Tokens: 50 pentru o listă de 20 de produse
Corect
JSON
Max Tokens: 1000

JSON-ul neterminat nu poate fi citit.

Repară tu

Repară eroarea, direct în pagină

Nodul Descriere generează date de produs cu un Structured Output Parser, dar exemplul din parser nu e JSON valid ({titlu: 'Produs', pret: 0}), așa că nodul se oprește. Pune în Structured Output Parser exemplul valid {"titlu": "Produs", "pret": 0} și rulează: Descriere trebuie să întoarcă output.titlu și output.pret.

Indiciu

JSON cere ghilimele duble la chei și la texte.

Alte forme ale mesajului

  • Could not parse LLM output
  • Failed to parse. Text: ... Error: SyntaxError: Unexpected token
  • Exemplul JSON din „Structured Output Parser” nu este valid

Cum o eviți pe viitor

  • Testează exemplul JSON într-un validator înainte să-l pui în parser.
  • Păstrează schema mică: doar câmpurile de care ai nevoie.
  • Folosește Auto-fixing Output Parser pentru intrări variate.
  • Pune un If după nodul AI care verifică existența câmpurilor obligatorii.

Întrebări frecvente

Ce face Auto-fixing Output Parser?

Dacă primul răspuns nu respectă schema, trimite modelului eroarea și îi cere un răspuns corectat. Costă un apel în plus doar când e nevoie.

Pot folosi JSON Schema în loc de exemplu?

Da: Schema Type: Define using JSON Schema, cu tipuri, câmpuri obligatorii și descrieri.

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.