Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Toetatud tüübid ja piirangud

Õppetund 3 / 12 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Mida skeemid ei suuda teha
  2. Kolm peamist piirangut
  3. Muud teadaolevad piirangud
  4. Strateegia: skeem + vihje
  5. Peamised punktid

Mida skeemid ei suuda teha

Struktureeritud väljundite piirangute mõistmine on sama oluline kui nende võimaluste valdamine. Grok API ei toeta teatud JSON Schema piiranguid. Nende kasutamine põhjustab vea või ootamatut käitumist.

Kolm peamist piirangut

allOf — kompositsioon pole lubatud

JSON Schema võtmesõna allOf ühendab mitu alamskeemi, mida objekt peab samaaegselt rahuldama. Grok API ei toeta seda funktsiooni.

// DOES NOT WORK
{
  "allOf": [
    { "properties": { "nom": { "type": "string" } } },
    { "properties": { "age": { "type": "number" } } }
  ]
}

Alternatiiv: kasuta kõigi omadustega ühte objekti:

// WORKS
{
  "type": "object",
  "properties": {
    "nom": { "type": "string" },
    "age": { "type": "number" }
  }
}

minLength / maxLength – stringi pikkuse piirangud puuduvad

Sa ei saa sundida mudelit looma stringi minimaalse või maksimaalse pikkusega.

// DOES NOT WORK
{
  "properties": {
    "code": {
      "type": "string",
      "minLength": 3,
      "maxLength": 10
    }
  }
}

Alternatiiv: määratle piirang vihjes (prompt), mitte skeemis:

messages=[{
    "role": "user",
    "content": "Generate a product code between 3 and 10 characters."
}]

Mudel järgib juhiseid enamikul juhtudel, kuid see pole garanteeritud nagu skeemi piirangu puhul.

minItems / maxItems – massiivi suuruse piirangud puuduvad

Sa ei saa jõustada elementide minimaalset ega maksimaalset arvu massiivis.

// DOES NOT WORK
{
  "properties": {
    "tags": {
      "type": "array",
      "items": { "type": "string" },
      "minItems": 1,
      "maxItems": 5
    }
  }
}

Alternatiiv: kasuta mudeli juhendamiseks vihjet:

messages=[{
    "role": "user",
    "content": "List between 1 and 5 relevant tags for this article."
}]

Muud teadaolevad piirangud

Regulaaravaldiste mustrid puuduvad

API ei toeta stringide pattern piiranguid. Sa ei saa skeemi kaudu jõustada e-posti formaati, UUID-d ega telefoninumbrit.

// DOES NOT WORK
{
  "properties": {
    "email": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
    }
  }
}

Vaikimisi väärtused puuduvad

Võtmesõnal default puudub mõju. Kui väli on skeemis olemas, täidab mudel selle alati.

Tingimuslikkus puudub

JSON Schema võtmesõnad if, then ja else pole saadaval.

Strateegia: skeem + vihje

Parim lähenemine ühendab mõlemat:

  1. Skeem garanteerib struktuuri: väljade nimed, tüübid, pesastamine
  2. Vihje juhendab sisu: pikkused, konkreetsed formaadid, ärireeglid
class Report(BaseModel):
    title: str
    summary: str
    key_points: list[str]
    score: float
    category: str

messages=[{
    "role": "user",
    "content": """Analyze this text and produce a report.
    - The summary must be 2-3 sentences.
    - List exactly 5 key points.
    - The score is between 0 and 10.
    - Category among: positive, negative, neutral."""
}]

Skeem garanteerib tüübid ja struktuuri. Vihje kontrollib väärtusi ja sisupiiranguid.

Peamised punktid

  • allOf, minLength, maxLength, minItems ja maxItems ei ole toetatud
  • Samuti ei toeta süsteem pattern, default ega if/then/else piiranguid
  • Kasuta võimalusel allOf asemel anyOf
  • Viia sisupiirangud vihjesse
  • Skeemi (struktuur) ja vihje (sisu) kombinatsioon on optimaalne strateegia