Tetapkan response_format
Mod JSON berguna untuk objek ringkas. JSON Schema menambah nama skema, struktur medan, sifat yang diperlukan dan cara untuk menolak sifat tambahan.
Skema ketat mengurangkan keperluan penghuraian defensif, tetapi tidak pernah menggantikan pengesahan pada pihak aplikasi.
Format respons 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
}
}
}
}Reka bentuk skema
- Pastikan medan dan perihalan ringkas serta khusus untuk domain.
- Tetapkan additionalProperties: false apabila medan yang tidak diketahui tidak boleh diterima.
- Berikan versi kepada skema dalam kod anda sendiri dan bukannya mengubah kontrak pengguna secara tidak kelihatan.
Kendalikan hasil
Sahkan JSON yang dikembalikan dengan pengesah sama yang digunakan oleh API atau pangkalan data anda.
Jika model atau laluan tidak menerima format yang diminta, paparkan ralat terkawal dan pilih pilihan serasi melalui katalog model.