Rakenteiset tulosteet

Määritä response_format

JSON-tila sopii yksinkertaiselle objektille. JSON Schema lisää skeeman nimen, kenttärakenteen, pakolliset ominaisuudet ja tavan hylätä ylimääräiset ominaisuudet.

Tiukka skeema vähentää puolustavaa jäsennystä, mutta ei koskaan korvaa sovelluspuolen validointia.

{
  "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
      }
    }
  }
}

Suunnittele skeema

• Pidä kentät ja kuvaukset tiiviinä ja toimialakohtaisina.
• Määritä additionalProperties: false, kun tuntemattomia kenttiä ei hyväksytä.
• Versioi skeemat omassa koodissasi sen sijaan, että muuttaisit huomaamatta sopimusta, johon skeemaa käyttävät järjestelmät luottavat.

Käsittele tulos

Vahvista palautettu JSON samalla validaattorilla, jota API tai tietokantasi käyttää.

Jos malli tai reitti ei hyväksy pyydettyä muotoa, näytä hallittu virhe ja valitse yhteensopiva vaihtoehto malliluettelon kautta.