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

ValueError: Invalid format specifier ' "Ana"' for object of type 'str'

Pe scurt

Ai pus un exemplu JSON direct într-un f-string, iar Python a citit {"nume": "Ana"} ca expresia "nume" urmată de specificatorul de format "Ana". Dublează acoladele exemplului în f-string ({{ și }}) sau adaugă exemplul JSON separat, fără f-string.

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

Ce înseamnă

Într-un f-string, tot ce e între acolade se evaluează ca expresie Python, iar ce urmează după : e un specificator de format (de exemplu {pret:.2f}). Pentru {"nume": "Ana"}, Python evaluează textul "nume", apoi încearcă să-l formateze cu specificatorul "Ana", care nu înseamnă nimic. De aici mesajul, care arată exact specificatorul respins și tipul valorii.

Eroarea apare când construiești prompturi cu f-string-uri și pui în ele un exemplu de răspuns JSON. Variante: NameError, dacă în acolade e un cuvânt fără ghilimele ({nume}), sau exemplul apare greșit în prompt fără nicio eroare.

În versiunile mai vechi de Python, mesajul e mai scurt: Invalid format specifier.

De ce apare: cauzele frecvente

1Exemplu JSON într-un f-string

Greșit
PYTHON
prompt = f'Răspunde ca JSON: {"nume": "Ana"}. Mesaj: {mesaj}'
Corect
PYTHON
prompt = f'Răspunde ca JSON: {{"nume": "Ana"}}. Mesaj: {mesaj}'

{{ și }} produc acolade literale, iar {mesaj} rămâne expresie.

2Exemplu lung amestecat cu variabile

Greșit
PYTHON
prompt = f"""Formatul: {"nume": "...", "total": 0}
Factura: {text}"""
Corect
PYTHON
EXEMPLU = '{"nume": "...", "total": 0}'
prompt = "Formatul: " + EXEMPLU + "\nFactura: " + text

Exemplul ține într-o constantă normală, fără f-string, deci acoladele nu mai sunt evaluate.

Repară tu

Repară eroarea, direct în pagină

Promptul pentru extragerea datelor din facturi e construit cu un f-string care conține un exemplu JSON, iar programul cade cu ValueError: Invalid format specifier .... Repară f-string-ul, ca exemplul să apară cu acolade simple în prompt, și afișează furnizorul și totalul extrase.

Codul care dă eroarea
PYTHON
import json

import anthropic

MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
factura = "Furnizor: Electrica Nord SRL. Total de plată: 245,30 lei."

prompt = f'Extrage datele ca JSON: {"furnizor": "...", "total": 0}\nFactura: {factura}'
r = client.messages.create(model=MODEL, max_tokens=200, messages=[{"role": "user", "content": prompt}])
date = json.loads(r.content[0].text)
print("Furnizor:", date["furnizor"])
print("Total:", date["total"], "lei")
După reparație, programul afișează
Furnizor: Electrica Nord SRL
Total: 245.3 lei
Indiciu

În f-string, acoladele exemplului se scriu {{ și }}; {factura} rămâne simplu.

Alte forme ale mesajului

  • ValueError: Invalid format specifier
  • ValueError: Invalid format specifier ' "...", "email": "..."' for object of type 'str'
  • NameError: name 'nume' is not defined

Cum o eviți pe viitor

  • Nu pune exemple JSON sau cod direct în f-string-uri; ține-le în constante separate.
  • Dacă le pui, dublează fiecare acoladă care nu e o expresie.
  • Pentru JSON garantat, folosește ieșirea structurată cu schemă în loc de un exemplu în text.
  • Afișează promptul final o dată, ca să vezi exact ce primește modelul.

Întrebări frecvente

De ce mesajul conține „for object of type 'str'”?

Pentru că expresia evaluată a fost textul "nume", adică un str, iar specificatorul de după : nu e valid pentru texte.

Pot folosi json.dumps într-un f-string?

Da: f"Format: {json.dumps(EXEMPLU)}" e corect, pentru că acoladele conțin o expresie validă, iar rezultatul ei e textul JSON.

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.