Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Nepodporované typy a omezení

Lekce 3 z 12 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Co schémata neumí
  2. Tři hlavní omezení
  3. Další omezení, která bys měl znát
  4. Strategie: schéma + prompt
  5. Klíčové poznatky

Co schémata neumí

Pochopení limitů strukturovaných výstupů je stejně důležité jako zvládnutí jejich možností. API Grok nepodporuje určitá omezení JSON Schema. Pokus o jejich použití vyvolá chybu nebo způsobí neočekávané chování.

Tři hlavní omezení

allOf — kompozice není povolena

V JSON Schema klíčové slovo allOf kombinuje více podschémat, kterým musí objekt vyhovět současně. API Grok tuto funkci nepodporuje.

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

Alternativa: použij jeden objekt se všemi vlastnostmi:

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

minLength / maxLength — žádná omezení délky řetězce

Nemůžeš model donutit vygenerovat řetězec s minimální nebo maximální délkou.

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

Alternativa: specifikuj omezení přímo v promptu místo ve schématu:

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

Model instrukci ve většině případů dodrží, ale není to tak zaručené jako u omezení definovaného ve schématu.

minItems / maxItems — žádná omezení velikosti pole

Nemůžeš vynutit minimální nebo maximální počet prvků v poli.

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

Alternativa: použij prompt k navedení modelu:

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

Další omezení, která bys měl znát

Žádné regulární výrazy

API nepodporuje omezení pattern pro řetězce. Nemůžeš přes schéma vynutit formát e-mailu, UUID nebo telefonního čísla.

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

Žádné výchozí hodnoty

Klíčové slovo default nemá žádný efekt. Pokud je pole ve schématu přítomno, model ho vždy vyplní.

Žádné podmínky

Klíčová slova JSON Schema if, then a else nejsou k dispozici.

Strategie: schéma + prompt

Nejlepší přístup kombinuje obojí:

  1. Schéma garantuje strukturu: názvy polí, typy, vnoření
  2. Prompt řídí obsah: délky, specifické formáty, obchodní pravidla
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 strukturu. Prompt kontroluje hodnoty a omezení obsahu.

Klíčové poznatky

  • allOf, minLength, maxLength, minItems a maxItems nejsou podporovány
  • Omezení pattern, default a if/then/else rovněž nejsou podporována
  • Kdykoli je to možné, použij místo allOf konstrukci anyOf
  • Přenes omezení obsahu do promptu
  • Kombinace schématu (struktura) a promptu (obsah) je optimální strategií