Nem támogatott típusok és korlátozások
Ezen az oldalon
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:
- A séma garantálja a szerkezetet: mezőnevek, típusok, beágyazás
- 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ésmaxItemsnem támogatott - A
pattern,defaultés azif/then/elsemegszorítások szintén nem támogatottak - Használj
anyOf-ot azallOfhelyett, 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