Ikke-understøttede typer og begrænsninger
På denne side
Hvad skemaer ikke kan gøre
Det er lige så vigtigt at forstå begrænsningerne ved strukturerede outputs som at mestre deres muligheder. Grok API’en understøtter ikke visse JSON Schema-begrænsninger. Hvis du forsøger at bruge dem, vil det udløse en fejl eller forårsage uventet adfærd.
De tre store begrænsninger
allOf — sammensætning er ikke tilladt
I JSON Schema kombinerer nøgleordet allOf flere underskemaer, som et objekt skal overholde samtidigt. Grok API’en understøtter ikke denne funktion.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Alternativ: brug et enkelt objekt med alle egenskaber:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength — ingen begrænsninger for strenglængde
Du kan ikke tvinge modellen til at producere en streng med en minimums- eller maksimumslængde.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Alternativ: angiv begrænsningen i prompten i stedet for i skemaet:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Modellen vil følge instruktionen i de fleste tilfælde, men det er ikke garanteret på samme måde som en skemabegrænsning ville være.
minItems / maxItems — ingen begrænsninger for array-størrelse
Du kan ikke håndhæve et minimums- eller maksimumsantal elementer i et array.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Alternativ: brug prompten til at vejlede modellen:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Andre begrænsninger, du bør kende
Ingen regex-mønstre
API’en understøtter ikke pattern-begrænsninger på strenge. Du kan ikke håndhæve et e-mail-format, UUID eller telefonnummer via skemaet.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Ingen standardværdier
Nøgleordet default har ingen effekt. Hvis et felt findes i skemaet, vil modellen altid udfylde det.
Ingen betingelser
JSON Schema-nøgleordene if, then og else er ikke tilgængelige.
Strategien: skema + prompt
Den bedste tilgang kombinerer begge dele:
- Skemaet garanterer strukturen: feltnavne, typer, nesting
- Prompten styrer indholdet: længder, specifikke formater, forretningsregler
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."""
}]
Skemaet garanterer typer og struktur. Prompten styrer værdier og indholdsbegrænsninger.
Vigtige pointer
allOf,minLength,maxLength,minItemsogmaxItemser ikke understøttetpattern,defaultogif/then/else-begrænsninger er heller ikke understøttet- Brug
anyOfi stedet forallOf, når det er muligt - Flyt indholdsbegrænsninger over til prompten
- Kombinationen af skema (struktur) + prompt (indhold) er den optimale strategi