Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Ikke-understøttede typer og begrænsninger

Lektion 3 af 12 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Hvad skemaer ikke kan gøre
  2. De tre store begrænsninger
  3. Andre begrænsninger, du bør kende
  4. Strategien: skema + prompt
  5. Vigtige pointer

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:

  1. Skemaet garanterer strukturen: feltnavne, typer, nesting
  2. 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, minItems og maxItems er ikke understøttet
  • pattern, default og if/then/else-begrænsninger er heller ikke understøttet
  • Brug anyOf i stedet for allOf, når det er muligt
  • Flyt indholdsbegrænsninger over til prompten
  • Kombinationen af skema (struktur) + prompt (indhold) er den optimale strategi