Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Nepalaikomi tipai ir apribojimai

Paskaita 3 iš 12 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Ko schemos negali padaryti
  2. Trys pagrindiniai apribojimai
  3. Kiti apribojimai, kuriuos verta žinoti
  4. Strategija: schema + užklausa
  5. Svarbiausi punktai

Ko schemos negali padaryti

Suprasti struktūrizuotų išvesčių ribotumą yra taip pat svarbu, kaip ir įvaldyti jų galimybes. Grok API nepalaiko tam tikrų JSON Schema apribojimų. Bandymas juos naudoti sukels klaidą arba netikėtą elgseną.

Trys pagrindiniai apribojimai

allOf — kompozicija neleidžiama

JSON Schema raktažodis allOf sujungia kelias poschemes, kurias objektas turi atitikti vienu metu. Grok API nepalaiko šios funkcijos.

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

Alternatyva: naudokite vieną objektą su visomis savybėmis:

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

minLength / maxLength – jokių eilučių ilgio apribojimų

Negalite priversti modelio sugeneruoti eilutės, kurios ilgis būtų minimalus arba maksimalus.

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

Alternatyva: nurodykite apribojimą užklausoje (prompt), o ne schemoje:

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

Modelis daugeliu atvejų laikysis instrukcijos, tačiau tai nėra taip garantuota, kaip būtų naudojant schemos apribojimą.

minItems / maxItems – jokių masyvo dydžio apribojimų

Negalite užtikrinti minimalaus arba maksimalaus elementų skaičiaus masyve.

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

Alternatyva: naudokite užklausą modelio nukreipimui:

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

Kiti apribojimai, kuriuos verta žinoti

Nėra reguliariųjų išraiškų (regex) šablonų

API nepalaiko pattern apribojimų eilutėms. Negalite priverstinai nustatyti el. pašto formato, UUID arba telefono numerio per schemą.

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

Nėra numatytųjų reikšmių

Raktažodis default neturi jokio poveikio. Jei laukas yra schemoje, modelis jį visada užpildys.

Nėra sąlyginių operatorių

JSON Schema raktažodžiai if, then ir else nėra prieinami.

Strategija: schema + užklausa

Geriausias būdas – derinti abu:

  1. Schema garantuoja struktūrą: laukų pavadinimus, tipus, įdėtumą.
  2. Užklausa nukreipia turinį: ilgius, specifinius formatus, verslo taisykles.
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."""
}]

Schema garantuoja tipus ir struktūrą. Užklausa kontroliuoja reikšmes ir turinio apribojimus.

Svarbiausi punktai

  • allOf, minLength, maxLength, minItems ir maxItems nepalaikomi
  • pattern, default ir if/then/else apribojimai taip pat nepalaikomi
  • Kai įmanoma, vietoj allOf naudokite anyOf
  • Turinio apribojimus perkelkite į užklausą
  • Schemos (struktūra) ir užklausos (turinys) derinimas yra optimali strategija