Salt la conținutul principal
Română— Alege o limbă
Meniu

Tipuri neacceptate și limitări

Lecția 3 din 12 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Ce nu pot face schemele
  2. Cele trei restricții majore
  3. Alte limitări de cunoscut
  4. Strategia: schemă + prompt
  5. Puncte cheie

Ce nu pot face schemele

Înțelegerea limitărilor ieșirilor structurate este la fel de importantă ca și stăpânirea capacităților acestora. API-ul Grok nu acceptă anumite constrângeri JSON Schema. Încercarea de a le utiliza va declanșa o eroare sau va provoca un comportament neașteptat.

Cele trei restricții majore

allOf — compunerea nu este permisă

În JSON Schema, cuvântul cheie allOf combină mai multe subscheme pe care un obiect trebuie să le respecte simultan. API-ul Grok nu acceptă această funcționalitate.

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

Alternativă: utilizați un singur obiect cu toate proprietățile:

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

minLength / maxLength — fără constrângeri de lungime pentru șiruri

Nu puteți forța modelul să producă un șir cu o lungime minimă sau maximă.

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

Alternativă: specificați constrângerea în prompt în loc de schemă:

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

Modelul va urma instrucțiunea în majoritatea cazurilor, dar acest lucru nu este garantat așa cum ar fi o constrângere de schemă.

minItems / maxItems — fără constrângeri de dimensiune pentru tablouri

Nu puteți impune un număr minim sau maxim de elemente într-un tablou.

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

Alternativă: utilizați promptul pentru a ghida modelul:

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

Alte limitări de cunoscut

Fără modele regex

API-ul nu acceptă constrângerile pattern asupra șirurilor de caractere. Nu puteți impune un format de e-mail, UUID sau număr de telefon prin intermediul schemei.

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

Fără valori implicite

Cuvântul cheie default nu are niciun efect. Dacă un câmp se află în schemă, modelul îl va popula întotdeauna.

Fără condiționale

Cuvintele cheie JSON Schema if, then și else nu sunt disponibile.

Strategia: schemă + prompt

Cea mai bună abordare le combină pe ambele:

  1. Schema garantează structura: numele câmpurilor, tipurile, imbricarea
  2. Promptul ghidează conținutul: lungimi, formate specifice, reguli de afaceri
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 garantează tipurile și structura. Promptul controlează valorile și constrângerile de conținut.

Puncte cheie

  • allOf, minLength, maxLength, minItems și maxItems nu sunt acceptate
  • Constrângerile pattern, default și if/then/else nu sunt nici ele acceptate
  • Utilizați anyOf în loc de allOf atunci când este posibil
  • Delegați constrângerile de conținut către prompt
  • Combinarea schemei (structură) + prompt (conținut) reprezintă strategia optimă