Imposta response_format
La modalità JSON è utile per un oggetto semplice. JSON Schema aggiunge il nome dello schema, la struttura dei campi, le proprietà obbligatorie e un modo per rifiutare le proprietà aggiuntive.
Uno schema rigoroso riduce l'analisi difensiva, ma non sostituisce mai la convalida lato applicazione.
Formato di risposta 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
}
}
}
}Progetta lo schema
- Mantieni campi e descrizioni concisi e specifici per il dominio.
- Imposta additionalProperties: false dove i campi sconosciuti non sono accettabili.
- Versiona gli schemi nel tuo codice invece di modificare in modo invisibile il contratto su cui fanno affidamento i sistemi che utilizzano i dati.
Gestisci il risultato
Convalida il JSON restituito con lo stesso validatore usato dalla tua API o dal database.
Se un modello o un percorso non accetta il formato richiesto, mostra un errore controllato e seleziona un'opzione compatibile tramite il catalogo dei modelli.