...
Eroare Aplicații AI cu LLM · Șabloane de prompt și formatarea textului

KeyError: '"nume"'

Pe scurt

Ș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()

Greșit
PYTHON
SABLON = 'Răspunde ca JSON: {"nume": "...", "email": "..."}\nMesaj: {mesaj}'
prompt = SABLON.format(mesaj=text)
Corect
PYTHON
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

Greșit
PYTHON
SABLON = """Formatul:
{
  "nume": "..."
}
Text: {text}"""
Corect
PYTHON
SABLON = """Formatul:
{{
  "nume": "..."
}}
Text: {text}"""

Și aici fiecare acoladă din exemplu trebuie dublată.

3Exemplul JSON generat separat

Greșit
PYTHON
prompt = SABLON.format(text=text)   # SABLON conține JSON
Corect
PYTHON
EXEMPLU = json.dumps({"nume": "...", "email": "..."}, ensure_ascii=False)
prompt = "Răspunde ca JSON, exact așa: " + EXEMPLU + "\nText: " + text

Fără format, acoladele din exemplu nu mai sunt interpretate.

Repară tu

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.

Codul care dă eroarea
PYTHON
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"])
După reparație, programul afișează
Nume: Radu Ene
Oraș: Iași
Indiciu

Acoladele exemplului devin {{ și }}; {mesaj} rămâne simplu.

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

← Toate erorile Aplicații AI cu LLM

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ță 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.