cicora.ai
API-specifikációSémabiztos kimenet

Strukturált kimenetek

Kérjen JSON-objektumot vagy JSON Schema sémát, ha a választ ember helyett szoftver fogja feldolgozni.

Integrációs referencia: válassza ki a paramétereket és az elérhető képességeket a fiókja API-beállításaiból és a környezetéhez tartozó modellkatalógusból.

A response_format beállítása

A JSON mód egyszerű objektumhoz hasznos. A JSON Schema sémanevet, mezőstruktúrát, kötelező tulajdonságokat és a többlettulajdonságok elutasításának módját adja hozzá.

A szigorú séma csökkenti a védekező elemzés szükségességét, de soha nem helyettesíti az alkalmazásoldali ellenőrzést.

JSON Schema válaszformátum
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
      }
    }
  }
}

A séma megtervezése

  • A mezők és leírások legyenek tömörek és szakterület-specifikusak.
  • Állítsa az additionalProperties: false értéket ott, ahol az ismeretlen mezők nem elfogadhatók.
  • A sémákat saját kódjában verziózza, ahelyett hogy észrevétlenül módosítaná a sémára épülő rendszerek felé vállalt szerződést.

Az eredmény kezelése

A visszaadott JSON-t ugyanazzal az ellenőrzővel validálja, amelyet az API-ja vagy adatbázisa használ.

Ha egy modell vagy útvonal nem fogadja el a kért formátumot, jelezzen kezelt hibát, és a modellkatalóguson keresztül válasszon kompatibilis lehetőséget.