...
Eroare Aplicații AI cu LLM · Citirea răspunsului de la model

TypeError: Object of type TextBlock is not JSON serializable

Pe scurt

`json.dump` / `json.dumps` nu știe să salveze obiectele SDK-ului (`TextBlock`, `ToolUseBlock`, `Message`). Salvează textul (`bloc.text`) sau transformă obiectele în dicționare cu `bloc.model_dump()` înainte de `json.dumps`.

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

Ce înseamnă

Modulul json din Python știe să transforme în text doar tipurile de bază: dicționare, liste, șiruri, numere, True/False, None. Mesajul îți spune ce obiect a întâlnit și nu a știut să-l serializeze: un TextBlock, adică un bloc din response.content.

Situația tipică: chatbotul păstrează istoricul adăugând {"role": "assistant", "content": raspuns.content}. Pentru API asta e corect (SDK-ul acceptă blocurile înapoi), dar când vrei să salvezi conversația într-un fișier, în bază de date sau să o trimiți în browser, json.dumps dă peste obiecte. Același lucru se întâmplă cu ToolUseBlock, Message sau, la OpenAI, cu item-urile din response.output.

Ai două variante: salvezi doar textul ("content": text), care e și mai compact, sau transformi fiecare bloc în dicționar cu model_dump(), dacă ai nevoie de tot (de exemplu de blocurile tool_use).

De ce apare: cauzele frecvente

1Blocurile SDK-ului puse direct în istoricul salvat

Greșit
PYTHON
istoric.append({"role": "assistant", "content": raspuns.content})
json.dump(istoric, f)
Corect
PYTHON
text = "".join(b.text for b in raspuns.content if b.type == "text")
istoric.append({"role": "assistant", "content": text})
json.dump(istoric, f, ensure_ascii=False)

Un șir de caractere se salvează fără probleme, iar API-ul acceptă și textul simplu ca content.

2Păstrarea tuturor blocurilor, inclusiv tool_use

Greșit
PYTHON
json.dumps({"role": "assistant", "content": raspuns.content})
Corect
PYTHON
json.dumps({"role": "assistant", "content": [b.model_dump() for b in raspuns.content]})

model_dump() transformă fiecare bloc într-un dicționar cu aceleași câmpuri, pe care json îl poate scrie.

3Tot răspunsul salvat în log

Greșit
PYTHON
log.info(json.dumps(raspuns))
Corect
PYTHON
log.info(raspuns.model_dump_json())

Obiectul Message are propria metodă de serializare în JSON.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos salvează conversația ca JSON și dă TypeError: Object of type TextBlock is not JSON serializable. Repară adăugarea răspunsului în istoric: pune în content textul lipit din blocurile text, nu blocurile SDK-ului. Programul afișează JSON-ul conversației.

Codul care dă eroarea
PYTHON
import json

import anthropic

MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()

istoric = [{"role": "user", "content": "Ce program are service-ul auto sâmbăta?"}]
raspuns = client.messages.create(model=MODEL, max_tokens=200, messages=istoric)
istoric.append({"role": "assistant", "content": raspuns.content})

print(json.dumps(istoric, ensure_ascii=False, indent=1))
După reparație, programul afișează
[
 {
  "role": "user",
  "content": "Ce program are service-ul auto sâmbăta?"
 },
 {
  "role": "assistant",
  "content": "Sâmbăta service-ul e deschis între 9 și 14."
 }
]
Indiciu

Lipește textul cu "".join(b.text for b in raspuns.content if b.type == "text").

Alte forme ale mesajului

  • TypeError: Object of type ToolUseBlock is not JSON serializable
  • TypeError: Object of type Message is not JSON serializable
  • TypeError: Object of type ResponseFunctionToolCall is not JSON serializable

Cum o eviți pe viitor

  • Decide de la început formatul istoricului salvat: dicționare simple, cu content text sau liste de dicționare.
  • Transformă obiectele SDK-ului (cu model_dump()) într-un singur loc, la granița cu fișierul sau baza de date.
  • Pune ensure_ascii=False la json.dump, ca diacriticele să rămână lizibile în fișier.

Întrebări frecvente

Pot trimite înapoi la API istoricul încărcat din JSON?

Da. API-ul acceptă content ca text sau ca listă de dicționare cu aceleași câmpuri ca blocurile (type, text, id, name, input), exact ce produce model_dump().

Ce face default=str la json.dumps?

Transformă orice obiect necunoscut în textul lui de afișare. Scapă de eroare, dar salvează ceva de genul TextBlock(...), pe care nu îl mai poți refolosi ca mesaj. Folosește model_dump().

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.