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

ValueError: range() arg 3 must not be zero

Pe scurt

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

Greșit
PYTHON
MARIME, SUPRAPUNERE = 200, 200
for i in range(0, len(text), MARIME - SUPRAPUNERE):
    bucati.append(text[i:i + MARIME])
Corect
PYTHON
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ă

Greșit
PYTHON
def imparte(text, marime, suprapunere):
    pas = marime - suprapunere
    return [text[i:i + marime] for i in range(0, len(text), pas)]
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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))
După reparație, programul afișează
Bucăți: 6
Vectori: 6
Indiciu

if not 0 <= suprapunere < marime: raise ValueError(...)

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

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