Nepodprti tipi in omejitve
Na tej strani
Kaj sheme ne zmorejo
Razumevanje omejitev strukturiranih izhodov je enako pomembno kot obvladovanje njihovih zmožnosti. API Grok ne podpira določenih omejitev JSON Schema. Če jih poskušaš uporabiti, se bo sprožila napaka ali pa bo prišlo do nepričakovanega obnašanja.
Tri glavne omejitve
allOf — sestavljanje ni dovoljeno
V JSON Schema ključna beseda allOf združi več podshem, ki jih mora objekt izpolnjevati hkrati. API Grok te funkcije ne podpira.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Alternativa: uporabi en sam objekt z vsemi lastnostmi:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength — brez omejitev dolžine niza
Modela ne moreš prisiliti, da ustvari niz z najmanjšo ali največjo dolžino.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Alternativa: omejitev določi v pozivu namesto v shemi:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Model bo navodilo v večini primerov upošteval, vendar to ni zagotovljeno tako kot pri omejitvi sheme.
minItems / maxItems — brez omejitev velikosti polja
Ne moreš vsiliti najmanjšega ali največjega števila elementov v polju.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Alternativa: za usmerjanje modela uporabi poziv:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Druge omejitve, ki jih moraš poznati
Brez vzorcev regularnih izrazov
API ne podpira omejitev pattern za nize. Prek sheme ne moreš vsiliti formata e-pošte, UUID ali telefonske številke.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Brez privzetih vrednosti
Ključna beseda default nima učinka. Če je polje v shemi, ga bo model vedno izpolnil.
Brez pogojnih stavkov
Ključne besede JSON Schema if, then in else niso na voljo.
Strategija: shema + poziv
Najboljši pristop združuje oboje:
- Shema zagotavlja strukturo: imena polj, tipe, gnezdenje
- Poziv usmerja vsebino: dolžine, specifične formate, poslovna pravila
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."""
}]
Shema zagotavlja tipe in strukturo. Poziv nadzira vrednosti in omejitve vsebine.
Ključne ugotovitve
allOf,minLength,maxLength,minItemsinmaxItemsniso podprti- Omejitve
pattern,defaultinif/then/elseprav tako niso podprte - Kadar je mogoče, uporabi
anyOfnamestoallOf - Omejitve vsebine prenesi na poziv
- Kombinacija sheme (struktura) in poziva (vsebina) je optimalna strategija