TypeError: verifica_stoc() argument after ** must be a mapping, not str
La OpenAI, argumentele unui function call vin ca text JSON (apel.arguments este un str), iar ** cere un dicționar. Parsează-le întâi: functie(**json.loads(apel.arguments)). La Claude, bloc.input e deja dicționar.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Operatorul despachetează un dicționar în argumente cu nume: f({"produs": "geacă"}) devine f(produs="geacă"). Mesajul spune că după ** ai pus un șir de caractere, care nu poate fi despachetat.
În function calling cu OpenAI (Responses API și Chat Completions), argumentele generate de model vin ca text JSON: apel.arguments == '{"produs": "geaca de ploaie"}'. La Claude, bloc.input e deja dicționar, de aceea codul mutat de la un furnizor la altul cade aici.
În Python 3.12 mesajul include și modulul: __main__.verifica_stoc() argument after ** must be a mapping, not str. Numele funcției din mesaj e tool-ul pe care încercai să-l execuți.
De ce apare: cauzele frecvente
1Argumentele OpenAI despachetate fără parsare
rezultat = FUNCTII[apel.name](**apel.arguments)args = json.loads(apel.arguments)
rezultat = FUNCTII[apel.name](**args)json.loads transformă textul JSON în dicționar, iar dicționarul se poate despacheta cu **.
2Cod de la Claude folosit la OpenAI
# merge la Claude: bloc.input e dict
rezultat = verifica_stoc(**apel.arguments)rezultat = verifica_stoc(**json.loads(apel.arguments))Structurile diferă: Claude dă input ca dicționar, OpenAI dă arguments ca text.
Repară eroarea, direct în pagină
Asistentul de stoc folosește function calling din OpenAI Responses API. Modelul cere tool-ul, dar execuția cade cu verifica_stoc() argument after must be a mapping, not str. Repară linia care execută tool-ul: parsează apel.arguments cu json.loads înainte de . Programul afișează răspunsul final al modelului.
import json
from openai import OpenAI
MODEL = "gpt-6-luna"
client = OpenAI()
TOOLS = [{
"type": "function",
"name": "verifica_stoc",
"description": "Întoarce câte bucăți sunt în stoc dintr-un produs.",
"parameters": {"type": "object", "properties": {"produs": {"type": "string"}}, "required": ["produs"]},
}]
STOC = {"geaca de ploaie": 7}
def verifica_stoc(produs):
return f"{STOC.get(produs, 0)} bucăți"
FUNCTII = {"verifica_stoc": verifica_stoc}
intrari = [{"role": "user", "content": "Mai aveți geaca de ploaie?"}]
r = client.responses.create(model=MODEL, input=intrari, tools=TOOLS)
intrari += r.output
for apel in [item for item in r.output if item.type == "function_call"]:
rezultat = FUNCTII[apel.name](**apel.arguments)
intrari.append({"type": "function_call_output", "call_id": apel.call_id, "output": rezultat})
r = client.responses.create(model=MODEL, input=intrari, tools=TOOLS)
print(r.output_text)Da, mai avem 7 bucăți din geaca de ploaie.
Indiciu
FUNCTII[apel.name](**json.loads(apel.arguments))
Reparația
import json
from openai import OpenAI
MODEL = "gpt-6-luna"
client = OpenAI()
TOOLS = [{
"type": "function",
"name": "verifica_stoc",
"description": "Întoarce câte bucăți sunt în stoc dintr-un produs.",
"parameters": {"type": "object", "properties": {"produs": {"type": "string"}}, "required": ["produs"]},
}]
STOC = {"geaca de ploaie": 7}
def verifica_stoc(produs):
return f"{STOC.get(produs, 0)} bucăți"
FUNCTII = {"verifica_stoc": verifica_stoc}
intrari = [{"role": "user", "content": "Mai aveți geaca de ploaie?"}]
r = client.responses.create(model=MODEL, input=intrari, tools=TOOLS)
intrari += r.output
for apel in [item for item in r.output if item.type == "function_call"]:
args = json.loads(apel.arguments) # textul JSON devine dicționar
rezultat = FUNCTII[apel.name](**args)
intrari.append({"type": "function_call_output", "call_id": apel.call_id, "output": rezultat})
r = client.responses.create(model=MODEL, input=intrari, tools=TOOLS)
print(r.output_text)De ce merge
În OpenAI, apel.arguments e textul JSON generat de model, iar ** acceptă doar dicționare. json.loads transformă textul în {"produs": "geaca de ploaie"}, care se despachetează în verifica_stoc(produs="geaca de ploaie"). Rezultatul ajunge înapoi la model ca function_call_output, legat prin call_id, iar modelul formulează răspunsul pentru client.
Alte forme ale mesajului
TypeError: __main__.verifica_stoc() argument after ** must be a mapping, not strTypeError: verifica_stoc() argument after ** must be a mapping, not NoneType
Cum o eviți pe viitor
- Scrie o singură funcție
argumente(apel)care întoarce mereu un dicționar, indiferent de furnizor. - Validează argumentele după parsare (câmpuri obligatorii, tipuri) înainte să execuți tool-ul.
- Prinde
json.JSONDecodeErrorla parsare și trimite modelului un rezultat de eroare, în loc să oprești aplicația.
Întrebări frecvente
De ce OpenAI trimite argumentele ca text?
Așa le generează modelul: un text JSON. API-ul ți-l dă neatins, iar parsarea e responsabilitatea ta. Cu strict: True textul respectă schema, dar tot text este.
Ce înseamnă varianta cu NoneType?
Ai pus după ** o valoare None, de exemplu rezultatul unei funcții de parsare care nu a returnat nimic. Verifică funcția care pregătește argumentele.
Erori înrudite
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"]`. TypeError: verifica_stoc() got an unexpected keyword argument 'marime' Ai apelat funcția tool-ului cu argumentele modelului (`functie(**bloc.input)`), iar modelul a trimis un argument pe care funcția nu îl are. Fă funcția să accepte toate proprietățile din schemă (cu valori implicite pentru cele opționale) și validează argumentele înainte de apel. openai.BadRequestError: Error code: 400 - No tool call found for function call output with call_id call_abc123. Ai trimis la OpenAI un `function_call_output`, dar în `input` nu există apelul de funcție (`function_call`) cu același `call_id`. Înainte să adaugi rezultatele, adaugă în listă item-urile din răspunsul modelului: `intrari += r.output`. Î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.
