Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Niet-ondersteunde typen en beperkingen

Les 3 van 12 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Wat schema’s niet kunnen
  2. De drie belangrijkste beperkingen
  3. Andere beperkingen om rekening mee te houden
  4. De strategie: schema + prompt
  5. Belangrijkste punten

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:

  1. Het schema garandeert de structuur: veldnamen, typen, nesting
  2. 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, minItems en maxItems worden niet ondersteund
  • Beperkingen zoals pattern, default en if/then/else worden evenmin ondersteund
  • Gebruik waar mogelijk anyOf in plaats van allOf
  • Leg inhoudsbeperkingen bij de prompt neer
  • Het combineren van schema (structuur) en prompt (inhoud) is de optimale strategie