Nepodržani tipovi i ograničenja
Na ovoj stranici
Što sheme ne mogu učiniti
Razumijevanje ograničenja strukturiranih izlaza jednako je važno kao i savladavanje njihovih mogućnosti. Grok API ne podržava određena ograničenja JSON Sheme. Pokušaj njihova korištenja izazvat će pogrešku ili uzrokovati neočekivano ponašanje.
Tri glavna ograničenja
allOf — sastavljanje nije dopušteno
U JSON Shemi, ključna riječ allOf kombinira više podshema kojima objekt mora istovremeno zadovoljiti. Grok API ne podržava ovu značajku.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Alternativa: upotrijebi jedan objekt sa svim svojstvima:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength — nema ograničenja duljine niza
Ne možeš prisiliti model da proizvede niz znakova s minimalnom ili maksimalnom duljinom.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Alternativa: navedi ograničenje u promptu umjesto u shemi:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Model će u većini slučajeva slijediti uputu, ali to nije zajamčeno kao što bi bilo kod ograničenja sheme.
minItems / maxItems — nema ograničenja veličine polja
Ne možeš nametnuti minimalan ili maksimalan broj elemenata u polju.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Alternativa: upotrijebi prompt za vođenje modela:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Ostala ograničenja koja trebaš znati
Nema regex uzoraka
API ne podržava ograničenja pattern na nizovima znakova. Ne možeš nametnuti format e-pošte, UUID ili telefonski broj putem sheme.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Nema zadanih vrijednosti
Ključna riječ default nema učinka. Ako je polje u shemi, model će ga uvijek popuniti.
Nema uvjetnih izraza
Ključne riječi JSON Sheme if, then i else nisu dostupne.
Strategija: shema + prompt
Najbolji pristup kombinira oboje:
- Shema jamči strukturu: nazive polja, tipove, ugnježđivanje
- Prompt usmjerava sadržaj: duljine, 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 jamči tipove i strukturu. Prompt kontrolira vrijednosti i ograničenja sadržaja.
Ključne točke
allOf,minLength,maxLength,minItemsimaxItemsnisu podržani- Ograničenja
pattern,defaultiif/then/elsetakođer nisu podržana - Kada je moguće, upotrijebi
anyOfumjestoallOf - Prebaci ograničenja sadržaja na prompt
- Kombiniranje sheme (struktura) + prompta (sadržaj) optimalna je strategija