TypeError: 'NoneType' object is not iterable
La OpenAI Chat Completions, message.tool_calls este None (nu o listă goală) când modelul răspunde direct cu text. Un for apel in msg.tool_calls cade atunci. Verifică întâi if msg.tool_calls: sau parcurge msg.tool_calls or [].
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un for are nevoie de ceva iterabil: listă, tuplu, dicționar. None nu este, iar Python aruncă TypeError: 'NoneType' object is not iterable.
În aplicațiile cu tool-uri, None vine de obicei din r.choices[0].message.tool_calls. Când modelul hotărăște să cheme un tool, câmpul e o listă de apeluri; când răspunde direct (la „bună ziua” sau la o întrebare pentru care nu-i trebuie tool-ul), câmpul este None. Codul scris și testat doar pe cazul cu tool merge până la prima întrebare obișnuită.
Aceeași situație apare la orice câmp opțional al răspunsului: o listă care poate lipsi e None, nu [].
De ce apare: cauzele frecvente
1Bucla de tool-uri fără verificare
msg = r.choices[0].message
for apel in msg.tool_calls:
executa(apel)msg = r.choices[0].message
if msg.tool_calls:
for apel in msg.tool_calls:
executa(apel)
else:
print(msg.content)Fără tool-uri cerute, tool_calls este None. Ramura else tratează răspunsul text.
2Listă presupusă mereu prezentă
nume = [apel.function.name for apel in msg.tool_calls]nume = [apel.function.name for apel in msg.tool_calls or []]or [] înlocuiește None cu o listă goală, deci bucla nu face nimic când nu există apeluri.
Repară eroarea, direct în pagină
Asistentul de mai jos are tool-ul status_comanda. Prima întrebare cere tool-ul, dar a doua primește răspuns direct, iar programul cade cu 'NoneType' object is not iterable. Repară bucla: dacă msg.tool_calls există, afișează Tool: <nume> <argumente> pentru fiecare apel; altfel afișează Text: <conținut>.
from openai import OpenAI
MODEL = "gpt-6-luna"
client = OpenAI()
TOOLS = [{
"type": "function",
"function": {
"name": "status_comanda",
"description": "Întoarce statusul unei comenzi după număr.",
"parameters": {"type": "object", "properties": {"numar": {"type": "integer"}}, "required": ["numar"]},
},
}]
for intrebare in ["Ce status are comanda 2077?", "Care e programul magazinului?"]:
r = client.chat.completions.create(model=MODEL, messages=[{"role": "user", "content": intrebare}], tools=TOOLS)
msg = r.choices[0].message
for apel in msg.tool_calls:
print("Tool:", apel.function.name, apel.function.arguments)Tool: status_comanda {"numar": 2077}
Text: Suntem deschiși de luni până vineri, între 9 și 18.Indiciu
Pune if msg.tool_calls: înainte de for.
Reparația
from openai import OpenAI
MODEL = "gpt-6-luna"
client = OpenAI()
TOOLS = [{
"type": "function",
"function": {
"name": "status_comanda",
"description": "Întoarce statusul unei comenzi după număr.",
"parameters": {"type": "object", "properties": {"numar": {"type": "integer"}}, "required": ["numar"]},
},
}]
for intrebare in ["Ce status are comanda 2077?", "Care e programul magazinului?"]:
r = client.chat.completions.create(model=MODEL, messages=[{"role": "user", "content": intrebare}], tools=TOOLS)
msg = r.choices[0].message
if msg.tool_calls:
for apel in msg.tool_calls:
print("Tool:", apel.function.name, apel.function.arguments)
else:
print("Text:", msg.content)De ce merge
Când modelul răspunde direct, message.tool_calls este None, nu o listă goală, iar for nu poate parcurge None. Verificarea dinainte separă cele două cazuri: apelurile de tool-uri se tratează în buclă, iar răspunsul text se afișează pe ramura else. Astfel, asistentul merge și la întrebările care nu au nevoie de tool.
Alte forme ale mesajului
TypeError: object of type 'NoneType' has no len()TypeError: 'NoneType' object is not subscriptable
Cum o eviți pe viitor
- Tratează fiecare răspuns după
finish_reason:tool_calls(execuți tool-urile) saustop(afișezi textul). - Pentru câmpurile opționale, folosește
x or []înainte de buclă. - Testează bucla de tool-uri și cu o întrebare pentru care modelul nu are nevoie de tool.
Întrebări frecvente
La Claude apare la fel?
Nu în aceeași formă: la Claude, r.content e mereu o listă, iar cererile de tool-uri sunt blocuri tool_use în ea. Filtrezi blocurile după type, deci lista poate fi goală, dar nu None.
De ce SDK-ul nu întoarce o listă goală?
Câmpul reflectă JSON-ul trimis de API, în care tool_calls lipsește sau e null când nu există apeluri. SDK-ul îl transformă în None.
Erori înrudite
AttributeError: 'NoneType' object has no attribute 'strip' La OpenAI Chat Completions, message.content este None când modelul a ales să cheme un tool în loc să răspundă cu text. Verifică întâi message.tool_calls: dacă există, execută tool-urile; doar altfel citește și prelucrează content. TypeError: string indices must be integers, not 'str' La OpenAI, `item.arguments` dintr-un `function_call` este text JSON, nu dicționar, deci `item.arguments["oras"]` dă eroarea. Parsează-l întâi: `args = json.loads(item.arguments)`, apoi `args["oras"]`. AttributeError: 'ToolUseBlock' object has no attribute 'text' Ai citit `raspuns.content[0].text`, dar primul bloc nu e text: modelul a cerut un tool (`stop_reason == "tool_use"`), iar blocurile `tool_use` au `name` și `input`, nu `text`. Verifică `bloc.type` înainte să citești câmpurile și tratează apelul de tool. Î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.
