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

openai.BadRequestError: Error code: 400 - Invalid schema for function 'rezerva_masa': In context=(), 'additionalProperties' is required to be supplied and to be false.

Pe scurt

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

Greșit
PYTHON
"parameters": {"type": "object", "properties": {...}, "required": [...]},
"strict": True
Corect
PYTHON
"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

Greșit
PYTHON
"properties": {"persoane": {"type": "integer"}, "observatii": {"type": "string"}},
"required": ["persoane"]
Corect
PYTHON
"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ă

Greșit
PYTHON
"client": {"type": "object", "properties": {"nume": {"type": "string"}}, "required": ["nume"]}
Corect
PYTHON
"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ă tu

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

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
Modelul cere: rezerva_masa {"persoane": 4, "ora": "19:30"}
Indiciu

"additionalProperties": False stă în dicționarul parameters, lângă required.

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 și required cu 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

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