Niet-ondersteunde typen en beperkingen
Op deze pagina
Wat schema’s niet kunnen
Inzicht in de beperkingen van gestructureerde uitvoer is net zo belangrijk als het beheersen van de mogelijkheden. De Grok API ondersteunt bepaalde JSON Schema-beperkingen niet. Het gebruik ervan leidt tot een fout of onverwacht gedrag.
De drie belangrijkste beperkingen
allOf — compositie niet toegestaan
In JSON Schema combineert het trefwoord allOf meerdere subschema’s waaraan een object gelijktijdig moet voldoen. De Grok API ondersteunt deze functie niet.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Alternatief: gebruik één object met alle eigenschappen:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength — geen beperkingen voor stringlengte
U kunt het model niet dwingen een string met een minimale of maximale lengte te produceren.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Alternatief: specificeer de beperking in de prompt in plaats van in het schema:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Het model volgt de instructie in de meeste gevallen, maar dit is niet gegarandeerd zoals bij een schemabeperking.
minItems / maxItems — geen beperkingen voor arraygrootte
U kunt een minimum- of maximumaantal elementen in een array niet afdwingen.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Alternatief: gebruik de prompt om het model te sturen:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Andere beperkingen om rekening mee te houden
Geen regex-patronen
De API ondersteunt geen pattern-beperkingen op strings. U kunt via het schema geen e-mailindeling, UUID of telefoonnummer afdwingen.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Geen standaardwaarden
Het trefwoord default heeft geen effect. Als een veld in het schema staat, vult het model dit altijd in.
Geen conditionele logica
De JSON Schema-trefwoorden if, then en else zijn niet beschikbaar.
De strategie: schema + prompt
De beste aanpak combineert beide:
- Het schema garandeert de structuur: veldnamen, typen, nesting
- De prompt stuurt de inhoud: lengtes, specifieke indelingen, bedrijfsregels
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."""
}]
Het schema garandeert typen en structuur. De prompt regelt waarden en inhoudsbeperkingen.
Belangrijkste punten
allOf,minLength,maxLength,minItemsenmaxItemsworden niet ondersteund- Beperkingen zoals
pattern,defaultenif/then/elseworden evenmin ondersteund - Gebruik waar mogelijk
anyOfin plaats vanallOf - Leg inhoudsbeperkingen bij de prompt neer
- Het combineren van schema (structuur) en prompt (inhoud) is de optimale strategie