ValueError: range() arg 3 must not be zero
La chunking cu suprapunere, pasul este mărime - suprapunere. Când suprapunerea e egală cu mărimea bucății, pasul devine 0, iar range() nu poate avansa. Suprapunerea trebuie să fie mai mică decât bucata (de obicei 10–20% din ea); verifică asta la începutul funcției.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
range(start, stop, pas) cere un pas diferit de zero, altfel ar rămâne pe loc la nesfârșit. Mesajul îți spune că al treilea argument (arg 3) e zero.
În RAG, range cu pas apare în funcția care taie documentele în bucăți cu suprapunere: o bucată nouă începe la fiecare marime - suprapunere caractere (sau tokeni). Dacă suprapunere == marime, pasul e 0. Dacă suprapunerea e mai mare, pasul e negativ: nu primești eroare, ci o listă goală de bucăți, deci niciun document indexat, ceea ce e mai greu de observat.
Cauza obișnuită e configurarea: valori schimbate separat (MARIME = 200 într-un loc, SUPRAPUNERE = 200 în altul) sau unități amestecate (suprapunerea în caractere, mărimea în tokeni).
De ce apare: cauzele frecvente
1Suprapunere egală cu mărimea
MARIME, SUPRAPUNERE = 200, 200
for i in range(0, len(text), MARIME - SUPRAPUNERE):
bucati.append(text[i:i + MARIME])MARIME, SUPRAPUNERE = 200, 40
for i in range(0, len(text), MARIME - SUPRAPUNERE):
bucati.append(text[i:i + MARIME])Cu suprapunere mai mică decât mărimea, fiecare bucată nouă începe mai departe decât precedenta.
2Configurare nevalidată
def imparte(text, marime, suprapunere):
pas = marime - suprapunere
return [text[i:i + marime] for i in range(0, len(text), pas)]def imparte(text, marime, suprapunere):
if not 0 <= suprapunere < marime:
raise ValueError("suprapunerea trebuie să fie între 0 și mărimea bucății")
pas = marime - suprapunere
return [text[i:i + marime] for i in range(0, len(text), pas)]O verificare la început explică problema și prinde și cazul cu pas negativ, care altfel ar da o listă goală.
Repară eroarea, direct în pagină
Funcția imparte taie regulamentul în bucăți de 200 de caractere cu suprapunere, dar configurarea are SUPRAPUNERE = 200, iar programul cade cu range() arg 3 must not be zero. Repară: pune SUPRAPUNERE = 40 și adaugă în imparte o verificare care aruncă ValueError dacă suprapunerea nu e între 0 și mărime. Programul afișează numărul de bucăți și câți vectori au fost calculați.
from openai import OpenAI
MODEL_EMB = "text-embedding-3-small"
MARIME = 200
SUPRAPUNERE = 200
client = OpenAI()
text = " ".join(f"Articolul {i}: angajații respectă programul de lucru și procedurile interne." for i in range(1, 13))
def imparte(text, marime, suprapunere):
pas = marime - suprapunere
return [text[i:i + marime] for i in range(0, len(text), pas)]
bucati = imparte(text, MARIME, SUPRAPUNERE)
r = client.embeddings.create(model=MODEL_EMB, input=bucati)
print("Bucăți:", len(bucati))
print("Vectori:", len(r.data))Bucăți: 6 Vectori: 6
Indiciu
if not 0 <= suprapunere < marime: raise ValueError(...)
Reparația
from openai import OpenAI
MODEL_EMB = "text-embedding-3-small"
MARIME = 200
SUPRAPUNERE = 40
client = OpenAI()
text = " ".join(f"Articolul {i}: angajații respectă programul de lucru și procedurile interne." for i in range(1, 13))
def imparte(text, marime, suprapunere):
if not 0 <= suprapunere < marime:
raise ValueError("Suprapunerea trebuie să fie între 0 și mărimea bucății.")
pas = marime - suprapunere
return [text[i:i + marime] for i in range(0, len(text), pas)]
bucati = imparte(text, MARIME, SUPRAPUNERE)
r = client.embeddings.create(model=MODEL_EMB, input=bucati)
print("Bucăți:", len(bucati))
print("Vectori:", len(r.data))De ce merge
Pasul dintre începuturile bucăților este marime - suprapunere. Cu 200 și 200, pasul e 0, iar range refuză să avanseze. Cu suprapunere 40, fiecare bucată începe la 160 de caractere după precedenta și păstrează ultimele 40 de caractere ale ei, ca propozițiile tăiate la margine să apară întregi. Verificarea din funcție prinde și o configurare greșită viitoare, inclusiv pasul negativ.
Alte forme ale mesajului
ValueError: slice step cannot be zero
Cum o eviți pe viitor
- Validează parametrii de chunking la începutul funcției (
0 <= suprapunere < marime). - Ține mărimea și suprapunerea împreună, în aceeași configurare și în aceeași unitate.
- După chunking, verifică numărul de bucăți: zero bucăți dintr-un document nevid e întotdeauna o greșeală.
Întrebări frecvente
Cât de mare să fie suprapunerea?
O valoare tipică este 10–20% din mărimea bucății: suficient ca o propoziție tăiată la margine să apară întreagă în bucata următoare, fără să dublezi indexul.
Ce se întâmplă cu suprapunere mai mare decât mărimea?
Pasul devine negativ, iar range(0, n, -40) e gol. Nu primești nicio eroare, doar nicio bucată, deci verificarea din funcție e importantă.
Erori înrudite
openai.BadRequestError: Error code: 400 - '$.input' is invalid. Please check the API reference: https://platform.openai.com/docs/api-reference. Lista trimisă la embeddings.create conține un text gol (sau ceva care nu e text, de exemplu None). De obicei vine din împărțirea documentului: split("\n\n") lasă bucăți goale la final sau între secțiuni. Filtrează bucățile goale înainte de apel. ValueError: zip() argument 2 is longer than argument 1 Compari doi vectori de embeddings cu lungimi diferite: de obicei indexul a fost construit cu alt model sau cu alt `dimensions` decât întrebarea. Generează vectorii documentelor și ai întrebării cu același model și aceleași setări, și verifică `len(a) == len(b)` înainte de similaritate. ValueError: max() iterable argument is empty 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ă. Î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.
