openai.BadRequestError: Error code: 400 - Invalid schema for function 'rezerva_masa': In context=(), 'additionalProperties' is required to be supplied and to be false.
Cu "strict": True, OpenAI cere ca schema fiecărui obiect din parametrii tool-ului să aibă "additionalProperties": False și ca toate proprietățile să fie în required. Adaugă additionalProperties: False la fiecare nivel de obiect; câmpurile opționale le faci de tip ["string", "null"].
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Modul strict (Structured Outputs pentru tool-uri) garantează că argumentele generate respectă exact schema. Pentru asta, OpenAI acceptă doar un subset de JSON Schema, cu două reguli importante: fiecare obiect are additionalProperties: false, iar required conține toate cheile din properties.
Mesajul îți spune funcția (rezerva_masa) și locul din schemă: context=() este rădăcina parametrilor; pentru un obiect imbricat apare calea, de exemplu context=('properties', 'client').
Varianta cu 'required' is required to be supplied and to be an array including every key in properties apare când lipsește o cheie din required. Un câmp opțional se declară atunci obligatoriu, dar cu tip care permite null.
În editorul nostru, simulatorul afișează un mesaj mai scurt, cu aceeași cauză.
De ce apare: cauzele frecvente
1Lipsește additionalProperties: False
"parameters": {"type": "object", "properties": {...}, "required": [...]},
"strict": True"parameters": {"type": "object", "properties": {...}, "required": [...],
"additionalProperties": False},
"strict": TrueÎn modul strict, schema trebuie să interzică explicit câmpurile neprevăzute.
2Câmp opțional lăsat în afara lui required
"properties": {"persoane": {"type": "integer"}, "observatii": {"type": "string"}},
"required": ["persoane"]"properties": {"persoane": {"type": "integer"}, "observatii": {"type": ["string", "null"]}},
"required": ["persoane", "observatii"]Strict cere toate cheile în required; opționalitatea se exprimă prin null.
3Obiect imbricat fără regulă
"client": {"type": "object", "properties": {"nume": {"type": "string"}}, "required": ["nume"]}"client": {"type": "object", "properties": {"nume": {"type": "string"}}, "required": ["nume"],
"additionalProperties": False}Regula se aplică fiecărui obiect din schemă, nu doar rădăcinii.
Repară eroarea, direct în pagină
Tool-ul rezerva_masa e declarat cu "strict": True, dar OpenAI respinge cererea cu 'additionalProperties' is required to be supplied and to be false. Repară schema parametrilor: adaugă "additionalProperties": False, păstrând persoane și ora în required. Programul afișează Modelul cere: <nume> <argumente>.
from openai import OpenAI
MODEL = "gpt-6-luna"
client = OpenAI()
TOOLS = [{
"type": "function",
"name": "rezerva_masa",
"description": "Rezervă o masă la restaurant pentru un număr de persoane, la o oră din seara curentă.",
"parameters": {
"type": "object",
"properties": {
"persoane": {"type": "integer", "description": "numărul de persoane"},
"ora": {"type": "string", "description": "ora, în formatul HH:MM"},
},
"required": ["persoane", "ora"],
},
"strict": True,
}]
r = client.responses.create(model=MODEL, input="Vreau o masă pentru 4 persoane la 19:30.", tools=TOOLS)
for item in r.output:
if item.type == "function_call":
print("Modelul cere:", item.name, item.arguments)Modelul cere: rezerva_masa {"persoane": 4, "ora": "19:30"}Indiciu
"additionalProperties": False stă în dicționarul parameters, lângă required.
Reparația
from openai import OpenAI
MODEL = "gpt-6-luna"
client = OpenAI()
TOOLS = [{
"type": "function",
"name": "rezerva_masa",
"description": "Rezervă o masă la restaurant pentru un număr de persoane, la o oră din seara curentă.",
"parameters": {
"type": "object",
"properties": {
"persoane": {"type": "integer", "description": "numărul de persoane"},
"ora": {"type": "string", "description": "ora, în formatul HH:MM"},
},
"required": ["persoane", "ora"],
"additionalProperties": False,
},
"strict": True,
}]
r = client.responses.create(model=MODEL, input="Vreau o masă pentru 4 persoane la 19:30.", tools=TOOLS)
for item in r.output:
if item.type == "function_call":
print("Modelul cere:", item.name, item.arguments)De ce merge
În modul strict, OpenAI acceptă doar scheme închise: fiecare obiect trebuie să interzică explicit câmpurile neprevăzute, iar toate proprietățile trebuie să fie în required. Cu additionalProperties: False, schema e validă, iar modelul generează argumente care respectă exact cele două câmpuri, fără chei inventate.
Alte forme ale mesajului
openai.BadRequestError: Error code: 400 - Invalid schema for function 'rezerva_masa': In context=(), 'required' is required to be supplied and to be an array including every key in properties. Missing 'ora'.openai.BadRequestError: Error code: 400 - Invalid schema for response_format 'contact': In context=(), 'additionalProperties' is required to be supplied and to be false.
Cum o eviți pe viitor
- Scrie o funcție care completează schema pentru modul strict:
additionalProperties: Falseșirequiredcu toate cheile, la fiecare nivel. - Pentru câmpuri opționale folosește tipuri cu
null. - Ține schemele într-un singur modul, testat o dată, și refolosește-le pentru tool-uri și pentru
text.format.
Întrebări frecvente
Pot renunța la strict?
Da, fără strict: True schema e acceptată și fără aceste reguli, dar modelul nu mai e obligat să o respecte exact. Pentru tool-uri care modifică date, modul strict merită efortul.
La Claude se aplică aceleași reguli?
La Claude, tool-urile folosesc input_schema. additionalProperties: False este recomandat și acolo, mai ales cu strict: True și cu ieșire structurată.
Erori înrudite
anthropic.BadRequestError: Error code: 400 - tools.0.input_schema: Field required Definiția tool-ului trimisă la Claude nu are câmpul `input_schema`. De obicei e o definiție în format OpenAI (`parameters` sau `{"type": "function", "function": {...}}`): la Claude, tool-ul are `name`, `description` și `input_schema`, o schemă JSON de tip `object`. 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"]`. openai.BadRequestError: Error code: 400 - Missing required parameter: 'text.format.name'. La OpenAI Responses API, formatul json_schema din text.format are nevoie de un nume (name), pe lângă type și schema. Adaugă "name": "..." (litere, cifre, _ și -) în dicționarul format. Î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.
