Typer som inte stöds och begränsningar
På denna sida
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:
- Schemat garanterar strukturen: fältnamn, typer, nästling
- 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,minItemsochmaxItemsstöds inte- Begränsningarna
pattern,defaultochif/then/elsestöds inte heller - Använd
anyOfistället förallOfnär det är möjligt - Flytta över innehållsbegränsningar till prompten
- Att kombinera schema (struktur) + prompt (innehåll) är den optimala strategin