Nepodporované typy a obmedzenia
Na tejto strane
Č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:
- Schéma garantuje štruktúru: názvy polí, typy, vnorenie
- 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,minItemsamaxItemsnie sú podporované- Obmedzenia
pattern,defaultaif/then/elsetiež nie sú podporované - Keď je to možné, použite
anyOfnamiestoallOf - Presuňte obmedzenia obsahu do propu
- Kombinácia schémy (štruktúra) + prop (obsah) je optimálna stratégia