Nepieļaujamie tipi un ierobežojumi
Šajā lapā
Ko shēmas nespēj izdarīt
Strukturēto izvades datu iespēju robežu izpratne ir tikpat svarīga kā to spēju apgūšana. Grok API neatbalsta noteiktus JSON shēmas ierobežojumus. To mēģinājums izraisīs kļūdu vai neparedzētu uzvedību.
Trīs galvenie ierobežojumi
allOf — kompozīcija nav atļauta
JSON shēmā atslēgvārds allOf apvieno vairākas apakšshēmas, kurām objektam jāatbilst vienlaicīgi. Grok API neatbalsta šo funkciju.
// DOES NOT WORK
{
"allOf": [
{ "properties": { "nom": { "type": "string" } } },
{ "properties": { "age": { "type": "number" } } }
]
}
Alternatīva: izmanto vienu objektu ar visām īpašībām:
// WORKS
{
"type": "object",
"properties": {
"nom": { "type": "string" },
"age": { "type": "number" }
}
}
minLength / maxLength — nav virknes garuma ierobežojumu
Tu nevari piespiest modeli ģenerēt virkni ar minimālo vai maksimālo garumu.
// DOES NOT WORK
{
"properties": {
"code": {
"type": "string",
"minLength": 3,
"maxLength": 10
}
}
}
Alternatīva: norādi ierobežojumu uzvednē (prompt), nevis shēmā:
messages=[{
"role": "user",
"content": "Generate a product code between 3 and 10 characters."
}]
Modelis vairumā gadījumu ievēros instrukciju, taču tas nav tik garantēts kā shēmas ierobežojums.
minItems / maxItems — nav masīva lieluma ierobežojumu
Tu nevari noteikt minimālo vai maksimālo elementu skaitu masīvā.
// DOES NOT WORK
{
"properties": {
"tags": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"maxItems": 5
}
}
}
Alternatīva: izmanto uzvedni, lai vadītu modeli:
messages=[{
"role": "user",
"content": "List between 1 and 5 relevant tags for this article."
}]
Citi zināmie ierobežojumi
Nav regulāro izteiksmju (regex) rakstu
API neatbalsta pattern ierobežojumus virknēm. Tu nevari piespiest e-pasta formātu, UUID vai tālruņa numuru, izmantojot shēmu.
// DOES NOT WORK
{
"properties": {
"email": {
"type": "string",
"pattern": "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
}
}
}
Nav noklusējuma vērtību
Atslēgvārdam default nav nekādas ietekmes. Ja lauks ir shēmā, models to vienmēr aizpildīs.
Nav nosacījumu
JSON shēmas atslēgvārdi if, then un else nav pieejami.
Stratēģija: shēma + uzvedne
Labākā pieeja apvieno abus:
- Shēma garantē struktūru: lauku nosaukumus, tipus, ligzdošanu.
- Uzvedne vada saturs: garumus, specifiskus formātus, biznesa noteikumus.
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."""
}]
Shēma garantē tipus un struktūru. Uzvedne kontrolē vērtības un satura ierobežojumus.
Galvenās atziņas
allOf,minLength,maxLength,minItemsunmaxItemsnetiek atbalstīti- Arī
pattern,defaultunif/then/elseierobežojumi netiek atbalstīti - Izmanto
anyOfallOfvietā, kad tas ir iespējams - Satura ierobežojumus nodod uzvednei
- Shēmas (struktūra) un uzvednes (saturs) kombinēšana ir optimālā stratēģija