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

TypeError: verifica_stoc() argument after ** must be a mapping, not str

Pe scurt

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

Greșit
PYTHON
rezultat = FUNCTII[apel.name](**apel.arguments)
Corect
PYTHON
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

Greșit
PYTHON
# merge la Claude: bloc.input e dict
rezultat = verifica_stoc(**apel.arguments)
Corect
PYTHON
rezultat = verifica_stoc(**json.loads(apel.arguments))

Structurile diferă: Claude dă input ca dicționar, OpenAI dă arguments ca text.

Repară tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
Da, mai avem 7 bucăți din geaca de ploaie.
Indiciu

FUNCTII[apel.name](**json.loads(apel.arguments))

Alte forme ale mesajului

  • TypeError: __main__.verifica_stoc() argument after ** must be a mapping, not str
  • TypeError: 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.JSONDecodeError la 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

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