IndexError: Replacement index 1 out of range for positional args tuple
Șablonul are mai multe câmpuri {} decât valorile date lui format(). Dă câte o valoare pentru fiecare {} sau, mai sigur, folosește câmpuri cu nume ({produs}, {intrebare}) și format(produs=..., intrebare=...).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Câmpurile goale {} dintr-un șablon se completează în ordine cu argumentele poziționale ale lui format: primul {} ia primul argument, al doilea {} pe al doilea, și așa mai departe. „Replacement index 1” înseamnă al doilea câmp (numărătoarea pornește de la 0), iar „out of range” că nu există al doilea argument.
În prompturile mai lungi, cu context, instrucțiuni și întrebare, e ușor să adaugi un {} nou în șablon și să uiți valoarea în apel, sau să schimbi ordinea și să trimiți modelului datele amestecate (fără nicio eroare). Câmpurile cu nume rezolvă ambele probleme: fiecare valoare ajunge exact unde trebuie.
De ce apare: cauzele frecvente
1Câmp adăugat în șablon, valoare uitată
SABLON = "Produs: {}\nÎntrebare: {}"
prompt = SABLON.format(intrebare)SABLON = "Produs: {produs}\nÎntrebare: {intrebare}"
prompt = SABLON.format(produs=produs, intrebare=intrebare)Cu nume, fiecare câmp își primește valoarea, iar lipsa uneia dă un KeyError clar, cu numele câmpului.
2Valorile date ca o singură listă
prompt = SABLON.format([produs, intrebare])prompt = SABLON.format(*[produs, intrebare])* despachetează lista în argumente separate; fără el, lista e un singur argument.
Repară eroarea, direct în pagină
Funcția intreaba_despre completează un șablon cu numele produsului și întrebarea clientului, dar cade cu IndexError: Replacement index 1 out of range for positional args tuple. Rescrie șablonul cu câmpuri cu nume, {produs} și {intrebare}, completează-le pe amândouă și afișează răspunsul.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
SABLON = "Ești consultantul unui magazin de electronice.\nProdus: {}\nÎntrebarea clientului: {}"
def intreaba_despre(produs, intrebare):
prompt = SABLON.format(intrebare)
r = client.messages.create(model=MODEL, max_tokens=150, messages=[{"role": "user", "content": prompt}])
return r.content[0].text
print(intreaba_despre("Laptop Nova 14", "Are port HDMI?"))Da, Laptop Nova 14 are un port HDMI 2.1 pe partea stângă.
Indiciu
SABLON.format(produs=produs, intrebare=intrebare).
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
SABLON = "Ești consultantul unui magazin de electronice.\nProdus: {produs}\nÎntrebarea clientului: {intrebare}"
def intreaba_despre(produs, intrebare):
prompt = SABLON.format(produs=produs, intrebare=intrebare)
r = client.messages.create(model=MODEL, max_tokens=150, messages=[{"role": "user", "content": prompt}])
return r.content[0].text
print(intreaba_despre("Laptop Nova 14", "Are port HDMI?"))De ce merge
Șablonul avea două câmpuri {}, iar apelul dădea o singură valoare, deci al doilea câmp (indicele 1) nu avea ce primi. Cu câmpuri cu nume, fiecare valoare ajunge exact în locul ei, indiferent de ordine, iar promptul conține și produsul, și întrebarea. Modelul primește contextul complet și răspunde despre produsul corect.
Alte forme ale mesajului
IndexError: Replacement index 2 out of range for positional args tupleIndexError: tuple index out of range
Cum o eviți pe viitor
- Folosește câmpuri cu nume în toate șabloanele de prompt.
- Ține șabloanele într-un singur loc și scrie câte o funcție care le completează, cu parametrii numiți la fel.
- Afișează o dată promptul final când modifici un șablon, ca să verifici că fiecare valoare e la locul ei.
Întrebări frecvente
De ce mesajul spune „index 1” când am doar două câmpuri?
Indicii pornesc de la 0: primul {} e indicele 0, al doilea e 1. Ai dat o singură valoare, deci indicele 1 nu există.
În Python mai vechi mesajul era altul?
Da, până la Python 3.8 eroarea era IndexError: tuple index out of range, aceeași cauză.
Erori înrudite
KeyError: '"nume"' Șablonul promptului conține un exemplu JSON cu acolade, iar str.format() crede că {"nume": ...} e un câmp de completat. Dublează acoladele din exemplu ({{ și }}) sau construiește promptul fără format(), de exemplu cu concatenare sau string.Template. ValueError: Single '}' encountered in format string Șablonul de prompt are o acoladă singură care nu face parte dintr-un câmp: de obicei ai dublat acolada de deschidere a unui exemplu JSON ({{), dar nu și pe cea de închidere. Dublează fiecare acoladă de text: {{ și }}. TypeError: Messages.create() takes 1 positional argument but 2 were given Metodele SDK-ului primesc doar argumente cu nume (model=..., messages=...), iar tu ai dat o valoare pe poziție, de obicei un dicționar cu toți parametrii. Despachetează dicționarul cu client.messages.create(**parametri) sau scrie fiecare parametru cu numele lui. Î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.
