...
Eroare Aplicații AI cu LLM · JSON de la model

KeyError: 'email'

Pe scurt

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

Greșit
PYTHON
date = json.loads(text)
print("Email:", date["email"])
Corect
PYTHON
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ă

Greșit
PYTHON
system = "Extrage numele și e-mailul în JSON."
# modelul poate răspunde cu "mail", "e-mail" sau "email"
Corect
PYTHON
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

Greșit
PYTHON
# {"client": {"nume": "Ana", "email": "ana@exemplu.ro"}}
print(date["email"])
Corect
PYTHON
print(date["client"]["email"])

Când JSON-ul e imbricat, cheia stă în obiectul interior. Afișează JSON-ul ca să vezi structura.

Repară tu

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: ....

Codul care dă eroarea
PYTHON
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"])
După reparație, programul afișează
Nume: Ana Marin
Email: ana.marin@exemplu.ro
Nume: Radu Ilie
Email: lipsește
Indiciu

date.get("email") întoarce None dacă cheia lipsește.

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 un dataclass ș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

← 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.