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

ValueError: 'urgent' is not a valid Prioritate

Pe scurt

Modelul a întors o valoare care nu există în Enum-ul tău (de exemplu "urgent", când ai doar mica, medie, mare). Restrânge valorile în prompt sau în schema JSON cu enum, normalizează textul înainte de conversie și tratează valorile necunoscute.

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

Ce înseamnă

Prioritate("urgent") caută în Enum un membru cu valoarea "urgent". Dacă nu există, Python ridică ValueError cu textul primit și numele clasei: 'urgent' is not a valid Prioritate.

În aplicațiile cu LLM, Enum-urile se folosesc pentru categorii, priorități sau stări extrase din text. Modelul însă nu știe de clasa ta: dacă promptul doar sugerează valorile, poate răspunde cu un sinonim (urgent în loc de mare), cu majuscule (Mare), cu diacritice (mică) sau cu un spațiu în plus.

Mesajul îți dă exact valoarea problematică, între ghilimele; compar-o cu valorile din Enum.

De ce apare: cauzele frecvente

1Valori sugerate în prompt, dar nu impuse

Greșit
PYTHON
system = "Dă prioritatea: mica, medie sau mare."
p = Prioritate(text)
Corect
PYTHON
SCHEMA = {"type": "object", "properties": {"prioritate": {"type": "string", "enum": ["mica", "medie", "mare"]}},
          "required": ["prioritate"], "additionalProperties": False}

Cu enum în schema ieșirii structurate, modelul poate alege doar dintre valorile permise.

2Majuscule, spații, diacritice

Greșit
PYTHON
p = Prioritate(text)   # 'Mare ' sau 'mică'
Corect
PYTHON
p = Prioritate(text.strip().lower().replace("ă", "a"))

Normalizarea aduce textul la forma exactă din Enum.

3Valoare nouă, netratată

Greșit
PYTHON
p = Prioritate(text)
Corect
PYTHON
try:
    p = Prioritate(text)
except ValueError:
    p = Prioritate.MEDIE   # sau marchezi pentru verificare

Un fallback explicit păstrează aplicația funcțională când apare o valoare neprevăzută.

Repară tu

Repară eroarea, direct în pagină

Clasificatorul de tichete transformă prioritatea primită de la model în Enum-ul Prioritate, dar cade cu ValueError: 'Mare' is not a valid Prioritate (modelul a scris cu majusculă). Normalizează textul cu strip().lower() înainte de conversie, iar dacă valoarea tot nu există, folosește Prioritate.MEDIE. Afișează prioritatea fiecărui tichet.

Codul care dă eroarea
PYTHON
from enum import Enum

import anthropic

MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()


class Prioritate(Enum):
    MICA = "mica"
    MEDIE = "medie"
    MARE = "mare"


tichete = ["Site-ul nu se mai deschide deloc.", "Aș vrea să schimb culoarea logo-ului.", "Plățile cu cardul eșuează de o oră."]


def prioritate(tichet):
    r = client.messages.create(
        model=MODEL,
        max_tokens=10,
        system="Dai prioritatea tichetului într-un cuvânt: mica, medie sau mare.",
        messages=[{"role": "user", "content": tichet}],
    )
    return Prioritate(r.content[0].text)


for t in tichete:
    print(prioritate(t).value, "-", t)
După reparație, programul afișează
mare - Site-ul nu se mai deschide deloc.
mica - Aș vrea să schimb culoarea logo-ului.
medie - Plățile cu cardul eșuează de o oră.
Indiciu

Prioritate(text.strip().lower()) într-un try, cu except ValueError.

Alte forme ale mesajului

  • ValueError: 'Mare' is not a valid Prioritate
  • ValueError: 'urgent' is not a valid Categorie
  • KeyError: 'URGENT'

Cum o eviți pe viitor

  • Pune valorile permise în schema JSON cu enum, nu doar în textul promptului.
  • Generează lista din Enum, ca să nu se desincronizeze: [p.value for p in Prioritate].
  • Normalizează textul și tratează ValueError cu un fallback sau cu un log pentru revizuire.
  • Testează clasificarea pe exemple reale, inclusiv pe cele ambigue.

Întrebări frecvente

De ce KeyError apare în variante?

Pentru că un Enum se poate accesa și după nume, Prioritate["URGENT"]. Atunci eroarea pentru un nume inexistent este KeyError, nu ValueError.

E mai bine să las modelul să inventeze categorii?

Rar. Restul aplicației (filtre, statistici, rutare) are nevoie de un set fix de valori. Lasă o categorie „altele” pentru ce nu se potrivește.

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.