Nastavení response_format
Režim JSON je užitečný pro jednoduchý objekt. JSON Schema přidává název schématu, strukturu polí, povinné vlastnosti a možnost odmítnout další vlastnosti.
Přísné schéma omezuje potřebu obranného zpracování, nikdy však nenahrazuje ověřování na straně aplikace.
Formát odpovědi JSON Schema
json
{
"model": "openai/gpt-5.6-sol",
"messages": [{"role": "user", "content": "Extract an order summary."}],
"response_format": {
"type": "json_schema",
"json_schema": {
"name": "order_summary",
"strict": true,
"schema": {
"type": "object",
"properties": {"items": {"type": "array"}, "total": {"type": "number"}},
"required": ["items", "total"],
"additionalProperties": false
}
}
}
}Návrh schématu
- Pole a popisy udržujte stručné a specifické pro danou oblast.
- Tam, kde neznámá pole nejsou přípustná, nastavte additionalProperties: false.
- Verzujte schémata ve vlastním kódu, místo abyste nepozorovaně měnili kontrakt, na který spoléhají jeho odběratelé.
Zpracování výsledku
Vrácený JSON ověřte stejným validátorem, který používá vaše API nebo databáze.
Pokud model nebo trasa nepřijímá požadovaný formát, zobrazte řízenou chybu a prostřednictvím katalogu modelů vyberte kompatibilní možnost.