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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
KeyError e eroarea Python pentru o cheie care nu există în dicționar; între ghilimele e numele cheii căutate. Cu LLM-urile, dicționarul vine din JSON-ul generat de model, iar modelul nu inventează (și nici nu trebuie să inventeze) date care nu sunt în text.
Cauzele obișnuite: informația lipsește din mesajul clientului (n-a scris e-mailul), modelul a folosit altă cheie (mail, e-mail, adresa_email) pentru că schema nu era fixată, sau citești structura greșit (cheia e într-un obiect interior, date["client"]["email"]).
Pentru date extrase de un model, presupune mereu că un câmp poate lipsi. Ieșirea structurată cu schemă fixează numele cheilor; required plus un tip care permite null (["string", "null"]) îi spune modelului să pună explicit null când nu găsește valoarea. În cod, citești cu .get() și tratezi lipsa.
De ce apare: cauzele frecvente
1Câmp opțional citit ca obligatoriu
date = json.loads(text)
print("Email:", date["email"])date = json.loads(text)
print("Email:", date.get("email") or "nu a fost menționat").get() întoarce None pentru o cheie lipsă în loc să arunce KeyError, iar tu decizi ce afișezi.
2Numele cheii nefixat prin schemă
system = "Extrage numele și e-mailul în JSON."
# modelul poate răspunde cu "mail", "e-mail" sau "email"SCHEMA = {"type": "object",
"properties": {"nume": {"type": "string"}, "email": {"type": ["string", "null"]}},
"required": ["nume", "email"], "additionalProperties": False}Cu schema, cheia se numește mereu email, iar lipsa valorii devine null, nu o cheie absentă.
3Cheia căutată la nivelul greșit
# {"client": {"nume": "Ana", "email": "ana@exemplu.ro"}}
print(date["email"])print(date["client"]["email"])Când JSON-ul e imbricat, cheia stă în obiectul interior. Afișează JSON-ul ca să vezi structura.
Repară eroarea, direct în pagină
Programul de mai jos extrage datele de contact din mesajele clienților și dă KeyError: 'email' la al doilea mesaj, unde clientul nu și-a scris e-mailul. Repară citirea câmpului: dacă e-mailul lipsește (cheie absentă sau null), afișează Email: lipsește. Programul afișează pentru fiecare mesaj Nume: ... și Email: ....
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
mesaje = [
"Bună, sunt Ana Marin (ana.marin@exemplu.ro) și vreau o ofertă pentru un tort.",
"Salut, sunt Radu Ilie, sunați-mă vă rog pentru comanda de nuntă.",
]
for mesaj in mesaje:
r = client.messages.create(
model=MODEL,
max_tokens=200,
system="Extragi numele și e-mailul clientului în JSON, cu cheile nume și email.",
messages=[{"role": "user", "content": mesaj}],
)
date = json.loads(r.content[0].text)
print("Nume:", date["nume"])
print("Email:", date["email"])Nume: Ana Marin Email: ana.marin@exemplu.ro Nume: Radu Ilie Email: lipsește
Indiciu
date.get("email") întoarce None dacă cheia lipsește.
Reparația
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
mesaje = [
"Bună, sunt Ana Marin (ana.marin@exemplu.ro) și vreau o ofertă pentru un tort.",
"Salut, sunt Radu Ilie, sunați-mă vă rog pentru comanda de nuntă.",
]
for mesaj in mesaje:
r = client.messages.create(
model=MODEL,
max_tokens=200,
system="Extragi numele și e-mailul clientului în JSON, cu cheile nume și email.",
messages=[{"role": "user", "content": mesaj}],
)
date = json.loads(r.content[0].text)
print("Nume:", date.get("nume"))
print("Email:", date.get("email") or "lipsește")De ce merge
Modelul a extras corect ce era în text: al doilea client nu a scris e-mailul, deci JSON-ul nu are cheia email. Citirea cu date["email"] presupunea că cheia există mereu. Cu date.get("email") primești None pentru cheia lipsă, iar or "lipsește" acoperă și cazul în care modelul pune explicit null. Într-o aplicație reală, ai fixa și cheile cu o schemă, ca numele lor să fie mereu aceleași.
Alte forme ale mesajului
KeyError: 'telefon'KeyError: 'categorie'
Cum o eviți pe viitor
- Definește o schemă JSON pentru orice extragere și cere-o prin ieșire structurată.
- Pentru informații care pot lipsi, folosește tipul
["string", "null"]și instrucțiunea „pune null dacă lipsește”. - Citește câmpurile cu
.get()și validează rezultatul (de exemplu cu undataclassși reguli proprii) înainte să-l folosești.
Întrebări frecvente
De ce modelul nu a pus cheia, deși am cerut-o?
Fără schemă, modelul interpretează instrucțiunea și poate omite câmpurile pentru care n-a găsit date. Cu o schemă care are câmpul în required, cheia apare mereu, eventual cu null.
E mai bine try/except KeyError sau .get()?
Pentru câmpuri care pot lipsi în mod normal, .get() e mai clar. try/except are sens când lipsa unui câmp e o eroare reală, pe care vrei să o raportezi.
Erori înrudite
json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) `json.loads` a primit un text care nu începe cu JSON: modelul a pus JSON-ul între ```json ... ``` sau a scris o propoziție înainte. Cere ieșire structurată (`output_config` cu `json_schema` la Claude, `text.format` la OpenAI) sau scoate marcajele înainte de `json.loads`. TypeError: the JSON object must be str, bytes or bytearray, not list Ai dat lui `json.loads` lista de blocuri `raspuns.content`, nu textul din ea. `json.loads` primește doar text: folosește `json.loads(raspuns.content[0].text)` (sau textul lipit din blocurile `text`). TypeError: verifica_stoc() got an unexpected keyword argument 'marime' Ai apelat funcția tool-ului cu argumentele modelului (`functie(**bloc.input)`), iar modelul a trimis un argument pe care funcția nu îl are. Fă funcția să accepte toate proprietățile din schemă (cu valori implicite pentru cele opționale) și validează argumentele înainte de apel. Î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.
