Nepodporované typy a omezení
Na této stránce
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í:
- Schéma garantuje strukturu: názvy polí, typy, vnoření
- 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,minItemsamaxItemsnejsou podporovány- Omezení
pattern,defaultaif/then/elserovněž nejsou podporována - Kdykoli je to možné, použij místo
allOfkonstrukcianyOf - Přenes omezení obsahu do promptu
- Kombinace schématu (struktura) a promptu (obsah) je optimální strategií