...
Eroare Aplicații AI cu LLM · Embeddings și RAG

ValueError: max() iterable argument is empty

Pe scurt

Ai apelat max() pe o listă goală: după filtrare (departament, prag de similaritate, dată), niciun document n-a rămas. Verifică lista înainte, sau folosește max(..., default=None), și răspunde explicit că nu ai găsit surse, în loc să lași programul să cadă.

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

Ce înseamnă

max() caută cel mai mare element, iar într-o listă goală nu există unul. Mesajul apare în Python 3.12 și mai nou; versiunile mai vechi spun max() arg is an empty sequence, cu aceeași cauză.

Într-un sistem RAG, lista goală vine aproape mereu dintr-un filtru: documentele unui departament care nu are încă documente, bucățile peste un prag de similaritate pe care nicio bucată nu-l atinge, o căutare într-un index încă gol. Codul testat pe întrebări bune merge, iar prima întrebare „fără răspuns” îl oprește.

Cazul gol nu e o excepție rară, ci un rezultat valid: asistentul trebuie să spună „nu am găsit informația”, nu să inventeze și nici să cadă.

De ce apare: cauzele frecvente

1Filtrul după metadate nu lasă nimic

Greșit
PYTHON
candidati = [d for d in index if d["departament"] == departament]
cel_mai_bun = max(candidati, key=lambda d: d["scor"])
Corect
PYTHON
candidati = [d for d in index if d["departament"] == departament]
if not candidati:
    return "Nu am documente pentru acest departament."
cel_mai_bun = max(candidati, key=lambda d: d["scor"])

Verificarea tratează explicit cazul în care filtrul nu găsește nimic.

2Prag de similaritate prea sus

Greșit
PYTHON
relevante = [s for s in scoruri if s > 0.95]
print(max(relevante))
Corect
PYTHON
relevante = [s for s in scoruri if s > PRAG]
print(max(relevante, default=None))

default=None întoarce None în loc să arunce eroarea, iar codul de după tratează None.

Repară tu

Repară eroarea, direct în pagină

Asistentul intern caută în documentele unui departament, dar departamentul juridic nu are documente, iar programul cade cu max() iterable argument is empty. Repară funcția cauta: dacă după filtrare nu rămâne niciun document, întoarce Nu am documente pentru departamentul <departament>.; altfel întoarce textul celui mai apropiat document.

Codul care dă eroarea
PYTHON
import math

from openai import OpenAI

MODEL_EMB = "text-embedding-3-small"
client = OpenAI()


def cosinus(a, b):
    produs = sum(x * y for x, y in zip(a, b))
    return produs / (math.sqrt(sum(x * x for x in a)) * math.sqrt(sum(y * y for y in b)))


DOCUMENTE = [
    {"departament": "hr", "text": "Concediul de odihnă se cere cu 10 zile înainte, în aplicația internă."},
    {"departament": "hr", "text": "Bonurile de masă se acordă lunar, pe card."},
    {"departament": "it", "text": "Parola contului se schimbă la fiecare 90 de zile."},
]
r = client.embeddings.create(model=MODEL_EMB, input=[d["text"] for d in DOCUMENTE])
for d, item in zip(DOCUMENTE, r.data):
    d["vector"] = item.embedding


def cauta(intrebare, departament):
    q = client.embeddings.create(model=MODEL_EMB, input=intrebare).data[0].embedding
    candidati = [d for d in DOCUMENTE if d["departament"] == departament]
    cel_mai_bun = max(candidati, key=lambda d: cosinus(d["vector"], q))
    return cel_mai_bun["text"]


print(cauta("Cu câte zile înainte se cere concediul de odihnă?", "hr"))
print(cauta("Cine semnează contractele?", "juridic"))
După reparație, programul afișează
Concediul de odihnă se cere cu 10 zile înainte, în aplicația internă.
Nu am documente pentru departamentul juridic.
Indiciu

Pune if not candidati: înainte de max.

Alte forme ale mesajului

  • ValueError: max() arg is an empty sequence
  • ValueError: min() iterable argument is empty
  • IndexError: list index out of range

Cum o eviți pe viitor

  • Tratează rezultatul gol al căutării ca pe un caz normal, cu un răspuns pregătit („Nu am găsit informația în documente”).
  • Folosește max(..., default=None) acolo unde lista poate fi goală.
  • Testează asistentul și cu întrebări la care documentele nu au răspuns.

Întrebări frecvente

De ce în alt proiect mesajul e „max() arg is an empty sequence”?

E același lucru în Python mai vechi (până la 3.11). Din 3.12, mesajul a devenit max() iterable argument is empty.

Nu e mai simplu să trimit întrebarea la model fără context?

Atunci modelul răspunde din cunoștințele generale și poate inventa reguli care nu sunt ale firmei. Pentru un asistent pe documente, „nu am găsit” e răspunsul corect.

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.