cicora.ai
API specifikacijaSchemą atitinkanti išvestis

Struktūrizuota išvestis

Prašykite JSON objekto arba JSON Schema, kai atsakymą naudos programinė įranga, o ne žmogus.

Integracijų žinynas: savo paskyros API nustatymuose ir jūsų aplinkos modelių kataloge pasirinkite parametrus bei galimas funkcijas.

Nustatykite response_format

JSON režimas naudingas paprastam objektui. JSON Schema prideda schemos pavadinimą, laukų struktūrą, privalomas savybes ir būdą atmesti papildomas savybes.

Griežta schema sumažina apsauginio analizavimo poreikį, tačiau niekada nepakeičia patikros programos pusėje.

JSON Schema atsakymo formatas
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
      }
    }
  }
}

Sukurkite schemą

  • Laukai ir aprašai turi būti glausti ir pritaikyti sričiai.
  • Nustatykite additionalProperties: false, kai nežinomi laukai nepriimtini.
  • Schemų versijas valdykite savo kode, užuot nepastebimai keitę sutartį, kuria remiasi schemas naudojančios sistemos.

Apdorokite rezultatą

Gautą JSON patikrinkite tuo pačiu tikrintuvu, kurį naudoja jūsų API arba duomenų bazė.

Jei modelis ar maršrutas nepriima prašomo formato, pateikite valdomą klaidą ir per modelių katalogą pasirinkite suderinamą parinktį.