Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Nem támogatott típusok és korlátozások

3. lecke 12 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Mit nem tudnak a sémák
  2. A három fő korlátozás
  3. Egyéb ismert korlátozások
  4. A stratégia: séma + prompt
  5. Főbb megállapítások

Mit nem tudnak a sémák

A strukturált kimenetek korlátainak megértése éppoly fontos, mint a lehetőségeik elsajátítása. A Grok API nem támogat bizonyos JSON Schema megszorításokat. Ha mégis megpróbálod használni őket, az hibát okoz, vagy váratlan viselkedéshez vezet.

A három fő korlátozás

allOf — az összetétel nem engedélyezett

A JSON Schema-ban az allOf kulcsszó több al-sémát kombinál, amelyeknek az objektumnak egyszerre meg kell felelnie. A Grok API nem támogatja ezt a funkciót.

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

Alternatíva: használj egyetlen objektumot az összes tulajdonsággal:

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

minLength / maxLength — nincs karakterszám-korlátozás

Nem kényszerítheted a modellt arra, hogy egy minimális vagy maximális hosszúságú sztringet hozzon létre.

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

Alternatíva: add meg a megszorítást a promptban a séma helyett:

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

A modell a legtöbb esetben követni fogja az utasítást, de ez nem garantált úgy, mint egy séma-megszorítás esetén.

minItems / maxItems — nincs tömbméret-korlátozás

Nem érvényesíthetsz minimális vagy maximális elemszámot egy tömbben.

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

Alternatíva: használd a promptot a modell irányítására:

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

Egyéb ismert korlátozások

Nincsenek regex minták

Az API nem támogatja a pattern megszorításokat sztringeken. Nem kényszeríthetsz ki e-mail formátumot, UUID-t vagy telefonszámot a sémán keresztül.

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

Nincsenek alapértelmezett értékek

A default kulcsszónak nincs hatása. Ha egy mező szerepel a sémában, a modell mindig kitölti azt.

Nincsenek feltételek

A JSON Schema if, then és else kulcsszavai nem elérhetők.

A stratégia: séma + prompt

A legjobb megközelítés a kettő kombinálása:

  1. A séma garantálja a szerkezetet: mezőnevek, típusok, beágyazás
  2. A prompt irányítja a tartalmat: hosszúságok, specifikus formátumok, üzleti szabályok
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."""
}]

A séma garantálja a típusokat és a szerkezetet. A prompt vezérli az értékeket és a tartalmi korlátozásokat.

Főbb megállapítások

  • Az allOf, minLength, maxLength, minItems és maxItems nem támogatott
  • A pattern, default és az if/then/else megszorítások szintén nem támogatottak
  • Használj anyOf-ot az allOf helyett, amikor lehetséges
  • Helyezd át a tartalmi korlátozásokat a promptba
  • A séma (szerkezet) és a prompt (tartalom) kombinálása az optimális stratégia