Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Typer som inte stöds och begränsningar

Lektion 3 av 12 Uppdaterad 30 juli 2026 Utvecklare
På denna sida
  1. Vad scheman inte kan göra
  2. De tre huvudsakliga begränsningarna
  3. Andra begränsningar att känna till
  4. Strategin: schema + prompt
  5. Viktiga punkter

Vad scheman inte kan göra

Att förstå begränsningarna för strukturerade utdata är lika viktigt som att bemästra deras möjligheter. Grok API:t stöder inte vissa JSON Schema-begränsningar. Försöker du använda dem kommer det att utlösa ett fel eller orsaka oväntat beteende.

De tre huvudsakliga begränsningarna

allOf — sammansättning tillåts inte

I JSON Schema kombinerar nyckelordet allOf flera delscheman som ett objekt måste uppfylla samtidigt. Grok API:t stöder inte denna funktion.

// DOES NOT WORK
{
  "allOf": [
    { "properties": { "nom": { "type": "string" } } },
    { "properties": { "age": { "type": "number" } } }
  ]
}

Alternativ: använd ett enda objekt med alla egenskaper:

// WORKS
{
  "type": "object",
  "properties": {
    "nom": { "type": "string" },
    "age": { "type": "number" }
  }
}

minLength / maxLength — inga begränsningar för stränglängd

Du kan inte tvinga modellen att producera en sträng med en minsta eller maximal längd.

// DOES NOT WORK
{
  "properties": {
    "code": {
      "type": "string",
      "minLength": 3,
      "maxLength": 10
    }
  }
}

Alternativ: ange begränsningen i prompten istället för i schemat:

messages=[{
    "role": "user",
    "content": "Generate a product code between 3 and 10 characters."
}]

Modellen följer instruktionen i de flesta fall, men det är inte garanterat på samma sätt som en schemabegränsning skulle vara.

minItems / maxItems — inga begränsningar för arraystorlek

Du kan inte erzwinga ett minimum eller maximum antal element i en array.

// DOES NOT WORK
{
  "properties": {
    "tags": {
      "type": "array",
      "items": { "type": "string" },
      "minItems": 1,
      "maxItems": 5
    }
  }
}

Alternativ: använd prompten för att vägleda modellen:

messages=[{
    "role": "user",
    "content": "List between 1 and 5 relevant tags for this article."
}]

Andra begränsningar att känna till

Inga regex-mönster

API:t stöder inte pattern-begränsningar på strängar. Du kan inte erzwinga ett e-postformat, UUID eller telefonnummer via schemat.

// DOES NOT WORK
{
  "properties": {
    "email": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
    }
  }
}

Inga standardvärden

Nyckelordet default har ingen effekt. Om ett fält finns i schemat kommer modellen alltid att fylla i det.

Inga villkor

JSON Schema-nyckelorden if, then och else är inte tillgängliga.

Strategin: schema + prompt

Det bästa tillvägagångssättet kombinerar båda:

  1. Schemat garanterar strukturen: fältnamn, typer, nästling
  2. Prompten styr innehållet: längder, specifika format, affärsregler
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."""
}]

Schemat garanterar typer och struktur. Prompten styr värden och innehållsbegränsningar.

Viktiga punkter

  • allOf, minLength, maxLength, minItems och maxItems stöds inte
  • Begränsningarna pattern, default och if/then/else stöds inte heller
  • Använd anyOf istället för allOf när det är möjligt
  • Flytta över innehållsbegränsningar till prompten
  • Att kombinera schema (struktur) + prompt (innehåll) är den optimala strategin