Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Nepodržani tipovi i ograničenja

Lekcija 3 od 12 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Što sheme ne mogu učiniti
  2. Tri glavna ograničenja
  3. Ostala ograničenja koja trebaš znati
  4. Strategija: shema + prompt
  5. Ključne točke

Što sheme ne mogu učiniti

Razumijevanje ograničenja strukturiranih izlaza jednako je važno kao i savladavanje njihovih mogućnosti. Grok API ne podržava određena ograničenja JSON Sheme. Pokušaj njihova korištenja izazvat će pogrešku ili uzrokovati neočekivano ponašanje.

Tri glavna ograničenja

allOf — sastavljanje nije dopušteno

U JSON Shemi, ključna riječ allOf kombinira više podshema kojima objekt mora istovremeno zadovoljiti. Grok API ne podržava ovu značajku.

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

Alternativa: upotrijebi jedan objekt sa svim svojstvima:

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

minLength / maxLength — nema ograničenja duljine niza

Ne možeš prisiliti model da proizvede niz znakova s minimalnom ili maksimalnom duljinom.

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

Alternativa: navedi ograničenje u promptu umjesto u shemi:

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

Model će u većini slučajeva slijediti uputu, ali to nije zajamčeno kao što bi bilo kod ograničenja sheme.

minItems / maxItems — nema ograničenja veličine polja

Ne možeš nametnuti minimalan ili maksimalan broj elemenata u polju.

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

Alternativa: upotrijebi prompt za vođenje modela:

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

Ostala ograničenja koja trebaš znati

Nema regex uzoraka

API ne podržava ograničenja pattern na nizovima znakova. Ne možeš nametnuti format e-pošte, UUID ili telefonski broj putem sheme.

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

Nema zadanih vrijednosti

Ključna riječ default nema učinka. Ako je polje u shemi, model će ga uvijek popuniti.

Nema uvjetnih izraza

Ključne riječi JSON Sheme if, then i else nisu dostupne.

Strategija: shema + prompt

Najbolji pristup kombinira oboje:

  1. Shema jamči strukturu: nazive polja, tipove, ugnježđivanje
  2. Prompt usmjerava sadržaj: duljine, 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 jamči tipove i strukturu. Prompt kontrolira vrijednosti i ograničenja sadržaja.

Ključne točke

  • allOf, minLength, maxLength, minItems i maxItems nisu podržani
  • Ograničenja pattern, default i if/then/else također nisu podržana
  • Kada je moguće, upotrijebi anyOf umjesto allOf
  • Prebaci ograničenja sadržaja na prompt
  • Kombiniranje sheme (struktura) + prompta (sadržaj) optimalna je strategija