Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Nepieļaujamie tipi un ierobežojumi

Nodarbība 3 no 12 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Ko shēmas nespēj izdarīt
  2. Trīs galvenie ierobežojumi
  3. Citi zināmie ierobežojumi
  4. Stratēģija: shēma + uzvedne
  5. Galvenās atziņas

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

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.-]+$"
    }
  }
}

Atslēgvārdam default nav nekādas ietekmes. Ja lauks ir shēmā, models to vienmēr aizpildīs.

JSON shēmas atslēgvārdi if, then un else nav pieejami.

Stratēģija: shēma + uzvedne

Labākā pieeja apvieno abus:

  1. Shēma garantē struktūru: lauku nosaukumus, tipus, ligzdošanu.
  2. 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, minItems un maxItems netiek atbalstīti
  • Arī pattern, default un if/then/else ierobežojumi netiek atbalstīti
  • Izmanto anyOf allOf vietā, kad tas ir iespējams
  • Satura ierobežojumus nodod uzvednei
  • Shēmas (struktūra) un uzvednes (saturs) kombinēšana ir optimālā stratēģija