Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Nepodprti tipi in omejitve

Lekcija 3 od 12 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Kaj sheme ne zmorejo
  2. Tri glavne omejitve
  3. Druge omejitve, ki jih moraš poznati
  4. Strategija: shema + poziv
  5. Ključne ugotovitve

Kaj sheme ne zmorejo

Razumevanje omejitev strukturiranih izhodov je enako pomembno kot obvladovanje njihovih zmožnosti. API Grok ne podpira določenih omejitev JSON Schema. Če jih poskušaš uporabiti, se bo sprožila napaka ali pa bo prišlo do nepričakovanega obnašanja.

Tri glavne omejitve

allOf — sestavljanje ni dovoljeno

V JSON Schema ključna beseda allOf združi več podshem, ki jih mora objekt izpolnjevati hkrati. API Grok te funkcije ne podpira.

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

Alternativa: uporabi en sam objekt z vsemi lastnostmi:

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

minLength / maxLength — brez omejitev dolžine niza

Modela ne moreš prisiliti, da ustvari niz z najmanjšo ali največjo dolžino.

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

Alternativa: omejitev določi v pozivu namesto v shemi:

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

Model bo navodilo v večini primerov upošteval, vendar to ni zagotovljeno tako kot pri omejitvi sheme.

minItems / maxItems — brez omejitev velikosti polja

Ne moreš vsiliti najmanjšega ali največjega števila elementov v polju.

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

Alternativa: za usmerjanje modela uporabi poziv:

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

Druge omejitve, ki jih moraš poznati

Brez vzorcev regularnih izrazov

API ne podpira omejitev pattern za nize. Prek sheme ne moreš vsiliti formata e-pošte, UUID ali telefonske številke.

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

Brez privzetih vrednosti

Ključna beseda default nima učinka. Če je polje v shemi, ga bo model vedno izpolnil.

Brez pogojnih stavkov

Ključne besede JSON Schema if, then in else niso na voljo.

Strategija: shema + poziv

Najboljši pristop združuje oboje:

  1. Shema zagotavlja strukturo: imena polj, tipe, gnezdenje
  2. Poziv usmerja vsebino: dolžine, specifične formate, poslovna pravila
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."""
}]

Shema zagotavlja tipe in strukturo. Poziv nadzira vrednosti in omejitve vsebine.

Ključne ugotovitve

  • allOf, minLength, maxLength, minItems in maxItems niso podprti
  • Omejitve pattern, default in if/then/else prav tako niso podprte
  • Kadar je mogoče, uporabi anyOf namesto allOf
  • Omejitve vsebine prenesi na poziv
  • Kombinacija sheme (struktura) in poziva (vsebina) je optimalna strategija