...
Eroare Aplicații AI cu LLM · Tool use și function calling

TypeError: 'NoneType' object is not iterable

Pe scurt

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

Greșit
PYTHON
msg = r.choices[0].message
for apel in msg.tool_calls:
    executa(apel)
Corect
PYTHON
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ă

Greșit
PYTHON
nume = [apel.function.name for apel in msg.tool_calls]
Corect
PYTHON
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ă tu

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

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
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.

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) sau stop (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

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