...
Eroare Aplicații AI cu LLM · Șabloane de prompt și formatarea textului

IndexError: Replacement index 1 out of range for positional args tuple

Pe scurt

Ș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ă

Greșit
PYTHON
SABLON = "Produs: {}\nÎntrebare: {}"
prompt = SABLON.format(intrebare)
Corect
PYTHON
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ă

Greșit
PYTHON
prompt = SABLON.format([produs, intrebare])
Corect
PYTHON
prompt = SABLON.format(*[produs, intrebare])

* despachetează lista în argumente separate; fără el, lista e un singur argument.

Repară tu

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.

Codul care dă eroarea
PYTHON
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?"))
După reparație, programul afișează
Da, Laptop Nova 14 are un port HDMI 2.1 pe partea stângă.
Indiciu

SABLON.format(produs=produs, intrebare=intrebare).

Alte forme ale mesajului

  • IndexError: Replacement index 2 out of range for positional args tuple
  • IndexError: 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

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