KeyError: '"nume"'
Șablonul promptului conține un exemplu JSON cu acolade, iar str.format() crede că {"nume": ...} e un câmp de completat. Dublează acoladele din exemplu ({{ și }}) sau construiește promptul fără format(), de exemplu cu concatenare sau string.Template.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru str.format(), orice text între { și } e un câmp de înlocuit. Când promptul are un exemplu de răspuns JSON, ca {"nume": "...", "email": "..."}, format ia ca nume de câmp tot ce e între prima acoladă și primele două puncte: "nume", cu ghilimele cu tot. Nu găsește argumentul cu numele acesta și ridică KeyError.
Ghilimelele din mesaj sunt indiciul: KeyError: '"nume"' nu e o cheie lipsă din JSON-ul modelului, ci din argumentele lui format. Dacă exemplul JSON începe pe rândul următor acoladei, mesajul arată și spațiile: KeyError: '\n "nume"'.
Eroarea apare înainte de orice apel API, la construirea promptului.
De ce apare: cauzele frecvente
1Exemplu JSON într-un șablon format()
SABLON = 'Răspunde ca JSON: {"nume": "...", "email": "..."}\nMesaj: {mesaj}'
prompt = SABLON.format(mesaj=text)SABLON = 'Răspunde ca JSON: {{"nume": "...", "email": "..."}}\nMesaj: {mesaj}'
prompt = SABLON.format(mesaj=text){{ și }} devin acolade simple în rezultat, iar format completează doar {mesaj}.
2Exemplu JSON pe mai multe rânduri
SABLON = """Formatul:
{
"nume": "..."
}
Text: {text}"""SABLON = """Formatul:
{{
"nume": "..."
}}
Text: {text}"""Și aici fiecare acoladă din exemplu trebuie dublată.
3Exemplul JSON generat separat
prompt = SABLON.format(text=text) # SABLON conține JSONEXEMPLU = json.dumps({"nume": "...", "email": "..."}, ensure_ascii=False)
prompt = "Răspunde ca JSON, exact așa: " + EXEMPLU + "\nText: " + textFără format, acoladele din exemplu nu mai sunt interpretate.
Repară eroarea, direct în pagină
Șablonul SABLON cere modelului un JSON cu numele și orașul clientului, dar SABLON.format(mesaj=...) cade cu KeyError: '"nume"', din cauza acoladelor din exemplul JSON. Repară șablonul, ca format să completeze doar {mesaj}, și afișează numele și orașul extrase.
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
SABLON = 'Extrage datele clientului ca JSON, exact așa: {"nume": "...", "oras": "..."}\nMesaj: {mesaj}'
prompt = SABLON.format(mesaj="Bună, sunt Radu Ene din Iași și aș vrea o ofertă.")
r = client.messages.create(model=MODEL, max_tokens=200, messages=[{"role": "user", "content": prompt}])
date = json.loads(r.content[0].text)
print("Nume:", date["nume"])
print("Oraș:", date["oras"])Nume: Radu Ene Oraș: Iași
Indiciu
Acoladele exemplului devin {{ și }}; {mesaj} rămâne simplu.
Reparația
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
SABLON = 'Extrage datele clientului ca JSON, exact așa: {{"nume": "...", "oras": "..."}}\nMesaj: {mesaj}'
prompt = SABLON.format(mesaj="Bună, sunt Radu Ene din Iași și aș vrea o ofertă.")
r = client.messages.create(model=MODEL, max_tokens=200, messages=[{"role": "user", "content": prompt}])
date = json.loads(r.content[0].text)
print("Nume:", date["nume"])
print("Oraș:", date["oras"])De ce merge
str.format interpretează orice {...} ca un câmp. Dublând acoladele exemplului, ele apar ca acolade simple în promptul final, iar singurul câmp rămâne {mesaj}. Modelul primește exemplul JSON corect, răspunde în același format, iar json.loads citește numele și orașul. Același lucru e valabil pentru orice text cu acolade pus într-un șablon.
Alte forme ale mesajului
KeyError: '\n "nume"'
Cum o eviți pe viitor
- Când un șablon conține JSON sau cod, dublează toate acoladele care nu sunt câmpuri.
- Pentru exemple JSON lungi, generează-le cu
json.dumpsși lipește-le separat de șablon. - Ține șabloanele în constante și testează-le o dată cu valori de probă, înainte de apelurile reale.
- Pentru JSON garantat, schema din ieșirea structurată e mai sigură decât un exemplu în text.
Întrebări frecvente
De ce KeyError și nu altă eroare?
format caută numele câmpului printre argumentele cu nume date, ca într-un dicționar. Numele "nume" nu există acolo, deci primești aceeași eroare ca la un dicționar.
Și cu f-string-uri e la fel?
Similar: într-un f-string, acoladele din exemplu sunt evaluate ca expresii Python și dau de obicei Invalid format specifier sau NameError. Reparația e aceeași, acolade dublate.
Erori înrudite
ValueError: Single '}' encountered in format string Șablonul de prompt are o acoladă singură care nu face parte dintr-un câmp: de obicei ai dublat acolada de deschidere a unui exemplu JSON ({{), dar nu și pe cea de închidere. Dublează fiecare acoladă de text: {{ și }}. ValueError: Invalid format specifier ' "Ana"' for object of type 'str' Ai pus un exemplu JSON direct într-un f-string, iar Python a citit {"nume": "Ana"} ca expresia "nume" urmată de specificatorul de format "Ana". Dublează acoladele exemplului în f-string ({{ și }}) sau adaugă exemplul JSON separat, fără f-string. KeyError: 'email' JSON-ul primit de la model nu are cheia pe care o citești (`date["email"]`): modelul a omis-o pentru că informația lipsea din text sau a numit-o altfel. Folosește `date.get("email")` cu o valoare implicită și cere câmpul în schemă (`required`), cu `null` permis când lipsește. Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție
Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.
