Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Nepodporované typy a obmedzenia

Lekcia 3 z 12 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Čo schémy nedokážu
  2. Tri hlavné obmedzenia
  3. Ďalšie obmedzenia, ktoré by si mal poznať
  4. Stratégia: schéma + prop
  5. Kľúčové poznatky

Čo schémy nedokážu

Pochopenie limitov štruktúrovaných výstupov je rovnako dôležité ako zvládnutie ich možností. API Grok nepodporuje určité obmedzenia JSON Schema. Ich použitie vyvolá chybu alebo spôsobí neočakávané správanie.

Tri hlavné obmedzenia

allOf — kompozícia nie je povolená

V JSON Schema kľúčové slovo allOf spája viacero podschiem, ktorým musí objekt vyhovovať súčasne. API Grok túto funkciu nepodporuje.

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

Alternatíva: použite jeden objekt so všetkými vlastnosťami:

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

minLength / maxLength — žiadne obmedzenia dĺžky reťazca

Nemôžeš prinútiť model vygenerovať reťazec s minimálnou alebo maximálnou dĺžkou.

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

Alternatíva: špecifikuj obmedzenie priamo v propte namiesto schémy:

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

Model pokyn vo väčšine prípadov dodrží, ale nie je to garantované tak ako pri obmedzení v schéme.

minItems / maxItems — žiadne obmedzenia veľkosti poľa

Nemôžeš vynútiť minimálny alebo maximálny počet prvkov v poli.

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

Alternatíva: použi prop na nasmerovanie modelu:

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

Ďalšie obmedzenia, ktoré by si mal poznať

Žiadne regulárne výrazy

API nepodporuje obmedzenia pattern pre reťazce. Nemôžeš vynútiť formát e-mailu, UUID alebo telefónneho čísla prostredníctvom schémy.

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

Žiadne predvolené hodnoty

Kľúčové slovo default nemá žiadny účinok. Ak je pole v schéme, model ho vždy vyplní.

Žiadne podmienky

Kľúčové slová JSON Schema if, then a else nie sú dostupné.

Stratégia: schéma + prop

Najlepší prístup kombinuje obe zložky:

  1. Schéma garantuje štruktúru: názvy polí, typy, vnorenie
  2. Prop usmerňuje obsah: dĺžky, špecifické formáty, business pravidlá
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."""
}]

Schéma garantuje typy a štruktúru. Prop riadi hodnoty a obmedzenia obsahu.

Kľúčové poznatky

  • allOf, minLength, maxLength, minItems a maxItems nie sú podporované
  • Obmedzenia pattern, default a if/then/else tiež nie sú podporované
  • Keď je to možné, použite anyOf namiesto allOf
  • Presuňte obmedzenia obsahu do propu
  • Kombinácia schémy (štruktúra) + prop (obsah) je optimálna stratégia